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

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