session_cache_limiter

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

session_cache_limiter — Lit et/ou modifie le limiteur de cache de session

Description

session_cache_limiter(?string $value = null): string|false

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. Il est possible d'é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, il faudra appeler session_cache_limiter() à chaque page, et avant session_start().

Liste de paramètres

value

Si value est fourni et non null, le limiteur de cache est reconfiguré avec cette valeur.

**Valeurs possibles**
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 du script courant)
`private_no_expire`	Cache-Control: private, max-age=(session.cache_expire dans le futur) Last-Modified: (le timestamp du script courant)
`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 du script courant)
`nocache`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate Pragma: no-cache

Valeurs de retour

Retourne le nom du limiteur de cache courant. En cas d'échec, false est retourné.

Historique

Version	Description
8.0.0	`value` est désormais nullable.

Exemples

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

Voir aussi

session.cache_limiter