# 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)
      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)
      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
      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 />";
?>`

### Siehe auch

- session.cache_limiter

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