Raccourcis : Contenu - rubriques - sous rubriques
EN FR

jSession est utilisé par Jelix pour la gestion du stockage des sessions. Cet objet n'est pas utilisé pour lire ou écrire des variables en session. Pour faire ceci, utilisez $_SESSION comme d'habitude.

Les paramètres du moteur de stockage de la session sont indiqués dans la section sessions du fichier de configuration app/var/config/mainconfig.ini.php.

Nom de la session

Pour diverses raisons, on peut vouloir changer le nom de la session (par défaut, c'est PHPSESSID). Pour changer ce nom de variable/cookie, on peut utiliser la configuration suivante :


[sessions]
name = "masession"

NB : seuls les caractères alpha-numériques sont autorisés.

Stockage dans un répertoire

Il n'est pas toujours prudent de stocker les sessions dans le répertoire par défaut prévu par l'hébergeur, car celui-ci peut être accessible de tout le monde, comme /tmp/ par exemple.

Pour utiliser jSession avec un répertoire personnalisé :


  [sessions]
  storage = "files"
  files_path = "app:var/sessions/"

NB : les mots clés app: et lib: sont reconnus.

Stockage dans la base de données

On peut avoir besoin de stocker les données de session en base de données, par exemple pour permettre un partage aisé en cas de répartition de charge entre plusieurs serveurs web.

Pour utiliser jSession avec un Dao :


  [sessions]
  storage = "dao"
  dao_selector = "jelix~jsession"
  dao_db_profile = ""

Un dao est fourni par défaut dans le module jelix, son sélecteur est : jelix~jsession.

Jelix créé automatiquement la table correspondante quand vous installez votre application et que la configuration dans la section sessions est faite.

En cours de développement, vous pouvez exécuter l'un des scripts SQL lib/jelix/core-modules/jelix/install/sql/install_jsession.schema.*.

Concrètement, la table installée sera celle-ci :


CREATE TABLE  IF NOT EXISTS `jsessions` (
  `id` varchar(64) NOT NULL,
  `creation` datetime NOT NULL,
  `access` datetime NOT NULL,
  `data` longblob NOT NULL,
  PRIMARY KEY  (`id`)
) DEFAULT CHARSET=utf8;