PHPTime

Сессии в PHP: session_start, хранение данных и безопасность

Сессия позволяет PHP связать несколько HTTP-запросов с одним посетителем. Сервер хранит данные сессии, а браузер обычно передаёт её идентификатор в cookie. Так работают авторизация, корзина и другие функции, которым нужна память между запросами.

PHP-сессии: что хранит сервер и что получает браузер

По умолчанию PHP использует cookie PHPSESSID. В ней хранится идентификатор сессии. Например, идентификатор пользователя и содержимое корзины остаются на сервере. Когда приходит следующий запрос с этой cookie, PHP находит данные по идентификатору и загружает их в массив $_SESSION.

Типичный цикл запроса выглядит так:

  1. Приложение вызывает session_start(). PHP открывает существующую сессию или создаёт новую.
  2. Приложение читает и меняет значения в $_SESSION.
  3. PHP сохраняет данные при завершении запроса. Чтобы сохранить их раньше и закрыть сессию, вызовите session_write_close().

Идентификатор сессии даёт доступ к её состоянию. Если его получит другой человек, сервер может принять запрос за запрос владельца. Используйте HTTPS и исключайте идентификаторы сессий из URL, логов и сообщений об ошибках.

PHP session_start: запуск сессии и работа с $_SESSION

Вызовите session_start() до HTML, echo и любого другого вывода. При запуске PHP может отправить cookie и заголовки управления кешированием. Даже пробел перед открывающим тегом PHP или UTF-8 BOM в подключённом файле способен вызвать ошибку headers already sent.

PHP
<?php
declare(strict_types=1);

if (!session_start()) {
    http_response_code(500);
    exit('Не удалось открыть сессию');
}

// При первом запросе счётчик начинается с нуля.
$visits = ($_SESSION['visits'] ?? 0) + 1;
$_SESSION['visits'] = $visits;
session_write_close();

echo 'Просмотров в этой сессии: ' . $visits;

Обновите страницу в том же браузере, чтобы увидеть рост счётчика. Для чтения необязательного ключа подходит $_SESSION['user_id'] ?? null, а для удаления одного значения — unset($_SESSION['cart']). Проверка session_status() === PHP_SESSION_ACTIVE помогает в общем коде, который может вызываться после инициализации сессии.

В приложении обычно достаточно одного места для запуска сессии: общего bootstrap-файла или middleware. Вызывайте его на маршрутах, которым нужны данные посетителя. При использовании фреймворка хранение и запуск сессии обычно уже входят в жизненный цикл запроса.

Хранение данных PHP session: файлы, Redis и блокировки

Стандартный обработчик files хранит сериализованные данные на диске. Параметр session.save_path задаёт путь хранения. Процессу PHP нужны права на запись в каталог, а сам каталог следует размещать вне публичной директории сайта. В контейнере проверьте, переживёт ли выбранное хранилище перезапуск и пересоздание контейнера.

Если запросы одного посетителя могут попасть на разные серверы, всем экземплярам приложения нужен доступ к его сессии. Для этого используют общее хранилище, например Redis с подходящим обработчиком сессий, или собственный обработчик на основе SessionHandlerInterface. При переходе проверьте правила истечения записей, поддержку строгого режима и поведение при параллельной записи. Эти свойства зависят от реализации обработчика.

Стандартный файловый обработчик блокирует сессию на время работы с ней. Два параллельных запроса одного браузера могут выполняться по очереди, даже если второй только читает данные. Сохраните изменения через session_write_close() перед внешним HTTP-вызовом, долгим запросом к базе или потоковым ответом. Изменения массива $_SESSION после закрытия автоматически в хранилище уже не попадут.

PHP
<?php
declare(strict_types=1);

// Читаем данные и сразу освобождаем блокировку.
if (!session_start(['read_and_close' => true])) {
    http_response_code(500);
    exit;
}

$userId = $_SESSION['user_id'] ?? null;

У read_and_close есть нюанс: файловый обработчик при таком чтении не обновляет время изменения файла. Если пользователь посещает только такие маршруты, сборщик мусора может удалить его сессию. Учитывайте это при настройке срока жизни.

