# 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

- 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

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