PHPTime

Cookie в PHP: setcookie, чтение, удаление и флаги безопасности

PHP устанавливает cookie в HTTP-ответе, а браузер отправляет сохранённые значения с подходящими запросами. На примере настройки темы разберём весь цикл: запись через setcookie(), чтение из $_COOKIE и удаление с теми же параметрами области действия.

Cookie — небольшое значение, которое браузер хранит для сайта. Сервер предлагает сохранить его заголовком Set-Cookie. В следующих запросах браузер передаёт подходящие пары «имя — значение» в заголовке Cookie, а PHP разбирает их в суперглобальный массив $_COOKIE. Браузер учитывает хост, путь, срок действия и ограничения безопасности.

Cookie подходят для настройки темы, языка и идентификатора сессии. В последнем случае данные пользователя хранятся на сервере, а cookie содержит идентификатор, по которому PHP находит сессию. Любое входящее значение клиент может подменить. Роль, цену, баланс и права доступа определяйте по серверным данным.

Для PHP 8.3–8.5 удобно передавать имя, значение и массив именованных параметров. Вызовите setcookie() до отправки тела ответа. Ниже обработчик на HTTPS сохраняет тёмную тему на 30 дней и после POST возвращает статус 303.

PHP
<?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 в следующем запросе к нужной странице.

$_COOKIE отражает входящий запрос. После setcookie() в текущем запросе массив сохранит прежнее значение или ключ по-прежнему будет отсутствовать. Если новое значение нужно для формирования этого же ответа, используйте локальную переменную. При перенаправлении браузер сможет отправить новую cookie уже в запросе к целевой странице.

PHP
<?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 в браузере, отправьте Set-Cookie с тем же именем и прошедшим сроком действия. Для обычной cookie при удалении важны тот же хост или domain и тот же path. Для примера с темой на том же хосте используйте путь / и снова опустите domain.

PHP
<?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, в явном виде задаёт срок браузерной сессии. Для удаления указывайте время в прошлом.

ПараметрЧто делаетКак выбирать
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
<?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 сессии — положительную длительность.

  1. Выберите уникальное имя, явный путь и срок действия. Указывайте domain только при необходимости общего доступа с нескольких хостов.
  2. Вызовите setcookie() до вывода тела ответа. Для HTTPS включите Secure, для серверных значений — HttpOnly, а SameSite задайте по сценарию.
  3. Читайте значение из $_COOKIE на следующем запросе. Обрабатывайте отсутствующий ключ и проверяйте тип и допустимые значения.
  4. Удаляйте cookie с прошедшим expires, тем же именем, путём и областью домена. При выходе завершайте серверную сессию.
  5. В браузере проверьте сценарий целиком: появление 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.

Справка по теме

Ещё в разделе «Справочник PHP»

Ассоциативные и многомерные массивы в PHP

Как создавать ассоциативные и многомерные массивы в PHP, читать вложенные данные, получать ключи и значения через array_keys() и array_values().

10 мин

Вывод ошибок в PHP: display_errors, error_reporting и логи

Как включить вывод ошибок PHP через display_errors и ini_set, настроить error_reporting и error_log, найти логи и разобраться с deprecated в PHP 8.3–8.5.

9 мин

Дата и время в PHP: date, DateTime и часовые пояса

Как получить текущую дату и время в PHP, настроить часовой пояс, разобрать строку и отформатировать дату с date(), strtotime() и DateTimeImmutable.

8 мин

Загрузка файлов на сервер в PHP: $_FILES и безопасность

Как принять файл через $_FILES, проверить размер, MIME-тип и расширение, сохранить его вне публичной папки, выдать на скачивание и обработать ZIP.

10 мин