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
$value = null): string|falsesession_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
valueangegeben wurde und nichtnullist, wird die Cacheverwaltung dem neuen Wert entsprechend geändert.Mögliche Werte Wert Gesendete Header publicExpires: (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_expireCache-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)privateExpires: 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)nocacheExpires: 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 />";
?>
