Obtém e/ou define o limitador do cache atual

Descrição

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

session_cache_limiter() retorna o nome do atual limitador do cache.

O limitador do cache controla quais HTTP headers de controle de cache são enviados para o cliente. Estes headers determinam as regras pelas quais o conteúdo da página pode ser guardado em cache pelo cliente e proxy intermediário. Definindo o limitador do cache para nocache rejeitaria qualquer cache do cliente/proxy. Um valor como public permitiria o cache do proxy e do cliente, e private rejeitaria o cache do proxy mas permite que o cliente armazene o conteúdo em cache.

No modo private, o cabeçalho Expire enviado para o cliente pode provocar confusão em alguns browsers, incluindo o Mozilla. Você pode evitar este problema usando o modo private_no_expire. O cabeçalho Expire nunca é enviado para o cliente nesse modo.

Definindo o limitador do cache como '' desativará completamente o envio automático de cabeçalhos de cache.

O limitador do cache é redefinido para o valor padrão guardado em session.cache_limiter na inicialização da requisição. Então você precisa chamar session_cache_limiter() para cada requisição (e antes que session_start() seja chamada).

Parâmetros

value

Se value é especificado e não null, o nome do limitador de cache atual é modificado para o novo valor.

**Valores possíveis**
Valor	Cabeçalhos enviados
`public`	Expires: (em algum momento do futuro, de acordo com session.cache_expire) Cache-Control: public, max-age=(em algum momento do futuro, de acordo com session.cache_expire) Last-Modified: (o timestamp de quando a sessão foi salva pela última vez)
`private_no_expire`	Cache-Control: private, max-age=(session.cache_expire no futuro) Last-Modified: (o timestamp de quando a sessão foi salva pela última vez)
`private`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(session.cache_expire no futuro) Last-Modified: (o timestamp de quando a sessão foi salva pela última vez)
`nocache`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate Pragma: no-cache

Valor Retornado

Retorna o nome do limitador de cache atual. Caso não seja possível alterar o valor, false é retornado.

Registro de Alterações

Versão	Descrição
8.0.0	`value` is nullable now.

Exemplos

Example #1 Exemplo de session_cache_limiter()

<?php

/* define o limitador do cache para 'private' */

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

echo "O limitador do cache está definido agora para $cache_limiter<br />";
?>

Veja Também

session.cache_limiter