session_id
(PHP 4, PHP 5, PHP 7, PHP 8)
session_id — Liefert und/oder setzt die aktuelle Session-ID
Beschreibung
$id = null): string|falsesession_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
idangegeben wird und nichtnullist, 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 Bereicha-z A-Z 0-9 , (Komma) und - (Minus)!Hinweis: Falls Session-Cookies verwendet werden und für session_id() eine
idangegeben 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
- session_regenerate_id() - Ersetzt die aktuelle Session-ID durch eine neu erzeugte
- session_start() - Erzeugt eine neue Session oder setzt eine vorhandene fort
- session_set_save_handler() - Setzt benutzerdefinierte Session-Speicherfunktionen
- session.save_handler
