array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.session-cache-limiter.php', 1 => 'session_cache_limiter', 2 => 'Получает и (или) устанавливает текущий ограничитель кеша', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Функции для работы с сессиями', ), 'prev' => array ( 0 => 'function.session-cache-expire.php', 1 => 'session_cache_expire', ), 'next' => array ( 0 => 'function.session-commit.php', 1 => 'session_commit', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/session/functions/session-cache-limiter.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

session_cache_limiter

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

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

Описание

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 />";

?>

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