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

# session_id

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

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

### Описание

function 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`.

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

- session_regenerate_id() - Генерирует и обновляет идентификатор текущей сессии
- session_start() - Начинает или возобновляет сессию
- session_set_save_handler() - Устанавливает пользовательские обработчики хранения сессии
- session.save_handler

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open