session_id

(PHP 4, PHP 5, PHP 7, PHP 8)

session_idПолучает и (или) устанавливает идентификатор текущей сессии

Описание

session_id(?string $id = null): string|false

Функция session_id() получает или устанавливает идентификатор текущей сессии.

Текущее имя и идентификатор сессии в виде строки, которую можно добавлять в URL-адреса, также получают через константу SID. Дополнительную информацию об обработке сессий даёт раздел «Функции для работы с сессиями».

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

id

Параметр id заменит идентификатор текущий сессии, если значение аргумента не равно null. Для этого функцию session_id() вызывают перед вызовом функции session_start(). Набор символов, которые разрешается указывать в идентификаторе сессии, зависит от обработчика сессии. Например, обработчик файлов сессий поддерживает только символы из диапазона [a-zA-Z0-9,-].

Замечание: Функция session_start() будет отправлять новый блок данных cookie при каждом вызове, если в файле конфигурации включили сессионные cookies и вызвали функцию session_id() с аргументом id, независимо от того, совпадает ли идентификатор текущей сессии с тем, который устанавливает функция.

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

Функция session_id() возвращает идентификатор текущей сессии или пустую строку "", если текущей сессии нет — идентификатор текущей сессии не существует. Функция возвращает false, если возникла ошибка.

Список изменений

Версия Описание
8.0.0 Параметр id теперь принимает значение null.

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