https://github.com/amphp/http-client-cookies

Automatic cookie handling for Amp's HTTP client.
https://github.com/amphp/http-client-cookies

cookiejar cookies http http-client php

Last synced: 4 days ago
JSON representation

Automatic cookie handling for Amp's HTTP client.

• Host: GitHub
• URL: https://github.com/amphp/http-client-cookies
• Owner: amphp
• License: mit
• Created: 2019-06-10T13:49:54.000Z (over 5 years ago)
• Default Branch: 2.x
• Last Pushed: 2023-10-08T17:31:14.000Z (about 1 year ago)
• Last Synced: 2024-10-30T15:56:13.152Z (16 days ago)
• Topics: cookiejar, cookies, http, http-client, php
• Language: PHP
• Size: 206 KB
• Stars: 10
• Watchers: 8
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# amphp/http-client-cookies

AMPHP is a collection of event-driven libraries for PHP designed with fibers and concurrency in mind.

This package provides automatic cookie handling as a plugin for [`amphp/http-client`](https://github.com/amphp/http-client).

## Installation

This package can be installed as a [Composer](https://getcomposer.org/) dependency.

```bash

composer require amphp/http-client-cookies

```

## Usage

`Amp\Http\Client\Cookie\CookieInterceptor` must be registered as a `NetworkInterceptor` to enable automatic cookie handling.

It requires a `CookieJar` implementation, where you can choose between `LocalCookieJar`, `FileCookieJar`, and `NullCookieJar`.

```php

interceptNetwork(new CookieInterceptor($cookieJar))

    ->build();

$firstResponse = $httpClient->request(new Request('https://google.com/'));

$firstResponse->getBody()->buffer();

$secondResponse = $httpClient->request(new Request('https://google.com/'));

$secondResponse->getBody()->buffer();

$otherDomainResponse = $httpClient->request(new Request('https://amphp.org/'));

$otherDomainResponse->getBody()->buffer();

print "== first response stores cookies ==\r\n";

print \implode("\r\n", $firstResponse->getHeaderArray('set-cookie'));

print "\r\n\r\n";

print "== second request sends cookies again ==\r\n";

print \implode("\r\n", $secondResponse->getRequest()->getHeaderArray('cookie'));

print "\r\n\r\n";

print "== other domain request does not send cookies ==\r\n";

print \implode("\r\n", $otherDomainResponse->getRequest()->getHeaderArray('cookie'));

```

## Examples

More extensive code examples reside in the [`examples`](./examples) directory.

## Versioning

`amphp/http-client-cookies` follows the [semver](http://semver.org/) semantic versioning specification like all other `amphp` packages.

## Security

If you discover any security related issues, please email [`[email protected]`](mailto:[email protected]) instead of using the issue tracker.

## License

The MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information.