- PHP Manual
- Функции для работы с сессиями
- Устанавливает параметры сессионной cookie
session_set_cookie_params
(PHP 4, PHP 5, PHP 7)
session_set_cookie_params — Устанавливает параметры сессионной cookie
Описание
$lifetime_or_options
, string|null $path = null
, string|null $domain = null
, bool|null $secure = null
, bool|null $httponly = null
) : boolАльтернативная сигнатура доступна с 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.
|
Смотрите также
- session.cookie_lifetime
- session.cookie_path
- session.cookie_domain
- session.cookie_secure
- session.cookie_httponly
- session.cookie_samesite
- session_get_cookie_params() - Возвращает параметры cookie сессии