(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) 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) 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 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 />";
?>