LIBSESSION

Description

Cette librairie implémente une session sous PHP3.

Fonctionnement

La session permet d'utiliser des variables persistantes ( stockées coté serveur entre les appels de pages ). Pour l'utiliser, il suffit d'inclure la librairie en debut de page.

La librairie crée un tableau associatif $Session. Les variables a faire persister doivent etre stockées dans celui-ci. En fin de page, un appel a Session_Save() permet de sauvegarder la session.

Note: libSession utilise un cookie pour propager la session.

Installation

Dowload : libsession.zip

Contenu :

libSession.php3 le programme source de la librairie.

libsession_fr.html cette documentation

Configuration

Dans le fichier LibSession.php3, configurer $SESSION_PATH : Repertoire temporaire ou sont stockées les sessions.

Important: ce repertoire ne doit pas etre accessible en lecture du web.

	$SESSION_PATH= '/tmp/'; // Exemple pour UNIX
	$SESSION_PATH= 'D:\\tmp\\'; // Exemple pour Win32

Synopsis

	include "libSession.php3";
	...
	// stockage d'un scalaire
	$Session['mavariable']= "TOTO";

	// stockage d'un tablo
	$tablo= array( "value1", "value2", "value3" );
	$Session['tablo']= $tablo;
	...
	// saving de la session
	Session_Save();

Fonctions

Session_Save

Sauvegarde de la session. A appeller de préférence en fin de page.

Syntaxe

Session_Save()

Session_TimeOut

Defini ou renvoie le timeout de session, exprimé en minutes. Apres $timeout minutes d'inactivité, la session est fermée automatiquement. Valeur par defaut : 10080 (soit 7 jours).

Syntaxe

pour definir le timeout: Session_TimeOut( $timeout );

pour connaitre la valeur de timeout actuelle: $timeout = Session_TimeOut();

	Session_SetTimeout( 120 ); // defini un timeout de 120 minutes
	echo "Le Timeout vaut: ", Session_SetTimeout(), " minutes"; // affiche le timeout de session