PHP Manual
Session-Funktionen
Liefert und/oder setzt die aktuelle Cacheverwaltung

session_cache_limiter

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

session_cache_limiter — Liefert und/oder setzt die aktuelle Cacheverwaltung

Beschreibung

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

session_cache_limiter() gibt die Bezeichnung der aktuellen Cacheverwaltung zurück.

Die Cacheverwaltung definiert, welche Cache-Kontroll-HTTP-Header, zum Client geschickt werden. Diese Header bestimmen die Regel, nach der der Seiteninhalt von Client und dazwischenliegenden Proxies in den Cachespeicher aufgenommen werden darf. Wird die Cacheverwaltung auf nocache gesetzt, so ist eine client-/proxyseitige Speicherung im Cache nicht erlaubt. Der Wert public erlaubt die Aufnahme in den Cachespeicher durch Proxies und den Client, wohingegen private Proxies die Speicherung im Cache verbietet und dem Client erlaubt, den Seiteninhalt im Cache zu speichern.

Im private-Modus könnte ein zum Client gesendeter Expire-Header manche Browser, inklusive Mozilla, verwirren. Sie können dieses Problem durch Verwendung des private_no_expire-Modus vermeiden. In diesem Modus wird nie ein Expire-Header zum Client gesendet.

Wenn die Cacheverwaltung auf '' gesetzt wird, werden überhaupt keine Cache-Header mehr automatisch gesendet.

Zu Beginn einer Anfrage wird die Cacheverwaltung auf den voreingestellten Wert zurückesetzt, der in session.cache_limiter gespeichert ist. Daher müssen Sie session_cache_limiter() bei jeder Anfrage aufrufen (und zwar bevor session_start() aufgerufen wird).

Parameter-Liste

value

Wenn value angegeben wurde und nicht null ist, wird die Cacheverwaltung dem neuen Wert entsprechend geändert.

**Mögliche Werte**
Wert	Gesendete Header
`public`	Expires: (entsprechend session.cache_expire irgendwann in der Zukunft) Cache-Control: public, max-age=(entsprechend session.cache_expire irgendwann in der Zukunft) Last-Modified: (der Zeitstempel der letzten Session-Speicherung)
`private_no_expire`	Cache-Control: private, max-age=(session.cache_expire in der Zukunft), pre-check=(session.cache_expire in der Zukunft) Last-Modified: (der Zeitstempel der letzten Session-Speicherung)
`private`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: private, max-age=(session.cache_expire in der Zukunft), pre-check=(session.cache_expire in der Zukunft) Last-Modified: (der Zeitstempel der letzten Session-Speicherung)
`nocache`	Expires: Thu, 19 Nov 1981 08:52:00 GMT Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0 Pragma: no-cache

Rückgabewerte

Gibt die Bezeichnung der aktuellen Cacheverwaltung zurück. Falls die Änderung des Werts fehlschlägt, wird false zurückgegeben.

Changelog

Version	Beschreibung
8.0.0	`value` ist jetzt ein Nullable-Typ.

Beispiele

Beispiel #1 session_cache_limiter()-Beispiel


<?php
/* setzen der Cacheverwaltung auf 'private' */
session_cache_limiter('private');
$cacheverwaltung = session_cache_limiter();
echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<br />";
?>