Lee y/o modifica el limitador de caché de sesión

# session_cache_limiter

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

session_cache_limiter — Lee y/o modifica el limitador de caché de sesión

### Descripción

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

session_cache_limiter() devuelve la configuración actual del limitador de caché.

El limitador de caché controla los encabezados HTTP enviados al cliente. Algunos encabezados determinan las reglas de almacenamiento en caché de la página en el navegador. Al configurar este limitador a `nocache`, por ejemplo, el navegador no almacenará la página en su caché. El valor `public`, en cambio, permitirá el almacenamiento en caché. El valor `private` desactiva la caché para el proxy y autoriza al cliente a almacenar en caché el contenido.

En modo `private`, el encabezado Expire enviado al cliente puede causar problemas en algunos navegadores, como, por ejemplo, Mozilla. Este problema puede evitarse con el modo `private_no_expire`. El encabezado `Expire` nunca se envía al navegador para este modo.

El hecho de definir el limitador de caché a la valor `''` desactivará automáticamente y por completo el envío de los encabezados de caché.

El limitador de caché se restablece al valor por defecto de session.cache_limiter en cada inicio de script PHP. Por lo tanto, deberá llamarse a session_cache_limiter() en cada página, y antes de session_start().

### Parámetros

`value`

  Si `value` se proporciona y no es `null`, el limitador de caché se reconfigura con este valor.

  Valores posibles
  Valores | Encabezados enviados
  --- | ---
  `public` |
      Expires: (Algo en el futuro, según session.cache_expire)
      Cache-Control: public, max-age=(Algo en el futuro, según session.cache_expire)
      Last-Modified: (el timestamp del script actual)
  `private_no_expire` |
      Cache-Control: private, max-age=(session.cache_expire en el futuro)
      Last-Modified: (el timestamp del script actual)
  `private` |
      Expires: Thu, 19 Nov 1981 08:52:00 GMT
      Cache-Control: private, max-age=(session.cache_expire en el futuro)
      Last-Modified: (el timestamp del script actual)
  `nocache` |
      Expires: Thu, 19 Nov 1981 08:52:00 GMT
      Cache-Control: no-store, no-cache, must-revalidate
      Pragma: no-cache

### Valores devueltos

Devuelve el nombre del limitador de caché actual. En caso de error, se devuelve `false`.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `value` ahora es nullable.

### Ejemplos

Ejemplo #1 Ejemplo con session_cache_limiter()

    <?php

    /* configura el limitador de caché a 'private' */

    session_cache_limiter('private');
    $cache_limiter = session_cache_limiter();

    echo "El limitador de caché ahora vale $cache_limiter<br />";
    ?>

### Ver también

- session.cache_limiter

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