amphp/http-client-cookies

Amp HTTP 客户端的自动 Cookie 处理。

v2.0.0 2023-10-08 17:29 UTC

This package is auto-updated.

Last update: 2024-09-08 19:20:27 UTC


README

AMPHP 是一套为 PHP 设计的事件驱动库集合,它考虑了纤程和并发。此包提供自动 Cookie 处理,作为 amphp/http-client 的插件。

安装

此包可以作为 Composer 依赖项安装。

composer require amphp/http-client-cookies

用法

Amp\Http\Client\Cookie\CookieInterceptor 必须注册为 NetworkInterceptor 以启用自动 Cookie 处理。它需要一个 CookieJar 实现,您可以选择 LocalCookieJarFileCookieJarNullCookieJar

<?php

use Amp\Http\Client\Cookie\CookieInterceptor;
use Amp\Http\Client\Cookie\LocalCookieJar;
use Amp\Http\Client\HttpClientBuilder;
use Amp\Http\Client\Request;
use Amp\Http\Client\Response;

require __DIR__ . '/vendor/autoload.php';

$cookieJar = new LocalCookieJar;

$httpClient = (new HttpClientBuilder)
    ->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 目录。

版本控制

amphp/http-client-cookies 遵循与其他所有 amphp 包一样的 semver 语义化版本规范。

安全性

如果您发现任何与安全相关的问题,请通过电子邮件 me@kelunik.com 联系,而不是使用问题跟踪器。

许可证

MIT 许可证 (MIT)。更多信息请参见 LICENSE