array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.session-cache-limiter.php', 1 => 'session_cache_limiter', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Funções para Sessão', ), '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' => 'pt_BR', 'path' => 'reference/session/functions/session-cache-limiter.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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
/* 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 />";
?>