gehrisandro/laravel-http-psr18

A PSR-18 wrapper for Laravel HTTP client

v0.0.1 2024-01-25 14:57 UTC

Requires

• php: ^8.1.0
• illuminate/http: ^10.0.0
• psr/http-client: ^1.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.8
• laravel/pint: ^1.13.6
• orchestra/testbench: ^v8.0.8
• pestphp/pest: ^2.8.2
• pestphp/pest-plugin-type-coverage: ^2.8
• php-http/discovery: ^1.19
• phpstan/phpstan: ^1.10.25
• rector/rector: ^0.19

MIT

• Sandro Gehri

• http
• laravel
• http-client
• psr-18
• psr18

README

PSR-18 compatible HTTP Client for Laravel

This package provides a PSR-18 compatible wrapper for the Laravel HTTP Client.

This can be helpful if you want to use the Laravel HTTP Client in a package requiring a PSR-18 compatible HTTP Client.

If you find this package helpful, please consider sponsoring the maintainer:

• Sandro Gehri: github.com/sponsors/gehrisandro

Table of Contents

• Get Started
• Usage
• Contributing

Get Started

Requires Laravel 10 (or at lease the illuminate/http package)

First, install the package via the Composer package manager:

composer require gehrisandro/laravel-http-psr18

Then, use the HttpPsr18::make() method to create a new instance of the PSR-18 compatible HTTP Client.

Usage

If you call the make() method without any arguments, the default Laravel HTTP Client will be used:

use HttpPsr18\HttpPsr18;

$client = HttpPsr18::make();

// example usage with OpenAI for Laravel (https://github.com/openai-php/laravel)
$openAI = \OpenAI::factory()
    ->withApiKey('*******')
    ->withHttpClient($client)
    ->make();

$response = $openAI->chat()->create([/* ... */]);

You can provide a custom Laravel HTTP Client instance as the first argument:

use HttpPsr18\HttpPsr18;
use Illuminate\Support\Facades\Http;

$client = HttpPsr18::make(Http::timeout(300));

With this package you get a PSR-18 compatible HTTP Client and you can make use of all the Laravel HTTP Client features. 🥳

use GuzzleHttp\Psr7\Request;
use HttpPsr18\HttpPsr18;
use Illuminate\Support\Facades\Http;

Http::fake([
    '*' => Http::response('Hello World'),
]);

$client = HttpPsr18::make();

$response = $client->sendRequest(new Request('GET', 'https://example.com'));

$response->getBody()->getContents(); // Hello World

Contributing

Thank you for considering contributing to LaravelHttpPsr18! The contribution guide can be found in the CONTRIBUTING.md file.

LaravelHttpPsr18 is an open-sourced software licensed under the MIT license.