Редиректы и безопасность
Cast следует редиректам сам, а не через cURL: так он решает, что можно передать на новый адрес, а что нет.
Редиректы
По умолчанию — следовать, не больше 10 переходов.
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).
Счёт и итоговый адрес
$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 МиБ — см. Настройку клиента.