array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'sessionhandlerinterface.read.php', 1 => 'SessionHandlerInterface::read', 2 => 'Lit les données de session', ), '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' => 'fr', '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 — Lit les données de session

Description

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

Lit les données de session depuis le support de stockage et retourne le résultat. Appelé juste après que la session démarre ou lorsque session_start() est appelée. Notez qu'avant que cette méthode ne soit appelée, SessionHandlerInterface::open() est invoquée.

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 devrait être encodée par le même mécanisme de sérialisation que celui utilisé pour écrire les données lors de SessionHandlerInterface::write(). Si rien n'est lu, une chaîne vide est retournée.

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. Si rien n'est lu false doit être retourné. Il est à noter que cette valeur est destinée aux processus internes à PHP.

Voir aussi