Как использовать PHP-сессии в WordPress
В WordPress PHP-сессию запускайте на хуке init, а после записи данных закрывайте через session_write_close(). Разместите обработчики в mu-plugin, чтобы код не зависел от темы. Вы научитесь читать и удалять значения, менять идентификатор при входе и полностью завершать сессию при выходе. Отдельно настройте исключения кеша для страниц с персональными данными.
Открываем PHP-сессию
Функция session_start() создает новую сессию или возобновляет существующую. Браузер хранит идентификатор в cookie, а PHP сохраняет значения на сервере.
Не размещайте session_start() в header.php. Тема может измениться, а вывод до запуска сессии приводит к предупреждению «headers already sent».
- Сделайте резервную копию сайта и подготовьте тестовую установку. Ошибка в PHP-файле может остановить загрузку WordPress.
- Откройте каталог
wp-content/mu-plugins. Создайте его, если каталога еще нет. - Создайте файл
mysite-session.phpи вставьте полный листинг из этого раздела. WordPress автоматически подключает PHP-файлы, которые лежат непосредственно вmu-plugins. - Создайте обычную страницу со слагом
session-demo. Добавьте в ее содержимое шорткод[mysite_session_demo]и опубликуйте страницу.
Вместо mu-plugin подойдет functions.php дочерней темы. Файл родительской темы не используйте: обновление темы сотрет изменения.
Если вставляете листинг в существующий PHP-блок, не копируйте открывающий тег <?php повторно.
Листинг открывает сессию только на странице демонстрации. Префикс mysite_ снижает риск конфликта имен с плагинами.
Параметр set_session=1 включает тестовую запись, а end_session=1 запускает очистку.
<?php
/**
* Plugin Name: MySite Session Example
*/
function mysite_start_session() {
if (session_status() === PHP_SESSION_ACTIVE) {
return true;
}
if (session_status() !== PHP_SESSION_NONE || headers_sent()) {
return false;
}
session_set_cookie_params([
'lifetime' => 0,
'path' => '/',
'domain' => '',
'secure' => is_ssl(),
'httponly' => true,
'samesite' => 'Lax',
]);
return session_start([
'use_strict_mode' => 1,
'use_only_cookies' => 1,
]);
}
function mysite_close_session() {
if (session_status() === PHP_SESSION_ACTIVE) {
session_write_close();
}
}
function mysite_is_demo_request() {
if (wp_doing_cron() || wp_doing_ajax() || is_admin()) {
return false;
}
if (defined('REST_REQUEST') && REST_REQUEST) {
return false;
}
$request_path = wp_parse_url(
$_SERVER['REQUEST_URI'] ?? '',
PHP_URL_PATH
);
$demo_path = wp_parse_url(
home_url('/session-demo/'),
PHP_URL_PATH
);
if (!is_string($request_path) || !is_string($demo_path)) {
return false;
}
return untrailingslashit($request_path) === untrailingslashit($demo_path);
}
function mysite_demo_session() {
if (!mysite_is_demo_request()) {
return;
}
if (!defined('DONOTCACHEPAGE')) {
define('DONOTCACHEPAGE', true);
}
if (($_GET['end_session'] ?? '') === '1') {
return;
}
if (!mysite_start_session()) {
return;
}
if (($_GET['set_session'] ?? '') === '1') {
$_SESSION['foo'] = 'Foo Data';
}
mysite_close_session();
}
add_action('init', 'mysite_demo_session', 1);
function mysite_session_demo_shortcode() {
if (!isset($_SESSION['foo'])) {
return 'Значение не задано';
}
return esc_html($_SESSION['foo']);
}
add_shortcode('mysite_session_demo', 'mysite_session_demo_shortcode');
function mysite_login_session() {
if (empty($_COOKIE[session_name()])) {
return;
}
if (!mysite_start_session()) {
return;
}
$_SESSION = [];
session_regenerate_id(true);
mysite_close_session();
}
add_action('wp_login', 'mysite_login_session');
function mysite_end_session() {
if (session_status() !== PHP_SESSION_ACTIVE) {
if (empty($_COOKIE[session_name()])) {
return;
}
if (!mysite_start_session()) {
return;
}
}
if (session_status() !== PHP_SESSION_ACTIVE || headers_sent()) {
return;
}
$_SESSION = [];
$params = session_get_cookie_params();
if (ini_get('session.use_cookies')) {
setcookie(session_name(), '', [
'expires' => time() - 3600,
'path' => $params['path'],
'domain' => $params['domain'],
'secure' => $params['secure'],
'httponly' => $params['httponly'],
'samesite' => $params['samesite'] ?? 'Lax',
]);
unset($_COOKIE[session_name()]);
}
session_destroy();
session_id('');
}
add_action('wp_logout', 'mysite_end_session');
function mysite_force_end_session() {
if (!mysite_is_demo_request()) {
return;
}
if (($_GET['end_session'] ?? '') !== '1') {
return;
}
do_action('mysite_end_session_action');
}
add_action('init', 'mysite_force_end_session', 2);
add_action('mysite_end_session_action', 'mysite_end_session');Проверка session_status() показывает состояние сессии. Функция session_id() возвращает или меняет идентификатор, но не запускает сессию.
Проверка headers_sent() не допускает запуск после отправки заголовков.
Функция mysite_is_demo_request() сравнивает путь запроса с путем тестовой страницы. Она работает на раннем init, когда условный тег is_page() еще нельзя использовать для определения страницы.
Откройте /session-demo/?set_session=1: шорткод покажет Foo Data. Затем откройте /session-demo/ без параметра: значение сохранится. Браузер хранит cookie под именем из session_name(), обычно PHPSESSID.
Для отката удалите файл wp-content/mu-plugins/mysite-session.php и шорткод со страницы.
Запись и чтение данных сессии
$_SESSION – суперглобальный массив PHP. После успешного запуска сессии объявлять его через global не нужно.
В обработчике mysite_demo_session() запись выполняет одна строка:
$_SESSION['foo'] = 'Foo Data';Условие с set_session=1 отделяет запись от обычного чтения. Без этого параметра обработчик только загружает сохраненное состояние и закрывает сессию.
Шорткод читает значение с проверкой isset. Страница покажет Foo Data, если ключ существует.
if (isset($_SESSION['foo'])) {
echo esc_html($_SESSION['foo']);
} else {
echo 'Значение не задано';
}Функция esc_html() экранирует значение перед выводом в HTML.
Чтобы удалить один ключ, замените присваивание внутри условия с set_session:
unset($_SESSION['foo']);Откройте /session-demo/?set_session=1 повторно: теперь обработчик удалит ключ. Шорткод покажет «Значение не задано», в том числе после посещения страницы без параметра.
Вызов mysite_close_session() оставьте после условия: он сохранит удаление.
Любую запись выполняйте между успешным mysite_start_session() и mysite_close_session().
После закрытия изменения массива не сохраняются. Для следующей записи сначала возобновите сессию, а затем снова закройте ее.
Закрываем PHP-сессию
session_write_close() сохраняет значения и освобождает блокировку. Функция не удаляет данные и не завершает пользовательскую сессию.
Стандартный файловый обработчик PHP блокирует параллельные обращения к одной сессии. Закрывайте ее сразу после записи, перед долгими вычислениями и HTTP-запросами.
«Здоровье сайта» сообщает об активной PHP-сессии, если проверка обнаруживает ее открытой. Блокировка может мешать REST API и loopback-запросам, включая работу редактора блоков и WP-Cron.
В листинге служебные запросы пропускаются до запуска сессии.
Для другого сценария сохраняйте такие исключения для cron, AJAX, REST и, при необходимости, административных страниц. Ограничение конкретным путем дополнительно предотвращает запуск на посторонних запросах.
Откройте «Инструменты» → «Здоровье сайта» и дождитесь завершения проверок. Если предупреждение осталось, найдите другие вызовы session_start() в теме и плагинах.
Завершаем сессию при входе и выходе
Функция session_destroy() удаляет серверные данные текущей сессии. Она не очищает $_SESSION текущего запроса и не удаляет cookie.
Обработчик mysite_end_session() сначала возобновляет сессию, если cookie уже существует. Затем он очищает массив, удаляет cookie с прежними параметрами и вызывает session_destroy().
Хук wp_logout запускает очистку при выходе.
Хук wp_login очищает гостевые данные и вызывает session_regenerate_id(true). Если браузер уже передал cookie PHP-сессии, обработчик заменит ее идентификатор при входе.
Откройте /session-demo/?set_session=1 и посмотрите cookie в инструментах разработчика браузера. Войдите в WordPress в том же браузере и сравните идентификатор. После выхода cookie исчезнет; обычное посещение /session-demo/ создаст пустую сессию.
Эта PHP-сессия хранит данные примера и не заменяет механизм авторизации WordPress.
Параметр httponly закрывает cookie от JavaScript. Флаг secure разрешает передавать ее только через HTTPS; листинг включает его при положительном результате is_ssl(). На рабочем сайте используйте HTTPS.
Значение SameSite=Lax ограничивает отправку cookie в межсайтовых запросах.
Не храните в сессии пароли, платежные реквизиты и лишние персональные данные. Флаги cookie не заменяют nonce и проверку прав WordPress.
Принудительно завершаем сессию
В mu-plugin зарегистрирован хук mysite_end_session_action. Функция mysite_force_end_session() вызывает его на хуке init до вывода страницы.
Обработчик проверяет путь через mysite_is_demo_request(), поэтому ему не нужен результат основного запроса WordPress.
- Откройте
/session-demo/?set_session=1. Если вы меняли присваивание наunset, сначала восстановите исходную строку записи. Шорткод покажетFoo Data. - Откройте
/session-demo/?end_session=1. Обработчик очистит$_SESSION, удалит cookie и завершит серверную сессию. Шорткод покажет «Значение не задано». - Откройте
/session-demo/без параметров. Шорткод снова покажет «Значение не задано»: обычный запрос не записываетfoo.
При одновременной передаче обоих параметров листинг выполнит только сброс.
Параметры записи и очистки предназначены только для тестовой страницы. GET-запросы меняют состояние без проверки nonce, поэтому не используйте этот интерфейс для рабочих данных. Для рабочей кнопки сброса используйте POST-обработчик с проверкой nonce и вызывайте do_action('mysite_end_session_action') до вывода HTML.
Если нужно только отпустить блокировку и сохранить данные, вызывайте mysite_close_session(). Для полного удаления используйте mysite_end_session().
Защищаем страницы сессии от кеша
Общий page cache не должен сохранять персональный HTML. Иначе один посетитель увидит данные другого, а PHP может не запуститься при попадании страницы в кеш.
Следующие шаги подходят для WP Super Cache; плагин должен быть установлен и активирован.
- Если плагина еще нет, откройте «Плагины» → «Добавить новый плагин». Введите
WP Super Cacheв поиск. - У нужного плагина нажмите «Установить», затем «Активировать». В списке установленных плагинов появится активный WP Super Cache.
- Откройте «Настройки» → «WP Super Cache». На экране расширенных параметров найдите многострочное поле исключений URL: рядом указано, что страницы с перечисленными строками в адресе не кешируются. Добавьте отдельной строкой
/session-demo/. - Сохраните настройки. Вместо исключения можно временно отключить плагин: откройте «Плагины» → «Установленные плагины» и нажмите «Деактивировать» под WP Super Cache. Тогда демонстрация идет без его page cache.
- Если оставили плагин включенным, удалите сохраненные страницы через кнопку очистки кеша на его экране настроек. Это уберет ранее сохраненную копию тестовой страницы.
Для отмены исключения удалите строку /session-demo/ из того же поля и сохраните настройки. Возвращайте кеширование этой страницы только после удаления персонального вывода.
Константа DONOTCACHEPAGE в листинге дополнительно помечает запрос как персональный для кеширующих плагинов.
Внешний кеш хостинга или Varnish тоже должен исключать URL /session-demo/. Одной PHP-константы для кеша, который отвечает до запуска WordPress, недостаточно. Отключение WP Super Cache также не отключает другие уровни кеширования.
Cookie PHPSESSID помогает определить запросы существующей сессии, если сервер использует это имя. Исключение URL охватывает и первое посещение, когда cookie еще нет.
Изоляцию видно в двух независимых профилях браузера. В первом откройте /session-demo/?set_session=1, во втором – /session-demo/. Первый профиль должен увидеть Foo Data, второй – «Значение не задано».
Если сбросить сессию первого профиля через ?end_session=1, то при повторном открытии страницы без параметров оба профиля покажут «Значение не задано».
Когда сессии не нужны и чем их заменить
PHP-сессия подходит для временного состояния гостя. Для данных с другим сроком жизни выберите механизм WordPress, который соответствует владельцу и задаче.
| Задача | Что использовать | Ограничение |
|---|---|---|
| Настройки авторизованного пользователя | User meta: get_user_meta(), update_user_meta() | Проверяйте права на чтение и изменение |
| Временный результат вычисления | Transients: get_transient(), set_transient() | Значение может исчезнуть раньше срока |
| Некритичный выбор интерфейса | Cookie | Посетитель может изменить значение, сервер перепроверяет его |
| Корзина WooCommerce | WC()->session | Используйте механизм сессий WooCommerce |
| Временное состояние гостя | PHP-сессия | Нужны исключения кеша и контроль блокировок |
В cookie храните только некритичные данные, которые сервер проверяет заново. Пароли, токены и персональные сведения для такой схемы не подходят.
Transients сами по себе не привязывают значение к посетителю.
Для приватных данных добавляйте безопасный идентификатор владельца и проверяйте права. Знание ключа transient не должно давать постороннему доступ к данным.
На нескольких серверах локальные файлы сессий создают проблему: балансировщик может отправить следующий запрос на сервер без нужного файла. Общее хранилище Redis или Memcached с соответствующим обработчиком session.save_handler решает эту задачу. Другой вариант – sticky sessions, которые закрепляют посетителя за одним сервером.
Совет от нашей редакции: оставляйте PHP-сессию только на страницах, которым нужно гостевое состояние, и закрывайте ее сразу после записи.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Как правильно редактировать шаблоны WordPress 4 мин чтения
- Как отредактировать главную страницу WordPress 11 мин чтения
- Как увеличить размер файла в WordPress 12 мин чтения
- Как настроить SMTP в WordPress: проверка и установка 2 мин чтения
Комментарии
Вообще при работе в вп с сессиями заметил что самым эффективным будет стартовать сессию не через add_action('init'), а именно просто напросто прописать session_start в файле конфига, и лучше до define( 'WP_DEBUG').
Почему так лучше??? Да потому что не видит переменную $_SESSION в плагине или в файле функций, к примеру при загрузке страницы мне сразу нужно определить есть ли сессия у юсера или нет, и если она есть то сразу получить данные по юсеру. В общем подключение сессии через add_action('init') как то совсем криво работает, поскольку событие init срабатывает после подключения плагинов и файлов функций темы. Если все таки хотите подключить через акшен, то лучше использовать событие plugins_loaded и тогда будет вот так add_action('plugins_loaded', 'ваша функция', 1);
Спасибо за помощь, брат, а то я регистрацию делаю на сайте, а твой коммент помог в отличие от статьи которая положила мой сайт к чёрту)
Все что написано в блоке "Что нужно учесть" считаю в корне не верным. Сессии не жрут ресурсы. Хранить инфу по юсеру у него в браузере не есть гуд, потому что украсть его куки могут, с сессиями так не прокатит, кому кому а вот сессиям доверять можно в отличие от кукисов и все что приходит от пользователя.
А в какой файл добавлять глобальную переменную $_SESSION, и в какой участок кода?
Да не, просто добавлять эту переменную, а с ней нужно работать, если у вас включена сессия session_start
Обычно код добавляется в конец файла function.php в активной теме.
Но этот метод сложно назвать самым эффективным. WordPress предлагает API Actions.