SessionHandlerInterface::read
(PHP 5 >= 5.4.0, PHP 7, PHP 8)
SessionHandlerInterface::read — Lit les données de session
Description
Cette méthode est appelée par PHP lui-même lorsque la session démarre. Cette méthode devrait
retourner les données de session lues depuis le support de stockage en fonction de l'ID de
session. La chaîne retournée doit être encodée par le même mécanisme de sérialisation que
celui utilisé pour écrire les données lors de SessionHandlerInterface::write().
Retourner une chaîne vide lorsqu'aucune donnée n'est stockée pour l'ID de session donné ;
retourner false uniquement pour signaler un échec.
Les données retournées par cette méthode seront décodées en interne par PHP en utilisant le
mécanisme de désérialisation spécifié dans
session.serialize_handler. Les données
résultantes seront utilisées pour peupler $_SESSION.
Il est à noter que l'algorithme de sérialisation peut être différent de unserialize()
et peut être utilisé manuellement au moyen de session_decode().
Liste de paramètres
id
-
L'identifiant de session.
Valeurs de retour
Retourne les données lues encodées,
ou une chaîne vide si aucune donnée n'est stockée pour l'ID de session.
Retourner false signale un échec :
session_start() émet alors un E_WARNING et retourne false.
Il est à noter que cette valeur est destinée aux processus internes à PHP.