array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'sessionhandlerinterface.read.php', 1 => 'SessionHandlerInterface::read', 2 => 'Ruft die Session-Daten ab', ), 'up' => array ( 0 => 'class.sessionhandlerinterface.php', 1 => 'SessionHandlerInterface', ), 'prev' => array ( 0 => 'sessionhandlerinterface.open.php', 1 => 'SessionHandlerInterface::open', ), 'next' => array ( 0 => 'sessionhandlerinterface.write.php', 1 => 'SessionHandlerInterface::write', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/session/sessionhandlerinterface/read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SessionHandlerInterface::read

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SessionHandlerInterface::read — Ruft die Session-Daten ab

Beschreibung

public SessionHandlerInterface::read(string $id): string|false

Liest die Session-Daten aus dem Session-Speicher und gibt das Ergebnis zurück. Diese Methode wird direkt nach dem Start einer Session aufgerufen oder wenn session_start() aufgerufen wird. Es ist zu beachten, dass vor dem Aufruf dieser Methode SessionHandlerInterface::open() aufgerufen wird.

Diese Methode wird von PHP selbst aufgerufen, wenn eine Session gestartet wird. Sie soll die Session-Daten anhand der angegebenen Session-ID aus dem Speicher abrufen. Die von dieser Methode zurückgegebene Zeichenkette muss dasselbe serialisierte Format haben wie die ursprünglich an die SessionHandlerInterface::write() übergebene Zeichenkette. Wenn der Datensatz nicht gefunden werden konnte, wird false zurückgegeben.

Die von dieser Methode zurückgegebenen Daten werden von PHP intern dekodiert, indem die in session.serialize_handler angegebene Methode zur Deserialisierung verwendet wird. Mit den daraus resultierenden Daten wird die Superglobale $_SESSION gefüllt.

Zu beachten ist, dass das Serialisierungsverfahren nicht dasselbe ist wie bei unserialize() und mittels session_decode() aufgerufen werden kann.

Parameter-Liste

id

Die Session-ID

Rückgabewerte

Gibt eine kodierte Zeichenkette der gelesenen Daten zurück. Wurde nichts gelesen, wird false zurückgegeben. Zu beachten ist, dass dieser Wert intern zur Verarbeitung an PHP zurückgegeben wird.

Siehe auch