session_cache_limiter

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

session_cache_limiterLee 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 correspondiente al último guardado de la sesión)
private_no_expire
Cache-Control: private, max-age=(session.cache_expire en el futuro)
Last-Modified: (el timestamp correspondiente al último guardado de la sesión)
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 correspondiente al último guardado de la sesión)
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