Храните в сессии компактные данные: идентификаторы, служебные отметки времени, CSRF-токен. Заказы, права доступа и другие данные, которым требуется собственный срок хранения или актуальное состояние из базы, считывайте из основного хранилища. Объекты в сессии усложняют обновление приложения: их нужно корректно восстановить после изменения классов.

Для приложения, которое обслуживается по HTTPS, базовые параметры можно задать в php.ini:

ini
session.use_strict_mode = 1
session.use_only_cookies = 1
session.use_trans_sid = 0
session.cookie_secure = 1
session.cookie_httponly = 1
session.cookie_samesite = Lax
session.cookie_path = /
session.cookie_lifetime = 0
  • use_strict_mode не позволяет принять присланный клиентом неизвестный идентификатор. Если используете собственный обработчик, реализуйте проверку идентификатора через SessionUpdateTimestampHandlerInterface::validateId() или соответствующий callback.
  • use_only_cookies ограничивает передачу идентификатора cookie. Отключённый use_trans_sid запрещает автоматическую подстановку идентификатора в ссылки и формы.
  • Secure ограничивает отправку cookie защищённым соединением, а HttpOnly закрывает чтение cookie через document.cookie.
  • SameSite=Lax ограничивает отправку cookie в межсайтовых запросах и обычно допускает переходы по внешним ссылкам. Для межсайтовых сценариев, которым нужна cookie, применяется SameSite=None вместе с Secure.

Параметры cookie можно установить и через session_set_cookie_params() до запуска сессии. Этот вызов действует на текущий скрипт, поэтому разместите его в общей точке входа. Оставьте Domain пустым, если cookie нужна только текущему хосту.

session.cookie_lifetime управляет временем жизни cookie в браузере. Значение 0 создаёт cookie без заданного времени истечения, и браузер может восстановить её вместе с предыдущей сессией. session.gc_maxlifetime задаёт возраст, после которого серверные записи могут удаляться сборщиком мусора. Момент удаления зависит от запуска сборщика и обработчика хранения.

Для авторизации применяйте собственные тайм-ауты. Храните время входа и последней активности в сессии, проверяйте их перед доступом к защищённому маршруту и завершайте сессию по истечении лимита. Так срок доступа будет предсказуемым даже при нерегулярной очистке хранилища.

Вход, смена идентификатора и выход

Меняйте идентификатор после входа

После проверки пароля через password_verify() или успешного входа через провайдера авторизации смените идентификатор сессии перед записью признака входа. Это защищает от фиксации сессии: прежний идентификатор не получит доступ к новой авторизованной сессии. Меняйте идентификатор также при повышении привилегий.

PHP
<?php
declare(strict_types=1);

// Вызывайте после проверки учётных данных при активной сессии.
function establishLogin(int $userId): void
{
    if (!session_regenerate_id(true)) {
        throw new RuntimeException('Не удалось сменить идентификатор сессии');
    }

    $_SESSION['user_id'] = $userId;
    $_SESSION['authenticated_at'] = time();
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}

Аргумент true удаляет запись со старым идентификатором сразу. В приложении с параллельными запросами это может вызвать гонку: запрос со старой cookie придёт после её смены. Если клиент нельзя синхронизировать, проектируйте переход со сроком действия старого идентификатора и запретом доступа по нему к авторизованному состоянию. Простое переключение аргумента на false оставляет старую запись в хранилище.

Для запросов, меняющих состояние, проверяйте CSRF-токен из формы или заголовка, например через hash_equals() после проверки типа входного значения. Атрибут SameSite дополняет эту проверку.

Очищайте данные и cookie при выходе

session_destroy() удаляет серверную запись, а массив текущего запроса и cookie браузера нужно очистить отдельно. Этот фрагмент выполняется после запуска сессии и проверки CSRF-токена на маршруте выхода.

PHP
<?php
declare(strict_types=1);

$params = session_get_cookie_params();
$_SESSION = [];

if (!session_destroy()) {
    http_response_code(500);
    exit('Не удалось завершить сессию');
}

// Для удаления используем то же имя, путь и домен cookie.
setcookie(session_name(), '', [
    'expires' => time() - 3600,
    'path' => $params['path'],
    'domain' => $params['domain'],
    'secure' => $params['secure'],
    'httponly' => $params['httponly'],
    'samesite' => $params['samesite'],
]);

