PHP Conference Nagoya 2025

SessionHandler::read

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

SessionHandler::readRuft die Session-Daten ab

Beschreibung

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

Liest die Session-Daten aus dem Session-Speicher und gibt das Ergebnis zur internen Verarbeitung zurück an PHP. Diese Methode wird von PHP automatisch aufgerufen, wenn eine Session gestartet wird (entweder automatisch oder explizit mit der session_start()), und wird von einem internen Aufruf von SessionHandler::open() eingeleitet.

Diese Methode ist ein Wrapper für den in der INI-Einstellung session.save_handler definierten internen PHP-Speicherverwalter, der gesetzt wird, bevor er mittels session_set_save_handler() gesetzt wird.

Wenn diese Klasse durch Vererbung erweitert wird, wird durch den Aufruf der übergeordneten read-Methode der Wrapper für diese Methode und damit der zugehörige interne Callback aufgerufen. Dadurch kann diese Methode überschrieben und/oder abgefangen und gefiltert werden (z. B. um den von der übergeordneten read-Methode zurückgegebenen Wert des Parameters $data zu entschlüsseln).

Weitere Informationen darüber, welche Aufgaben diese Methode erfüllen soll, sind in der Dokumentation unter SessionHandlerInterface::read() zu finden.

Parameter-Liste

id

Die Session-ID, für die Daten gelesen werden sollen

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

add a note

User Contributed Notes 1 note

up
1
andrey at puhovsky dot com
1 year ago
Please note that you have to return false only for PHP 8+.

For the older versions you have to return an empty string, otherwise you will get an error 'Warning: session_start(): Failed to read session data: user (path: 127.0.0.1:9999)'
To Top