Cookie в PHP: setcookie, чтение, удаление и флаги безопасности
PHP устанавливает cookie в HTTP-ответе, а браузер отправляет сохранённые значения с подходящими запросами. На примере настройки темы разберём весь цикл: запись через setcookie(), чтение из $_COOKIE и удаление с теми же параметрами области действия.
Как работают cookie в PHP
Cookie — небольшое значение, которое браузер хранит для сайта. Сервер предлагает сохранить его заголовком Set-Cookie. В следующих запросах браузер передаёт подходящие пары «имя — значение» в заголовке Cookie, а PHP разбирает их в суперглобальный массив $_COOKIE. Браузер учитывает хост, путь, срок действия и ограничения безопасности.
Cookie подходят для настройки темы, языка и идентификатора сессии. В последнем случае данные пользователя хранятся на сервере, а cookie содержит идентификатор, по которому PHP находит сессию. Любое входящее значение клиент может подменить. Роль, цену, баланс и права доступа определяйте по серверным данным.
Как установить cookie в PHP через setcookie()
Для PHP 8.3–8.5 удобно передавать имя, значение и массив именованных параметров. Вызовите setcookie() до отправки тела ответа. Ниже обработчик на HTTPS сохраняет тёмную тему на 30 дней и после POST возвращает статус 303.
<?php
declare(strict_types=1);
// Этот обработчик предназначен для POST-запроса по HTTPS.
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
header('Allow: POST');
http_response_code(405);
exit;
}
$saved = setcookie('theme', 'dark', [
'expires' => time() + 30 * 24 * 60 * 60,
'path' => '/',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax',
]);
if (!$saved) {
http_response_code(500);
exit('Не удалось сформировать заголовок cookie.');
}
header('Location: /settings', true, 303);
exit;expires принимает Unix timestamp в секундах. Передайте time() + 3600 для срока в один час или 0 для cookie браузерной сессии. Некоторые браузеры восстанавливают сессию вместе с её cookie после перезапуска. Для авторизации контролируйте срок сессии и на сервере.
Путь / распространяет cookie на весь хост. Без явного path браузер выводит путь из адреса запроса, поэтому cookie, выставленная в одном разделе, может отсутствовать в другом. Если опустить domain, cookie привязывается к текущему хосту. Явный domain нужен, когда значение действительно должно передаваться между подходящими поддоменами. Порт область действия cookie не ограничивает, а Path управляет её отправкой и не служит границей доступа между приложениями на одном хосте.
true от setcookie() означает, что PHP поставил заголовок в очередь на отправку. Сохранение зависит от браузера и его настроек. Проверить весь цикл можно по Set-Cookie в ответе и Cookie в следующем запросе к нужной странице.
Как прочитать PHP cookie через $_COOKIE
$_COOKIE отражает входящий запрос. После setcookie() в текущем запросе массив сохранит прежнее значение или ключ по-прежнему будет отсутствовать. Если новое значение нужно для формирования этого же ответа, используйте локальную переменную. При перенаправлении браузер сможет отправить новую cookie уже в запросе к целевой странице.
<?php
declare(strict_types=1);
$rawTheme = $_COOKIE['theme'] ?? null;
// Принимаем только два значения, которые поддерживает приложение.
$theme = is_string($rawTheme) && in_array($rawTheme, ['light', 'dark'], true)
? $rawTheme
: 'light';
// Допустимые значения перечислены выше и безопасны для вывода.
echo $theme;?? позволяет обработать отсутствующий ключ без предупреждения. Проверка is_string() нужна, поскольку PHP может разобрать имя с квадратными скобками в массив. Строгое сравнение в in_array() исключает приведение типов. Для чисел сначала проверяйте допустимый формат и диапазон, затем приводите тип. declare(strict_types=1) регулирует передачу скалярных аргументов, а проверка входных данных остаётся задачей приложения.
Пустая строка и строка '0' имеют разный смысл. Если '0' допустима, проверяйте значение явно, поскольку empty() сочтёт её пустой. Если проверенное значение всё ещё может содержать произвольный текст, экранируйте его в соответствии с местом вывода. Для HTML-текста и значений атрибутов в кавычках используйте htmlspecialchars().
Кодирование значения
setcookie() URL-кодирует значение при записи, а PHP декодирует его при заполнении $_COOKIE. Для обычной пары setcookie() и $_COOKIE ручной вызов urlencode() или urldecode() не нужен. Если протокол требует передать заранее сформированное значение как есть, используйте setrawcookie() с допустимыми для cookie символами. Пробелы, точки и квадратные скобки в именах лучше исключить: разбор входных параметров PHP может преобразовать такое имя или создать массив.
Как удалить cookie в PHP
Чтобы удалить cookie в браузере, отправьте Set-Cookie с тем же именем и прошедшим сроком действия. Для обычной cookie при удалении важны тот же хост или domain и тот же path. Для примера с темой на том же хосте используйте путь / и снова опустите domain.
<?php
declare(strict_types=1);
// Выполняйте этот код в HTTPS-обработчике до вывода ответа.
if (!setcookie('theme', '', [
'expires' => time() - 3600,
'path' => '/',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax',
])) {
http_response_code(500);
exit('Не удалось сформировать заголовок удаления cookie.');
}
// Сбрасываем локальное значение, если оно больше не нужно в этом запросе.
unset($_COOKIE['theme']);unset($_COOKIE['theme']) меняет массив только в текущем запросе. Браузер удалит запись после обработки заголовка ответа. Если одно имя использовалось с путями / и /settings, отправьте заголовок удаления для каждого пути. При миграции с cookie на общем домене учтите и старую область действия. Значение expires, равное 0, в явном виде задаёт срок браузерной сессии. Для удаления указывайте время в прошлом.
Флаги безопасности cookie: Secure, HttpOnly и SameSite
| Параметр | Что делает | Как выбирать |
|---|---|---|
secure | Ограничивает отправку cookie защищённым соединением. | Включайте для сессий и авторизации. Отдавайте ответ с такой cookie по HTTPS. |
httponly | Закрывает доступ к значению из JavaScript через document.cookie. Браузер по-прежнему может приложить cookie к запросу, инициированному скриптом. | Включайте для идентификатора сессии и других значений, которые читает только сервер. |
samesite | Ограничивает отправку cookie в запросах в контексте другого сайта. | Явно задавайте Lax, Strict или None по сценарию. |
Laxподходит для обычной навигации. Cookie может прийти при переходе по внешней ссылке с запросомGET, но при обычном межсайтовомPOSTили загрузке во вложенном фрейме она не отправляется.Strictисключает отправку в межсайтовом запросе, включая первый переход по внешней ссылке. Если от cookie зависит отображение аккаунта, на первом запросе пользователь может выглядеть как гость.Noneразрешает отправку в межсайтовом контексте и требуетSecure. Браузер всё равно может заблокировать стороннюю cookie. Для внешней авторизации или встраивания проверяйте реальный способ возврата, включая метод запроса и контекст фрейма.
SameSite дополняет защиту от CSRF. Для действий, меняющих состояние, используйте CSRF-токен или эквивалентную защиту приложения. Соседние поддомены могут считаться одним сайтом для SameSite, поэтому этот флаг не разделяет их как независимые приложения.
Настройки для cookie сессии PHP
Если приложение использует встроенные сессии, задайте параметры через session_set_cookie_params() до session_start(). Настройки применяются в пределах текущего запроса. Разместите их в общем коде запуска приложения или выставьте эквивалентные параметры в конфигурации PHP.
<?php
declare(strict_types=1);
// Включаем строгий режим приёма идентификаторов сессии.
ini_set('session.use_strict_mode', '1');
session_set_cookie_params([
'lifetime' => 0,
'path' => '/',
'secure' => true,
'httponly' => true,
'samesite' => 'Lax',
]);
session_start();У сессии параметр lifetime задаётся длительностью в секундах, у setcookie() параметр expires задаётся абсолютным временем. После успешной аутентификации обновите идентификатор сессии через session_regenerate_id(). При выходе завершите сессию на сервере и удалите её cookie с действующими именем, путём и доменом.
Типичные ошибки и отличия PHP 8.3–8.5
- Ошибка
headers already sent. Проверьте вывод HTML,echo, пробелы перед открывающим тегом, BOM и предупреждения из подключаемых файлов.headers_sent($file, $line)помогает найти место, где начался вывод. В файлах, содержащих только PHP, закрывающий тег можно опустить. - Заголовок есть, а cookie отсутствует. Проверьте HTTPS при
Secure, хост, домен, путь и ограничения браузера. Во вкладке сети смотрите каждый ответ цепочки перенаправлений. Установка может произойти в промежуточном ответе, а отправка проверяется на следующем подходящем запросе. - При чтении приходит старое значение. Проверьте, что читаете новый запрос. Затем посмотрите, нет ли нескольких cookie с одним именем и разными путями или доменами. В заголовке
Cookieбраузер не передаёт эти атрибуты вместе со значением, поэтому приложение не может надёжно различить записи по области действия. - Срок рассчитан неверно. Передача
3600вexpiresозначает момент вскоре после начала эпохи Unix. Для одного часа передавайтеtime() + 3600. Для срока жизни cookie сессии вsession_set_cookie_params()используется непосредственно3600.
В PHP 8.3, 8.4 и 8.5 показанные вызовы setcookie(), setrawcookie() и session_set_cookie_params() используют одинаковую форму массива параметров. Для setcookie() и setrawcookie() неизвестный ключ в массиве вызывает ValueError во всех этих версиях. Например, действующий ключ — samesite. Обработка результата false сама по себе исключение не перехватит. У cookie сессии PHP 8.5 помечает настройку session.cookie_lifetime как устаревшую при отрицательных значениях. Для браузерной сессии используйте 0, для постоянной cookie сессии — положительную длительность.
Чек-лист для работы с cookie в PHP
- Выберите уникальное имя, явный путь и срок действия. Указывайте
domainтолько при необходимости общего доступа с нескольких хостов. - Вызовите
setcookie()до вывода тела ответа. Для HTTPS включитеSecure, для серверных значений —HttpOnly, аSameSiteзадайте по сценарию. - Читайте значение из
$_COOKIEна следующем запросе. Обрабатывайте отсутствующий ключ и проверяйте тип и допустимые значения. - Удаляйте cookie с прошедшим
expires, тем же именем, путём и областью домена. При выходе завершайте серверную сессию. - В браузере проверьте сценарий целиком: появление
Set-Cookieв ответе, отправкуCookieпри следующем запросе и её отсутствие после удаления.
Частые вопросы
Почему после setcookie() значение не появилось в $_COOKIE?
$_COOKIE содержит данные входящего запроса. Новое значение приходит, когда браузер обработает Set-Cookie и отправит следующий подходящий запрос. В текущем обработчике используйте локальную переменную.
Можно ли удалить cookie вызовом unset($_COOKIE['theme'])?
unset() удаляет ключ из массива текущего запроса. Для удаления в браузере отправьте setcookie() с прошедшим expires и повторите имя, путь и область домена исходной cookie.
Какой SameSite выбрать для cookie авторизации в PHP?
Lax подходит для обычных переходов по ссылкам. Strict ограничивает в том числе первый переход с другого сайта. Для сценария, который требует передачи cookie в межсайтовом запросе, проверьте None вместе с Secure и учтите ограничения браузера на сторонние cookie.