sunrise/http-client-curl

Simple HTTP cURL client for PHP 7.1+ based on PSR-18

v1.4.6 2022-04-19 19:08 UTC

Requires

• php: ^7.1|^8.0
• ext-curl: *
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^1.0

Requires (Dev)

• phpunit/phpunit: 7.5.20|9.5.0
• sunrise/coding-standard: 1.0.0
• sunrise/http-factory: 2.0.0

Provides

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

MIT

• Anatoly Fenric
• 李昀陞 (Peter)

• curl
• http
• client
• PSR-2
• sunrise
• psr-7
• php-7
• psr-17
• fenric
• psr-18
• php-8

README

Installation

composer require sunrise/http-client-curl

QuickStart

composer require sunrise/http-factory

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

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

echo $response->getStatusCode(), PHP_EOL;

cURL options

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

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

Parallel execution of multiple requests

$requests = [
    (new RequestFactory)->createRequest('GET', 'http://php.net/'),
    (new RequestFactory)->createRequest('GET', 'http://php.net/'),
];

$client = new Client(new ResponseFactory());
$responses = $client->sendRequests(...$request);

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

Test run

composer test

Useful links

• http://php.net/manual/en/intro.curl.php
• https://curl.haxx.se/libcurl/c/libcurl-errors.html
• https://www.php-fig.org/psr/psr-2/
• https://www.php-fig.org/psr/psr-7/
• https://www.php-fig.org/psr/psr-17/
• https://www.php-fig.org/psr/psr-18/