sunrise/http-client-curl

Simple HTTP cURL client for PHP 8.1+ implementing PSR-18.

v2.0.0 2025-02-15 23:43 UTC

Requires

• php: >=8.1
• ext-curl: *
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^1.0 || ^2.0

Requires (Dev)

• php-di/php-di: ^7.0
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.11
• sunrise/http-message: ^3.4
• vimeo/psalm: ^6.5

Provides

• php-http/client-implementation: 1.0
• psr/http-client-implementation: 1.0

MIT

• Anatoly Nekhay
• 李昀陞 (Peter)

• curl
• http
• client
• sunrise
• fenric
• psr-18

README

Installation

composer require sunrise/http-client-curl

Quick Start

composer require sunrise/http-message

use Sunrise\Http\Client\Curl\Client;
use Sunrise\Http\Message\RequestFactory;
use Sunrise\Http\Message\ResponseFactory;

$client = new Client(new ResponseFactory());
$request = (new RequestFactory())->createRequest('GET', 'https://www.php.net/');
$response = $client->sendRequest($request);

echo $response->getStatusCode(), PHP_EOL;

cURL options

https://www.php.net/manual/ru/curl.constants.php

use Sunrise\Http\Client\Curl\Client;
use Sunrise\Http\Message\ResponseFactory;

use const CURLOPT_AUTOREFERER;
use const CURLOPT_FOLLOWLOCATION;

$client = new Client(new ResponseFactory(), [
    CURLOPT_AUTOREFERER => true,
    CURLOPT_FOLLOWLOCATION => true,
]);

Parallel execution of multiple requests

use Sunrise\Http\Client\Curl\Client;
use Sunrise\Http\Client\Curl\MultiRequest;
use Sunrise\Http\Message\RequestFactory;
use Sunrise\Http\Message\ResponseFactory;

$client = new Client(new ResponseFactory());

$multiRequest = new MultiRequest(
    foo: (new RequestFactory())->createRequest('GET', 'https://www.php.net/'),
    bar: (new RequestFactory())->createRequest('GET', 'https://www.php.net/'),
)

$responses = $client->sendRequest($multiRequest)->getResponses();

foreach ($responses as $key => $response) {
    // Note that you can get the response's request by its key...
    echo sprintf('%s => %d', $multiRequest->getRequests()[$key]->getUri(), $response->getStatusCode()), PHP_EOL;
}

PHP-DI definitions

use DI\ContainerBuilder;
use Psr\Http\Client\ClientInterface;

$containerBuilder = new ContainerBuilder();
$containerBuilder->addDefinition(__DIR__ . '/../vendor/sunrise/http-client-curl/resources/definitions/client.php');

$container = $containerBuilder->build();

// See above for usage examples.
$client = $container->get(ClientInterface::class);

Tests

composer test