Получает и (или) устанавливает текущий ограничитель кеша

Описание

session_cache_limiter(?string $value = null): string|false

Функция session_cache_limiter() возвращает имя текущего ограничителя кеша.

Режим кеширования определяет, какие HTTP-заголовки управления кешем посылать клиенту. Эти заголовки определяют, какими правилами кеширования контента должны руководствоваться клиент и промежуточные прокси. Установка ограничителя в значение nocache запрещает любое кеширование. Значение public разрешает кеширование как на стороне клиента, так и на прокси-серверах. Значение private запрещает кеширование прокси-серверам, но разрешает клиенту.

Отправка заголовка Expire в режиме private приводит отдельные браузеры, включая Mozilla, в замешательство. Проблему обходят через режим private_no_expire. В этом режиме функция не отправляет заголовок Expire.

Установка для режима кеширования значения '' отключает автоматическую отправку кеш-заголовков.

При запуске запроса режим кеширования сбрасывается до значения по умолчанию, которое хранится в директиве session.cache_limiter. Поэтому вызывать функцию session_cache_limiter() необходимо для каждого запроса перед вызовом функции session_start().

Список параметров

value

Если в парламент value передали значение, которое не равно null, имя текущего режима кеширования изменяется на новое значение.

**Возможные значения**
Значение	Посылаемый заголовок
`public`	Expires: (когда-нибудь в будущем, в зависимости от значения директивы session.cache_expire) Cache-Control: public, max-age=(когда-нибудь в будущем, в зависимости от значения директивы session.cache_expire) Last-Modified: (временная метка последнего сохранения сессии)
`private_no_expire`	Cache-Control: private, max-age=(количество минут директивы session.cache_expire в будущем) Last-Modified: (метка времени последнего сохранения сессии)
`private`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(количество минут директивы session.cache_expire в будущем) Last-Modified: (временная метка последнего сохранения сессии)
`nocache`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate Pragma: no-cache

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

Функция возвращает имя текущего ограничителя кеша. Функция возвращает false, если функция не смогла изменить значение.

Список изменений

Версия	Описание
8.0.0	Параметр `value` теперь принимает значение `null`.

Примеры

Пример #1 Пример использования функции session_cache_limiter()

<?php

/* Устанавливаем для ограничителя кеша значение 'private' */

session_cache_limiter('private');
$cache_limiter = session_cache_limiter();

echo "Режим кеширования установлен в переменной $cache_limiter<br />";

?>

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

session.cache_limiter