set_cookie

Описание и параметры

CMain::set_cookie(
	string name, 
	string value,
	mixed time = false,
	string folder = "/",
	mixed domain = false,
	bool secure = false,
	bool spread = true,
	mixed name_prefix = false,
	httpOnly=false
)

Устанавливает cookie и при необходимости запоминает параметры установленного cookie для дальнейшего распространения по сайтам с разными доменными именами. Нестатический метод.

Чтобы cookie, установленная на сайте site1.ru, была доступна и на сайте site2.ru в рамках многосайтовости, в настройках браузера должно быть разрешено использование сторонних файлов cookie. Например, в Chrome это настройка «Разрешить использование сторонних файлов cookie». Если же включена опция «Блокировать сторонние файлы cookie», то cookie с site1.ru не будет доступна на site2.ru.

Параметры

Параметр	Описание	С версии
name	Имя cookie переменной.
value	Значение cookie переменной.
time	Дата в Unix-формате после которой cookie будет считаться истекшим и его значение не будет передаваться от посетителя на сайт. Необязательный. По умолчанию - cookie устанавливается сроком на 1 год.
folder	Каталог веб-сайта для которого cookie будет действителен. Необязательный. По умолчанию - весь сайт.
domain	Домен для которого cookie будет действительным. Необязательный. По умолчанию - текущий сайт.
secure	Флаг secure для устанавливаемого cookie. Если значение "true", то будет установлен как "защищенный", т.е. его значение будет возвращаться на сайт только если посетитель зашел на сайт по протоколу HTTPS. Необязательный. По умолчанию - "false".
spread	Если значение "true", то параметры установленного cookie будут запоминаться для дальнейшего его распространения по доменам (административное меню "Сайты", в настройках сайта - поле "Доменное имя").
name_prefix	Префикс имени переменной cookie. Необязательный. По умолчанию - значение параметра "Имя префикса для названия cookies" в настройках главного модуля (значение данного параметра можно получить с помощью метода: COption::GetOptionString("main", "cookie_name", "BITRIX_SM")
httpOnly	Необязательный. По умолчанию - "false".	14.0.1

Смотрите также

Примеры использования

<?
global $APPLICATION;
// устновим cookie на 2 года, действительного только для каталога /ru/
$APPLICATION->set_cookie("RUSSIAN_VISITOR_ID", 156, time()+60*60*24*30*12*2, "/ru/");
?>