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

Описание

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

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

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

Если в режиме private послать заголовок Expire, то это может привести некоторые браузеры, включая 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