Lit et/ou modifie le limiteur de cache de session

# 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

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open