« session\_save\_pathsession\_set\_save\_handler »PHP ManualФункції для роботи із сесіями

session_set_cookie_params

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

session_set_cookie_params — Встановлює параметри сесійної cookie

Опис

session_set_cookie_params(    int $lifetime_or_options,    ?string $path = null,    ?string $domain = null,    ?bool $secure = null,    ?bool $httponly = null): bool

Альтернативна сигнатура доступна з PHP 7.3.0:

session_set_cookie_params(array $lifetime_or_options): bool

session_set_cookie_params(array $options): bool

Встановлює параметри cookie, визначені у php.ini. Ефект цієї функції зберігається лише під час виконання скрипта. Таким чином, потрібно викликати session_set_cookie_params() для кожного запиту та перед кожним викликом session_start()

Ця функція оновлює поточні ini-значення відповідних ключів конфігурації PHP ini, які можна отримати за допомогою ini_get()

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

lifetime_or_options

Якщо використовувати першу сигнатуру, час життя сесійної куки, задане в секундах.

Якщо використовувати другу сигнатуру, то асоціативний масив (array), який може мати будь-який ключ lifetime path domain secure httponlyиsamesite. Значення мають той самий зміст, як описано у параметрах з відповідним ім'ям. Значення елемента samesite повинно бути або Lax, либоStrict. Якщо жодна з допустимих опцій не вказана, її значення за умовчанням збігаються зі значеннями за промовчанням для явних параметрів. Якщо елемент samesiteне указан, cookie-атрибут SameSite не установлен.

path

Шлях в домені, де буде працювати cookie. Використовуйте одну косу ('/') для всіх шляхів у домені.

domain

Домен cookie, наприклад 'www.php.net'. . Щоб зробити cookies видимими для всіх піддоменів, перед ім'ям домену потрібно встановити точку, наприклад '.php.net'.

secure

Якщо true, то cookies будут передаваться только череззахищенісоединения.

httponly

Если установлено**true**, то PHP спробує відправити прапор httponlyпри настройке сессионной cookie.

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

ВерсияОпис
8.0.0pathdomainsecureиhttponly тепер можуть бути null
7.3.0Додано альтернативний підпис, що підтримує масив опцій lifetime_or_options. . Цей підпис також підтримує налаштування cookie-атрибута SameSite.
7.2.0Повертає true у разі успішного виконання або false у разі виникнення помилки. Раніше повертала тип void.

Дивіться також