(PHP 4, PHP 5, PHP 7, PHP 8)
session_set_cookie_params — Устанавливает параметры сессионной cookie
$lifetime_or_options
,$path
= null
,$domain
= null
,$secure
= null
,$httponly
= null
Альтернативная сигнатура доступна с PHP 7.3.0:
$lifetime_or_options
): bool$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.0 |
path , domain ,
secure и httponly теперь могут быть null .
|
7.3.0 |
Добавлена альтернативная подпись, поддерживающая массив опций lifetime_or_options .
Эта подпись поддерживает также настройку cookie-атрибута SameSite.
|
7.2.0 |
Возвращает true в случае успешного выполнения или false в случае возникновения ошибки. Ранее возвращала тип void.
|