(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
session_cache_limiter — Obtém e/ou define o limitador do cache atual
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).
value
Se value
é especificado e não null
, o nome do limitador de cache atual é modificado para o novo valor.
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), pre-check=(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), pre-check=(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, post-check=0, pre-check=0 Pragma: no-cache |
Retorna o nome do limitador de cache atual. Caso não seja possível alterar o valor, false
é retornado.
Versão | Descrição |
---|---|
8.0.0 | value is nullable now. |
Exemplo #1 Exemplo de session_cache_limiter()
<?php
session_cache_limiter('private');
$cache_limiter = session_cache_limiter();
echo "O limitador do cache está definido agora para $cache_limiter<br />";
?>