Сессии в PHP: session_start, хранение данных и безопасность
Сессия позволяет PHP связать несколько HTTP-запросов с одним посетителем. Сервер хранит данные сессии, а браузер обычно передаёт её идентификатор в cookie. Так работают авторизация, корзина и другие функции, которым нужна память между запросами.
PHP-сессии: что хранит сервер и что получает браузер
По умолчанию PHP использует cookie PHPSESSID. В ней хранится идентификатор сессии. Например, идентификатор пользователя и содержимое корзины остаются на сервере. Когда приходит следующий запрос с этой cookie, PHP находит данные по идентификатору и загружает их в массив $_SESSION.
Типичный цикл запроса выглядит так:
- Приложение вызывает
session_start(). PHP открывает существующую сессию или создаёт новую. - Приложение читает и меняет значения в
$_SESSION. - PHP сохраняет данные при завершении запроса. Чтобы сохранить их раньше и закрыть сессию, вызовите
session_write_close().
Идентификатор сессии даёт доступ к её состоянию. Если его получит другой человек, сервер может принять запрос за запрос владельца. Используйте HTTPS и исключайте идентификаторы сессий из URL, логов и сообщений об ошибках.
PHP session_start: запуск сессии и работа с $_SESSION
Вызовите session_start() до HTML, echo и любого другого вывода. При запуске PHP может отправить cookie и заголовки управления кешированием. Даже пробел перед открывающим тегом PHP или UTF-8 BOM в подключённом файле способен вызвать ошибку headers already sent.
<?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
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-токен. Заказы, права доступа и другие данные, которым требуется собственный срок хранения или актуальное состояние из базы, считывайте из основного хранилища. Объекты в сессии усложняют обновление приложения: их нужно корректно восстановить после изменения классов.
Настройки cookie и время жизни сессии
Для приложения, которое обслуживается по HTTPS, базовые параметры можно задать в php.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 = 0use_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
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
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 с прошедшим сроком действия, используя прежнее имя, путь и домен.