array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.session-cache-limiter.php', 1 => 'session_cache_limiter', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Fonctions Session', ), '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' => 'fr', '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 — Lit et/ou modifie le limiteur de cache de session
session_cache_limiter() retourne la configuration courante du limiteur de cache.
Le limiteur de cache contrôle les en-têtes HTTP envoyés au client.
Certains en-têtes déterminent les règles de mise en cache de la page
sur le navigateur. En configurant ce limiteur à nocache
,
par exemple, le navigateur ne mettra pas la page dans son cache. La valeur
public
, au contraire, permettra le cache. La valeur
private
désactive le cache pour le proxy et autorise le
client à mettre en cache le contenu.
En mode private
, l'en-tête Expire envoyé au client
peut poser des problèmes à certains navigateurs, comme, notamment,
Mozilla. Vous pouvez éviter ce problème avec le mode
private_no_expire
. L'en-tête Expire
n'est jamais envoyé au navigateur pour ce mode.
Le fait de définir le limiteur de cache à
la valeur ''
désactivera
automatiquement et totalement l'envoi des en-têtes de cache.
Le limiteur de cache est remis à la valeur par défaut de session.cache_limiter à chaque démarrage de script PHP. Donc, vous devrez appeler session_cache_limiter() à chaque page, et avant session_start().
value
Si value
est fourni et non null
,
le limiteur de cache est reconfiguré avec cette valeur.
Valeurs | Entêtes envoyés |
---|---|
public |
Expires: (Quelque chose dans le futur, suivant session.cache_expire) Cache-Control: public, max-age=(Quelque chose dans le futur, suivant session.cache_expire) Last-Modified: (le timestamp correspondant à la dernière sauvegarde de la session) |
private_no_expire |
Cache-Control: private, max-age=(session.cache_expire dans le futur), pre-check=(session.cache_expire dans le futur) Last-Modified: (le timestamp correspondant à la dernière sauvegarde de la session) |
private |
Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(session.cache_expire dans le futur), pre-check=(session.cache_expire dans le futur) Last-Modified: (le timestamp correspondant à la dernière sauvegarde de la session) |
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 |
Retourne le nom du limiteur de cache courant.
En cas d'échec, false
est retourné.
Version | Description |
---|---|
8.0.0 |
value est désormais nullable.
|
Exemple #1 Exemple avec session_cache_limiter()
<?php
/* configure le limiteur de cache à 'private' */
session_cache_limiter('private');
$cache_limiter = session_cache_limiter();
echo "Le limiteur de cache vaut maintenant $cache_limiter<br />";
?>