Laravel HTTP Query Polyfill

Backward-compatible polyfill for Http::query() introduced in Laravel 13.19.0 (RFC 10008).

On Laravel < 13.19, this package registers PendingRequest::query() so you can send HTTP QUERY requests with a body. On Laravel 13.19+, registration is skipped and the native method is used unchanged.

Installation

composer require mohamedahmed01/laravel-http-query-polyfill

The service provider is auto-discovered. No further setup is required.

Usage

Same API as Laravel 13.19+:

use Illuminate\Support\Facades\Http;

$response = Http::query('https://api.example.com/search', [
    'filter' => ['status' => 'active'],
]);

JSON is the default body format. Use existing fluent helpers for other formats:

Http::asForm()->query('https://api.example.com/search', [
    'filter' => 'active',
]);

URL query strings are unchanged — keep using withQueryParameters() or Http::get($url, $query) for those.

Testing helpers (Laravel < 13.19)

Laravel 13.19 also added $this->query() / $this->queryJson() on HTTP tests. Those live on a trait, so they cannot be auto-registered. On older Laravel, add the polyfill trait to your base test case:

use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
use MohamedAhmed01\HttpQueryPolyfill\Testing\MakesHttpQueryRequests;

abstract class TestCase extends BaseTestCase
{
    use MakesHttpQueryRequests;
}

Then:

$this->queryJson('/search', ['filter' => 'active'])->assertOk();

Do not use this trait on Laravel 13.19+ — the methods already exist and will collide.

Compatibility

License

MIT