pinned-http-client — PSR-18 клиент для недоверенных URL, который привязывает соединение к проверенным адресам
$ composer require rasuvaeff/pinned-http-client
$client = new PinnedClient(); // public addresses only, IPv4 + IPv6, 8 s / 4 s, body <= 10 MiB, no proxy try { $response = (new RedirectFollower($client))->sendRequest(new Request('GET', $untrustedUrl));} catch (RequestRefused $refused) { $refused->reason; // Refusal::UnsupportedScheme | MissingHost | AddressNotAllowed} catch (ResponseTooLarge $tooLarge) { // the body (decompressed) passed maxBodyBytes; the transfer was cut} catch (ClientException $failed) { // TransferFailed (connection, TLS, timeout), ResolutionFailed (DNS) or TooManyRedirects}
PSR-18 клиент для недоверенных URL. Он резолвит хост один раз, проверяет каждый адрес и привязывает к ним cURL.
DNS может ответить проверке публичным адресом, а последующему запросу — 127.0.0.1 или 169.254.169.254 (метаданные облака). Проверка имени хоста не защищает от SSRF.
PublicAddresses отклоняет приватные, loopback, link-local, CGNAT и multicast диапазоны.AddressPolicy и Resolver.RedirectFollower заново резолвит, проверяет и привязывает каждый hop.HTTP_PROXY / HTTPS_PROXY из окружения; прокси включается явно через proxy:.RequestRefused, ResolutionFailed, ResponseTooLarge, TransferFailed, TooManyRedirects.Политика по умолчанию пропускает только публичные адреса; частные, loopback и link-local отклоняются, а IPv4-mapped адрес оценивается как вложенный в него IPv4.
$policy = new PublicAddresses(); foreach (['93.184.216.34', '::ffff:8.8.8.8', '127.0.0.1', '10.0.0.5', '169.254.169.254', '::ffff:10.0.0.1', 'fd12::1', '100.64.0.1'] as $address) { echo str_pad($address, 24), $policy->allows($address) ? 'allowed' : 'refused', "\n";}
Собственный AddressPolicy ослабляет или ужесточает правило, например пропускает хост разработки.
final readonly class PublicOrLoopback implements AddressPolicy{ public function __construct(private AddressPolicy $inner) {} public function allows(string $address): bool { return $address === '127.0.0.1' || $this->inner->allows($address); }} $client = new PinnedClient(policy: new PublicOrLoopback(new PublicAddresses()));
link-preview рекомендует его как PSR-18 клиент для своего Fetcher.
timeoutSeconds не ограничивает DNS-резолвинг, а враждебный системный резолвер вне области защиты. С явным прокси граница SSRF переходит к прокси.
Требует ext-curl, ext-filter, Guzzle 7.9 и интерфейсы PSR HTTP.
Первый релиз v0.1.0 — 2026-10-23, всего релизов: 5.
| v1.0.1 | 2026-11-19 |
| v1.0.0 | 2026-11-01 |
| v0.3.0 | 2026-11-01 |
| v0.2.0 | 2026-11-01 |
| v0.1.0 | 2026-10-23 |
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу