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

# session_cache_limiter

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

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

### Описание

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open