http_response_code(204);
exit;

Типичные ошибки сессий в PHP

СимптомЧто проверить
headers already sentНайдите первый вывод перед session_start(), сменой идентификатора или setcookie(). Проверьте подключаемые файлы на BOM и случайные пробелы.
Каждый запрос начинает новую сессиюВ инструментах разработчика проверьте заголовок Set-Cookie в ответе и Cookie в следующем запросе. Сверьте HTTPS, путь, домен и SameSite.
Cookie приходит, но данные пропадаютПроверьте права на запись, общий доступ к хранилищу, его срок жизни и момент вызова session_write_close().
Параллельные запросы одного пользователя ждут друг другаПроверьте, где освобождается блокировка, и закройте сессию перед долгой операцией.
Выход срабатывает только до обновления страницыПроверьте результат session_destroy() и совпадение имени, пути и домена удаляемой cookie. Если есть функция «Запомнить меня», проверьте, аннулируется ли и её токен.

Что отличается в PHP 8.3, 8.4 и 8.5

В PHP 8.3–8.5 запуск через session_start(), работа с $_SESSION и параметры cookie из примеров применяются одинаково. В PHP 8.4 параметры session.sid_length и session.sid_bits_per_character объявлены устаревшими. При обновлении с 8.3 на 8.4 или 8.5 уберите их из конфигурации приложения и используйте настройки генерации идентификаторов PHP по умолчанию. Если приложение проверяет идентификатор регулярным выражением или хранит его в поле фиксированной длины, проверьте эти ограничения перед обновлением.

declare(strict_types=1) помогает соблюдать скалярные типы при вызовах функций. Содержимое $_SESSION остаётся массивом с произвольными значениями. Перед передачей значения в типизированный код проверьте его тип, особенно если после деплоя приложение продолжает читать записи, созданные старой версией.

Чек-лист перед запуском

  • Запускайте сессию до вывода и обрабатывайте результат session_start().
  • Проверьте в браузере, что cookie отправляется по HTTPS и имеет нужные атрибуты Secure, HttpOnly и SameSite.
  • Включите строгий режим и убедитесь, что обработчик хранения его поддерживает.
  • Меняйте идентификатор при входе и повышении привилегий. Очищайте серверную запись и cookie при выходе.
  • Проверяйте CSRF-токен на маршрутах, меняющих состояние, и применяйте серверные тайм-ауты авторизации.
  • Закрывайте сессию после последней записи. Проверьте вход, параллельные запросы и выход, включая запрос со старой cookie после выхода.

Частые вопросы

Зачем нужен session_start() в PHP?

Он открывает существующую сессию или создаёт новую и загружает её данные в $_SESSION. Его вызывают до отправки тела ответа на каждом запросе, которому нужна сессия.

Где хранятся данные PHP-сессии?

Стандартный обработчик хранит их в файлах на сервере. Параметр session.save_path задаёт путь хранения. При использовании другого обработчика данные могут храниться в Redis или другом серверном хранилище. В браузере обычно сохраняется только идентификатор.

Почему session_destroy() не удаляет cookie?

Эта функция удаляет серверные данные сессии. Чтобы завершить выход, очистите $_SESSION и отправьте cookie с прошедшим сроком действия, используя прежнее имя, путь и домен.

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

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

Сортировка массивов в PHP: sort, usort, ksort и другие

Как сортировать массивы в PHP 8.3–8.5 по значениям, ключам и полям: примеры sort, usort, ksort и array_multisort, флаги сравнения и типичные ошибки.

8 мин

Строки в PHP: длина, поиск, замена и обрезка

Как узнать длину строки в PHP, найти и вырезать подстроку, заменить или удалить текст, обрезать пробелы и обработать переносы строк в PHP 8.3–8.5.

10 мин

Типы данных и преобразование типов в PHP

Типы данных в PHP 8.3–8.5: как узнать тип переменной, преобразовать строку в число, проверить null через isset и empty, разделить и округлить числа.

10 мин

Функции в PHP: аргументы, типы, замыкания и стрелочные функции

Практическая справка по функциям PHP 8.3–8.5: аргументы, типы и return, область видимости, global и static, замыкания use и стрелочные функции fn.

10 мин