setSameSite

self public
\Bitrix\Main\Web\Cookie::setSameSite(
	?string $sameSite
);

Метод задает значение атрибута SameSite cookie. Класс наследует метод от \Bitrix\Main\Web\Http\Cookie. Нестатический метод.

Параметры

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

Параметр	Описание
`$sameSite`	Значение атрибута: `Cookie::SAME_SITE_NONE` со значением `None` — не ограничивает межсайтовую отправку cookie атрибутом `SameSite`. Для этого режима браузер требует атрибут `Secure`. `Cookie::SAME_SITE_LAX` со значением `Lax` — разрешает отправку для запросов с того же сайта и при переходах верхнего уровня с других сайтов безопасными HTTP-методами. `Cookie::SAME_SITE_STRICT` со значением `Strict` — разрешает отправку только для запросов с того же сайта. `null` — не добавляет атрибут к cookie. Метод принимает любую строку без проверки и нормализации. Для стандартных режимов подходят константы класса. При значении `Cookie::SAME_SITE_NONE` метод не включает `Secure` автоматически

$sameSite

Значение атрибута:

Cookie::SAME_SITE_NONE со значением None — не ограничивает межсайтовую отправку cookie атрибутом SameSite. Для этого режима браузер требует атрибут Secure.
Cookie::SAME_SITE_LAX со значением Lax — разрешает отправку для запросов с того же сайта и при переходах верхнего уровня с других сайтов безопасными HTTP-методами.
Cookie::SAME_SITE_STRICT со значением Strict — разрешает отправку только для запросов с того же сайта.
null — не добавляет атрибут к cookie.

Метод принимает любую строку без проверки и нормализации. Для стандартных режимов подходят константы класса. При значении Cookie::SAME_SITE_NONE метод не включает Secure автоматически

Возвращаемое значение

Метод возвращает текущий объект cookie и позволяет продолжить цепочку вызовов.

Пример

<?php
use Bitrix\Main\Context;
use Bitrix\Main\Web\Cookie;

$cookie = new Cookie('PREFERRED_LANGUAGE', 'ru');
$cookie->setSameSite(Cookie::SAME_SITE_LAX);
Context::getCurrent()->getResponse()->addCookie($cookie);

echo $cookie->getSameSite();

Пользовательские комментарии

Помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх