session_name
(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — Отримати або встановити ім'я поточної сесії
Опис
session_name(?string $name = null): string|false
session_name() повертає ім'я поточної сесії. Якщо встановлено параметр name
session_name() оновить ім'я сесії та поверне стареимя сессии.
Якщо нове ім'я сесії (name
) предоставлено,session_name() змінює cookie HTTP (і виводить вміст при включеній опції session.transid
). Коли cookie HTTP надіслано, session_name() викликає помилку . session_name() необхідно викликати до session_start() для правильної роботи сесії
Ім'я сесії скидаються на значення за умовчанням, що зберігається в session.name
під час запуску запиту. Таким чином, вам потрібно викликати session_name() для кожного запиту (і до session_start()
Список параметрів
name
Ім'я сесії посилається на ім'я сесії, яке використовується в cookie та URL (наприклад, PHPSESSID
). Воно має містити лише буквено-цифрові символи, і має бути коротким і зрозумілими (наприклад, для користувачів із увімкненим попередженням cookie). Якщо встановлено параметр name
и он не равен**null
**, ім'я поточної сесії зміниться нею.
Увага
Ім'я сесії не може складатися тільки з цифр, принаймні одна буква має бути присутньою. Інакше щоразу генеруватиметься новий ідентифікатор.
Значення, що повертаються
Повертає ім'я поточної сесії. Якщо встановлено параметр name
, ім'я поточної сесії зміниться і буде повернуто стареили**false
**в случае возникновения ошибки.
список змін
Версия | Опис |
---|---|
8.0.0 | module тепер може бути**null ** |
7.2.0 | session_name() перевіряє статус сесії, раніше вона перевіряла лише статус cookie. Тому стара версія session_name() дозволяла викликати **session_name()**послеsession_start(), що могло призвести до збою PHP та неправильної поведінки. |
Приклади
Приклад #1 Приклад використання session_name()****
Loading...
Дивіться також
- Параметр конфігураціїsession.name