# 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. 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().

### 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 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

### 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