documentation/manual/fr/tutorials/multiuser-sessions.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20649 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="learning.multiuser.sessions">
   5     <title>Gérer les sessions dans ZF</title>
   6
   7     <sect2 id="learning.multiuser.sessions.intro">
   8         <title>Introduction aux sessions</title>
   9
  10         <para>
  11             Le succès du web est en grande partie dûe aux protocoles qui le supportent: HTTP. HTTP sur
  12             TCP est par nature sans état ce qui signifie que le web n'a pas "de mémoire". Ce fait
  13             pose des problèmes pour les développeurs voulant traiter leur application comme un
  14             service riche.
  15         </para>
  16
  17         <para>
  18             Interagir avec l'application web c'est en fait faire la somme de toutes les requêtes
  19             que celle-ci reçoit. Et comme il y a beaucoup de clients, il y a beaucoup de requête,
  20             et le moyen d'associer une requête à un client est appelé "session".
  21         </para>
  22
  23         <para>
  24             En PHP, le problème des sessions a été résolu au travers de l'extension session qui utilise
  25             un système de persistance, typiquement basé sur des cookies et un stockage local des variables
  26             dans $_SESSION. Dans Zend Framework, le composant Zend_Session ajoute de la valeur au système
  27             de session de PHP notamment une manipulation objet.
  28         </para>
  29
  30     </sect2>
  31
  32     <sect2 id="learning.multiuser.sessions.basic-usage">
  33         <title>Utilisation classique de Zend_Session</title>
  34
  35         <para>
  36             Le composant Zend_Session est un gestionnaire de session et une API pour stocker des données
  37             dans la session de manière objet. L'API de la classe Zend_Session API permet de régler des options
  38             et de démarrer/arrêter la session alors que Zend_Session_Namespace représente un objet
  39             contenant des données à stocker en session.
  40         </para>
  41
  42         <para>
  43             C'est générallement une bonne pratique que de démarrer sa session en bootstrap, cependant
  44             la première création d'un objet Zend_Session_Namespace démarrera la session par défaut.
  45         </para>
  46
  47         <para>
  48             Zend_Application peut permettre de configurer Zend_Session grâce aux parties
  49             Zend_Application_Resource. Pour les utiliser, en supposant que votre projet utilise
  50             Zend_Application, ajoutez le code suivant à application.ini:
  51         </para>
  52
  53         <programlisting language="php"><![CDATA[
  54 resources.session.save_path = APPLICATION_PATH "/../data/session"
  55 resources.session.use_only_cookies = true
  56 resources.session.remember_me_seconds = 864000
  57 ]]></programlisting>
  58
  59         <para>
  60             Comme vous le remarquez, les options utilisées sont les mêmes que celles que reconnait
  61             ext/session (l'extension session de PHP). Le chemin de stockage des session par exemple.
  62             Les fichiers ini peuvent utiliser des constantes, nous réutilisons APPLICATION_PATH
  63             pour calculer le chemin relatif vers un dossier arbitraire sensé stocker les sessions.
  64         </para>
  65
  66         <para>
  67             La plupart des composants de Zend Framework utilisant les sessions n'ont rien besoin de plus.
  68             Dès lors, vous pouvez utiliser un composant faisant appel à la session, ou manipuler la session
  69             vous-même au travers d'un ou plusieurs objets Zend_Session_Namespace.
  70         </para>
  71
  72         <para>
  73             Zend_Session_Namespace est une classe qui guide ses données vers $_SESSION. La classe s'appelle
  74             Zend_Session_Namespace car elle crée des espaces de noms au sein de $_SESSION, autorisant
  75             plusieurs composants ou objets à stocker des valeurs sans se marcher dessus. Nous allons voir
  76             dans l'exemple qui suit comment créer un simple compteur de session qui commence à 1000
  77             et se remet à zéro après 1999.
  78         </para>
  79
  80         <programlisting language="php"><![CDATA[
  81 $mysession = Zend_Session_Namespace('mysession');
  82
  83 if (!isset($mysession->counter)) {
  84     $mysession->counter = 1000;
  85 } else {
  86     $mysession->counter++;
  87 }
  88
  89 if ($mysession->counter > 1999) {
  90     unset($mysession->counter);
  91 }
  92 ]]></programlisting>
  93
  94         <para>
  95             Comme vous le remarquez, l'objet de session utilise les méthodes magiques __get, __set,
  96             __isset, et __unset pour proposer une API intuitive. Les informations stockées dans
  97             notre exemple le sont en réalité dans $_SESSION['mysession']['counter'].
  98         </para>
  99
 100     </sect2>
 101     <sect2 id="learning.multiuser.sessions.advanced-usage">
 102         <title>Utilisation avancée de Zend_Session</title>
 103
 104         <para>
 105             Si vous voulez utiliser le gestionnaire de sauvegarde des sessions "DbTable", vous
 106             pouvez simplement ajouter ces options à application.ini:
 107         </para>
 108
 109         <programlisting language="php"><![CDATA[
 110 resources.session.saveHandler.class = "Zend_Session_SaveHandler_DbTable"
 111 resources.session.saveHandler.options.name = "session"
 112 resources.session.saveHandler.options.primary.session_id = "session_id"
 113 resources.session.saveHandler.options.primary.save_path = "save_path"
 114 resources.session.saveHandler.options.primary.name = "name"
 115 resources.session.saveHandler.options.primaryAssignment.sessionId = "sessionId"
 116 resources.session.saveHandler.options.primaryAssignment.sessionSavePath = "sessionSavePath"
 117 resources.session.saveHandler.options.primaryAssignment.sessionName = "sessionName"
 118 resources.session.saveHandler.options.modifiedColumn = "modified"
 119 resources.session.saveHandler.options.dataColumn = "session_data"
 120 resources.session.saveHandler.options.lifetimeColumn = "lifetime"
 121 ]]></programlisting>
 122
 123
 124     </sect2>
 125
 126
 127 </sect1>