• « session_save_path
  • session_set_save_handler »
  • PHP Manual
  • Session-Funktionen
  • Setzt die Session-Cookie-Parameter

session_set_cookie_params

(PHP 4, PHP 5, PHP 7)

session_set_cookie_params — Setzt die Session-Cookie-Parameter

Beschreibung

session_set_cookie_params ( int $lifetime [, string $path [, string $domain [, bool $secure = FALSE [, bool $httponly = FALSE ]]]] ) : bool
session_set_cookie_params ( array $options ) : bool

Setzen der Cookie-Parameter, die in der php.ini definiert sind. Diese Funktion wirkt sich nur für die Dauer des Scripts aus. Folglich müssen Sie session_set_cookie_params() bei jeder Anfrage und noch vor dem Aufruf von session_start() aufrufen.

Diese Funktion aktualisiert die Laufzeitwerte der zugehörigen Konfigurationsschlüssel, die mittels ini_get() abgefragt werden können.

Parameter-Liste

lifetime

Die Lebensdauer des Session-Cookies in Sekunden

path

Der Pfad der Domain, in dem das Cookie zu Verfügung steht. Mit einem einfachen Schrägstrich ('/') gilt es für alle Pfade der Domain.

domain

Die Cookie-Domain, z.B. 'www.php.net'. Damit die Cookies auf allen Subdomains zur Verfügung stehen, muss der Domain wie in '.php.net' ein Punkt vorangestellt werden.

secure

Falls auf TRUE gesetzt, wird das Cookie nur über sichere Verbindungen gesendet.

httponly

Falls auf TRUE gesetzt, versucht PHP das httponly-Flag zu senden wenn das Session-Cookie gesetzt wird.

options

Ein assoziatives Array, das die Schlüssel lifetime, path, domain, secure, httponly und samesite enthalten kann. Die Werte haben dieselbe Bedeutung wie für die gleichnamigen Parameter beschrieben. Der Wert des samesite Elements sollte entweder Lax oder Strict sein. Ist eine der erlaubten Optionen nicht angegeben, dann ist ihr Standardwert derselbe wie für den expliziten Parameter. Wird das samesite Element nicht angegeben, dann wird kein SameSite-Cookie-Attribute gesetzt.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
7.3.0 Eine alternative Signatur, die ein options Array unterstützt, wurde hinzugefügt. Diese Signatur unterstützt ebenfalls das Setzen des SameSite-Cookie-Attributs.
7.2.0 Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Zuvor gab die Funktion void zurück.
5.2.0 Den Parameter httponly hinzugefügt.

Siehe auch

  • session.cookie_lifetime
  • session.cookie_path
  • session.cookie_domain
  • session.cookie_secure
  • session.cookie_httponly
  • session.cookie_samesite
  • session_get_cookie_params() - Liefert die Session-Cookie Parameter