8.117 Sessions
8 Référence des fonctions
Manuel PHP
. Introduction
. Sessions et sécurité
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Exemples
. Passer l'identifiant de session (session ID)
. Gestion personnalisée des sessions
. session_cache_expire
. session_cache_limiter
. session_commit
. session_decode
. session_destroy
. session_encode
. session_get_cookie_params
. session_id
. session_is_registered
. session_module_name
. session_name
. session_regenerate_id
. session_register
. session_save_path
. session_set_cookie_params
->session_set_save_handler
. session_start
. session_unregister
. session_unset
. session_write_close
|
8.117.26 session_set_save_handler()
Configure les fonctions de stockage de sessions
[ Exemples avec session_set_save_handler ] PHP 4, PHP 5
bool
session_set_save_handler (
string
open
,
string
close
,
string
read
,
string
write
,
string
destroy
,
string
gc
)
session_set_save_handler
configure les fonctions
de stockage de sessions, et permet de choisir des fonctions utilisateurs
pour sauver et relire toutes les sessions. Cette fonction est
très pratique lorsqu'il faut sauver les données de sessions
en utilisant une autre technique que le système par fichier fourni
par défaut : notamment, stockage en base de données ou dans des
démons tels
SRM
.
Cette fonction retourne
TRUE
en cas de
succès,
FALSE
en cas d'échec.
| Note | |
Le gestionnaire d'écriture n'est pas exécuté tant que le
flot de sortie est ouvert. Par conséquent, l'affichage
de messages de débogage durant le gestionnaire d'écriture
ne sera donc jamais visible depuis le navigateur. Si vous
avez besoin de débogage, nous vous suggérons d'écrire
vos messages dans un fichier.
|
L'exemple suivant fournit un exemple de stockage des sessions
semblable au système par défaut (par fichiers).
Cet exemple peut facilement être adapté pour réaliser des
sauvegardes en base de données, avec votre serveur préféré.
La fonction de lecture doit toujours retourner une chaîne,
pour que le gestionnaire fonctionne comme prévu. Vous devez
retourner une chaîne vide s'il n'y a pas de données à lire.
Les valeurs retournées par les autres gestionnaires sont
converties en booléen avant d'être retournées au script.
TRUE
pour la réussite,
FALSE
pour l'échec.
| Attention | |
Les gestionnaires d'écriture et de fermeture sont appelés après la destruction
des objets depuis PHP 5.0.5. Ces destructeurs peuvent utiliser les sessions
mais le gestionnaire de session ne peut pas utiliser les objets. Dans les versions
antérieures, ils étaient appelés dans l'ordre inverse. Il est possible d'appeler
session_write_close
depuis le destructeur pour résoudre
ce problème.
|
| Exemple avec session_set_save_handler |
<?php
function open ($save_path, $session_name) {
global $sess_save_path, $sess_session_name;
$sess_save_path = $save_path;
$sess_session_name = $session_name;
return(true);
}
function close() {
return(true);
}
function read ($id) {
global $sess_save_path, $sess_session_name;
$sess_file = "$sess_save_path/sess_$id";
if ($fp = @fopen($sess_file, "r")) {
$sess_data = fread($fp, filesize($sess_file));
return($sess_data);
} else {
return(""); // Doit retourner "" ici.
}
}
function write ($id, $sess_data) {
global $sess_save_path, $sess_session_name;
$sess_file = "$sess_save_path/sess_$id";
if ($fp = @fopen($sess_file, "w")) {
return(fwrite($fp, $sess_data));
} else {
return(false);
}
}
function destroy ($id) {
global $sess_save_path, $sess_session_name;
$sess_file = "$sess_save_path/sess_$id";
return(@unlink($sess_file));
}
/*******************************************************
* ATTENTION - Vous devrez implémenter un *
* collecteur de données obosolètes ici. *
*******************************************************/
function gc ($maxlifetime) {
return true;
}
session_set_save_handler ("open", "close", "read", "write", "destroy", "gc");
session_start();
// Utilisez vos sessions comme d'habitude
?>
|
Voir aussi la directive de configuration
session.save_handler
.
|
