xiaoyi510/guzzle

Guzzle is a PHP HTTP client library

7.2.0 2020-10-10 11:47 UTC

Requires

• php: ^7.2.5 || ^8.0
• ext-json: *
• guzzlehttp/promises: ^1.4
• guzzlehttp/psr7: ^1.7
• psr/http-client: ^1.0

Requires (Dev)

• ext-curl: *
• php-http/client-integration-tests: ^3.0
• phpunit/phpunit: ^8.5.5 || ^9.3.5
• psr/log: ^1.1

Suggests

• ext-curl: Required for CURL handler support
• ext-intl: Required for Internationalized Domain Name (IDN) support
• psr/log: Required for using the Log middleware

Provides

• psr/http-client-implementation: 1.0

MIT

• Michael Dowling
• Márk Sági-Kazár

• framework
• curl
• http
• rest
• http client
• client
• web service
• psr-7
• psr-18

README

Guzzle, PHP HTTP client

Guzzle is a PHP HTTP client that makes it easy to send HTTP requests and trivial to integrate with web services.

• Simple interface for building query strings, POST requests, streaming large uploads, streaming large downloads, using HTTP cookies, uploading JSON data, etc...
• Can send both synchronous and asynchronous requests using the same interface.
• Uses PSR-7 interfaces for requests, responses, and streams. This allows you to utilize other PSR-7 compatible libraries with Guzzle.
• Supports PSR-18 allowing interoperability between other PSR-18 HTTP Clients.
• Abstracts away the underlying HTTP transport, allowing you to write environment and transport agnostic code; i.e., no hard dependency on cURL, PHP streams, sockets, or non-blocking event loops.
• Middleware system allows you to augment and compose client behavior.

$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.github.com/repos/guzzle/guzzle');

echo $response->getStatusCode(); // 200
echo $response->getHeaderLine('content-type'); // 'application/json; charset=utf8'
echo $response->getBody(); // '{"id": 1420053, "name": "guzzle", ...}'

// Send an asynchronous request.
$request = new \GuzzleHttp\Psr7\Request('GET', 'http://httpbin.org');
$promise = $client->sendAsync($request)->then(function ($response) {
    echo 'I completed! ' . $response->getBody();
});

$promise->wait();

Help and docs

We use GitHub issues only to discuss bugs and new features. For support please refer to:

• Documentation
• Stack Overflow
• #guzzle channel on PHP-HTTP Slack
• Gitter

Installing Guzzle

The recommended way to install Guzzle is through Composer.

composer require guzzlehttp/guzzle

Version Guidance

Version	Status	Packagist	Namespace	Repo	Docs	PSR-7	PHP Version
3.x	EOL	guzzle/guzzle	Guzzle	v3	v3	No	>= 5.3.3
4.x	EOL	guzzlehttp/guzzle	GuzzleHttp	v4	N/A	No	>= 5.4
5.x	EOL	guzzlehttp/guzzle	GuzzleHttp	v5	v5	No	>= 5.4
6.x	Security fixes	guzzlehttp/guzzle	GuzzleHttp	v6	v6	Yes	>= 5.5
7.x	Latest	guzzlehttp/guzzle	GuzzleHttp	v7	v7	Yes	>= 7.2