(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
session_cache_limiter — Lit et/ou modifie le limiteur de cache de session
$value
= null
): string|falsesession_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 />";
?>