(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) 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 |
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 agora pode ser nulo.
|
Exemplo #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 />";
?>