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

session_name

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

session_name — Liefert und/oder setzt den Namen der aktuellen Session

Beschreibung

session_name(?string $name = null): string|false

session_name() gibt den Namen der aktuellen Session zurück. Falls name angegeben wurde, aktualisiert session_name() den Namen der Session und gibt den alten Namen der Session zurück.

Wird ein neuer Session-Name (name) angegeben, ändert session_name() das HTTP-Cookie (und gibt den Inhalt aus, wenn session.use_trans_sid aktiviert ist). Nachdem das HTTP-Cookie gesendet wurde, erzeugt session_name() ein E_WARNING. session_name() muss vor session_start() aufgerufen werden, damit die Session ordnungsgemäß funktioniert.

Der Session-Name wird auf den Ausgangswert zurückgesetzt, der zu Beginn in session.name gespeichert wurde. Deshalb muss session_name() bei jeder Anfrage aufgerufen werden (und bevor session_start() aufgerufen wurde).

Parameter-Liste

name

Der Session-Name referenziert den Namen der Session, der in Cookies und URLs verwendet wird (z. B. PHPSESSID). Er sollte nur alphanumerische Zeichen enthalten und sollte kurz und beschreibend sein (z. B. für Benutzer mit aktivierter Cookie-Warnung). Wenn name angegeben wird und nicht null ist, wird der Name der aktuellen Session durch dessen Wert ersetzt.

Warnung

Der Session-Name darf nicht nur aus Zahlen bestehen, sondern muss mindestens einen Buchstaben enthalten. Andernfalls wird jedesmal eine neue Session-ID erzeugt.

Rückgabewerte

Gibt den Namen der aktuellen Session zurück. Wird name übergegeben und die Funktion aktualisiert den Session-Namen, wird der Name der alten Session zurückgegeben. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 name ist jetzt nullable (akzeptiert den NULL-Wert).
7.2.0 session_name() prüft den Session-Status; zuvor wurde nur der Cookie-Status geprüft. Somit war es zuvor möglich, dass session_name() nach session_start() aufgerufen wurde, was möglicherweise zum Absturz von PHP und zu anderem Fehlverhalten führen konnte.

Beispiele

Beispiel #1 session_name()-Beispiel

<?php
/* den Session-Namen auf WebsiteID setzen */
$name_vorher = session_name ("WebsiteID");
echo "Der vorhergehende Session-Name war $name_vorher<br />";
?>

Siehe auch