Задать идентификатор сессии SessionInterface::setId

Модуль: main — подключать отдельно не нужно

Метод SessionInterface::setId задает идентификатор, с которым запустится сессия. Вызывайте метод до start. Чтобы сменить идентификатор активной сессии и сохранить данные, используйте regenerateId.

Сигнатура метода в интерфейсе Bitrix\Main\Session\SessionInterface:

public function setId($id);

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
id* string Задает идентификатор сессии

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод ничего не возвращает.

Исключения

Исключение Когда возникает
\RuntimeException Класс Session, сессия PHP уже активна
Bitrix\Main\NotSupportedException Класс KernelSession не поддерживает метод

Примеры

Пример. Код пытается сменить идентификатор запущенной сессии:

<?php
use Bitrix\Main\Application;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$session = Application::getInstance()->getSession();

try
{
    $session->setId('units' . bin2hex(random_bytes(8)));
}
catch (\RuntimeException $e)
{
    echo $e->getMessage();
}

Код выведет Could not change the ID of an active session.

Смотрите также