PHP&MySQL Документация и сервисы
  • PHP
  • MySQL
  • Smarty
  • PEAR
  • PHP-GTK
  • Типограф
  • Сокращатель ссылок
phpm.ru
  • « session_save_path
  • session_set_save_handler »
  • PHP Manual
  • Функции для работы с сессиями
  • Устанавливает параметры сессионной cookie

session_set_cookie_params

(PHP 4, PHP 5, PHP 7)

session_set_cookie_params — Устанавливает параметры сессионной cookie

Описание

session_set_cookie_params ( int $lifetime_or_options , string|null $path = null , string|null $domain = null , bool|null $secure = null , bool|null $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.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 сессии

© 2008—2025 «phpm.ru | Документация и сервисы»       PHP | MySQL | Smarty | PEAR | PHP-GTK | Типограф | Сокращатель ссылок