session_cache_limiter

(PHP 4 >= 4.0.3, PHP 5, PHP 7)

session_cache_limiterПолучить и/или установить текущий режим кеширования

Описание

session_cache_limiter ( string|null $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 в будущем), pre-check=(session.cache_expire в будущем)
Last-Modified: (временная метка последнего сохранения сессии)
private
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: private, max-age=(session.cache_expire в будущем), pre-check=(session.cache_expire в будущем)
Last-Modified: (временная метка последнего сохранения сессии)
nocache
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
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 />";
?>

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