README

WordPress HTTP library.

Usage

$response = Http::request( $url, $args );

$data = $response->json();

Testing

Faking Responses

$url = 'https://www.pronamic.nl/wp-json/wp/v2/types/post';

Http::fake( $url, __DIR__ . '/../http/pronamic-nl-wp-json-types-post.http' );

$response = \wp_remote_get( $url );

// or

$response = Http::get( $url );

PHPUnit

<?php

namespace YourNamespace;

use Pronamic\WordPress\Http\Factory;

class YourTest extends \WP_UnitTestCase {
	/**
	 * Setup.
	 */
	public function setUp() {
		parent::setUp();

		$this->factory = new Factory();
	}

	/**
	 * Test request.
	 */
	public function test_request() {
		$this->factory->fake( 'http://example.com/', __DIR__ . '/../http/example-com.http' );

		$result = \wp_remote_get( 'http://example.com/' );

		// asserts
	}
}

CR LF

To store fake HTTP responses in *.http files and Git, keep the following in mind:

HTTP/1.1 defines the sequence CR LF as the end-of-line marker for all protocol elements

https://tools.ietf.org/html/rfc2616#section-2.2

.gitattributes

*.http text eol=crlf

You can use a tool like unix2dos to convert the line endings to CR LF:

unix2dos *.http

If the line endings are not correct this can result in the following error:

Undefined offset: 2

wordpress/wp-includes/class-http.php:732
src/Factory.php:97
wordpress/wp-includes/class-wp-hook.php:292
wordpress/wp-includes/plugin.php:212
wordpress/wp-includes/class-http.php:257
wordpress/wp-includes/class-http.php:626
wordpress/wp-includes/http.php:162
src/Facades/Http.php:71

Inspiration

• https://github.com/WordPress/WordPress/blob/5.7/wp-includes/class-http.php
• https://www.php-fig.org/psr/psr-7/
• https://github.com/guzzle/psr7
• https://github.com/jdgrimes/wp-http-testcase
• https://docs.guzzlephp.org/en/stable/testing.html
• https://github.com/guzzle/guzzle
• https://github.com/namshi/cuzzle
• https://docs.guzzlephp.org/en/stable/handlers-and-middleware.html
• https://laravel.com/docs/8.x/http-client#faking-responses
• https://www.php-fig.org/psr/psr-18/