array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.session-id.php', 1 => 'session_id', 2 => 'Liefert und/oder setzt die aktuelle Session-ID', ), 'up' => array ( 0 => 'ref.session.php', 1 => 'Session-Funktionen', ), 'prev' => array ( 0 => 'function.session-get-cookie-params.php', 1 => 'session_get_cookie_params', ), 'next' => array ( 0 => 'function.session-module-name.php', 1 => 'session_module_name', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/session/functions/session-id.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

session_id

(PHP 4, PHP 5, PHP 7, PHP 8)

session_id — Liefert und/oder setzt die aktuelle Session-ID

Beschreibung

session_id(?string $id = null): string|false

session_id() wird verwendet, um die Session-ID der aktuellen Session zu erhalten oder zu setzen.

Die Konstante SID kann auch dazu verwendet werden, den aktuellen Namen und die Session-ID als Zeichenkette passend zum Anhängen an URLs zu erhalten. Siehe auch Session-Funktionen.

Parameter-Liste

id

Wenn id angegeben wird und nicht null ist, wird die aktuelle Session-ID ersetzt. session_id() muss zu diesem Zweck vor session_start() aufgerufen werden. In Abhängigkeit von der Session-Routine sind in der Session-ID nicht alle Zeichen erlaubt. Zum Beispiel erlaubt die dateibasierte Session-Routine nur Zeichen im Bereich [a-zA-Z0-9,-]!

Hinweis: Falls Session-Cookies verwendet werden und für session_id() eine id angegeben wird, wird ungeachtet dessen, ob die aktuelle Session-ID mit der neuen identisch ist, bei jedem Aufruf von session_start() ein neues Cookie gesendet.

Rückgabewerte

session_id() gibt die Session-ID der aktuellen Session zurück oder die leere Zeichenkette (""), falls es keine aktuelle Session gibt (es existiert keine aktuelle Session-ID). Bei Auftreten eines Fehlers wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 id ist jetzt nullable (akzeptiert den NULL-Wert).

Siehe auch