SessionHandler::write

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

SessionHandler::write — Écrit des données dans la session

Description

public function SessionHandler::write(string $id, string $data): bool

Écrit les données de session vers le support de stockage. Cette fonction est appelée par la fonction session_write_close(), lorsque la fonction session_register_shutdown() échoue, et durant le processus d'arrêt. PHP va appeler SessionHandler::close() juste après cette fonction.

Cette méthode se substitue au gestionnaire interne de sauvegarde de PHP, défini via l'option de configuration session.save_handler qui a été définie avant que ce gestionnaire ne soit modifié via la fonction session_set_save_handler().

Si cette classe est étendue par héritage, l'appel de la méthode parente write invoquera ce gestionnaire pour cette méthode, mais aussi, la fonction de rappel interne associée. Ce mécanisme permet à cette méthode de surcharger, intercepter et/ou filtrer les données (par exemple, crypter la valeur du paramètre data avant de l'envoyer à la méthode parente write).

Pour plus d'informations sur l'attendu de cette méthode, se référer à la documentation sur la fonction SessionHandlerInterface::write().

Liste de paramètres

id

L'ID de session.

data

Les données de session, encodées. Les données sont le résultat de l'encodage de $_SESSION en une chaîne sérialisée avec un algorithme spécial.

Valeurs de retour

La valeur retournée (habituellement true en cas de succès, false si une erreur survient). Il est à noter que cette valeur est retournée en interne à PHP pour analyse.

Voir aussi