Пакет · cast

Редиректы и безопасность

Cast следует редиректам сам, а не через cURL: так он решает, что можно передать на новый адрес, а что нет.

Редиректы

По умолчанию — следовать, не больше 10 переходов.

php
use Flytachi\Winter\Cast\Client\Redirects;

$client->withRedirects(Redirects::follow(max: 5));
$client->withRedirects(Redirects::none());        // вернуть 3xx как есть

Метод и тело

Статус Новый запрос
303 See Other GET без тела (кроме HEAD)
301, 302 после POST GET без тела — так делают браузеры
301, 302 после других методов тот же метод и тело
307, 308 тот же метод и то же тело

Тело-поток, который нельзя перемотать, повторно не отправить: такой 307/308 возвращается как ответ, без перехода.

Адрес перехода

Location разрешается относительно адреса ответа по RFC 3986: со страницы /v1/dir/file переход на other ведёт на /v1/dir/other. Это правило отличается от склейки с базовым адресом клиента — там путь дописывается.

Что не уходит на другой хост

Если меняется схема, хост или порт, из запроса удаляются:

  • Authorization, Proxy-Authorization, Cookie, X-Api-Key;
  • заголовок ключа, поставленный через AuthMiddleware::header() — например, X-Token.

Типичный случай: API отвечает 302 на ссылку CDN или стороннего хранилища. Без снятия заголовков ваш ключ ушёл бы третьей стороне.

Понижение до http

Переход с https:// на http:// не выполняется: ответ 3xx возвращается как есть. Если такой переход действительно нужен — Redirects::follow(allowDowngrade: true).

Счёт и итоговый адрес

php
$response->info()->redirects;      // число переходов
$response->info()->effectiveUri;   // итоговый адрес

Больше max переходов — RequestException «Too many redirects». Заголовки ответа — только итогового, промежуточные 3xx в них не смешиваются.

Что ещё защищено

TLS. Проверка сертификата всегда включена. Отключить её можно только явно, через withCurlOptions([CURLOPT_SSL_VERIFYPEER => false]), и только для разработки.

Только http и https. Адрес с другой схемой (file://, ftp://, gopher://) не отправляется — RequestException. На уровне cURL разрешены тоже только эти два протокола.

Подстановка заголовков. \r, \n и NUL в имени или значении заголовка отклоняются. Значение из пользовательского ввода не может добавить к запросу свой заголовок.

Служебные опции cURL. Через withCurlOptions() нельзя переопределить адрес, метод, заголовки, тело, обратные вызовы и редиректы — то, на чём держатся остальные гарантии.

Логи. Логгер клиента пишет метод, адрес без query, статус, время и число попыток — никаких заголовков и тел. Сообщения исключений тоже без query и user:password@.

Дампы. var_dump() клиента и запроса показывает Authorization, Proxy-Authorization, Cookie, X-Api-Key и помеченные секретными заголовки как ***.

Размер ответа. Тело в памяти ограничено 10 МиБ — см. Настройку клиента.