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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21826 -->
   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     </sect2>
  30
  31     <sect2 id="learning.multiuser.sessions.basic-usage">
  32         <title>Utilisation classique de Zend_Session</title>
  33
  34         <para>
  35             Le composant Zend_Session est un gestionnaire de session et une API pour stocker des données
  36             dans la session de manière objet. L'API de la classe Zend_Session API permet de régler des options
  37             et de démarrer/arrêter la session alors que Zend_Session_Namespace représente un objet
  38             contenant des données à stocker en session.
  39         </para>
  40
  41         <para>
  42             C'est générallement une bonne pratique que de démarrer sa session en bootstrap, cependant
  43             la première création d'un objet Zend_Session_Namespace démarrera la session par défaut.
  44         </para>
  45
  46         <para>
  47             Zend_Application peut permettre de configurer Zend_Session grâce aux parties
  48             Zend_Application_Resource. Pour les utiliser, en supposant que votre projet utilise
  49             Zend_Application, ajoutez le code suivant à application.ini:
  50         </para>
  51
  52         <programlisting language="php"><![CDATA[
  53 resources.session.save_path = APPLICATION_PATH "/../data/session"
  54 resources.session.use_only_cookies = true
  55 resources.session.remember_me_seconds = 864000
  56 ]]></programlisting>
  57
  58         <para>
  59             Comme vous le remarquez, les options utilisées sont les mêmes que celles que reconnait
  60             ext/session (l'extension session de PHP). Le chemin de stockage des session par exemple.
  61             Les fichiers ini peuvent utiliser des constantes, nous réutilisons APPLICATION_PATH
  62             pour calculer le chemin relatif vers un dossier arbitraire sensé stocker les sessions.
  63         </para>
  64
  65         <para>
  66             La plupart des composants de Zend Framework utilisant les sessions n'ont rien besoin de plus.
  67             Dès lors, vous pouvez utiliser un composant faisant appel à la session, ou manipuler la session
  68             vous-même au travers d'un ou plusieurs objets Zend_Session_Namespace.
  69         </para>
  70
  71         <para>
  72             Zend_Session_Namespace est une classe qui guide ses données vers $_SESSION. La classe s'appelle
  73             Zend_Session_Namespace car elle crée des espaces de noms au sein de $_SESSION, autorisant
  74             plusieurs composants ou objets à stocker des valeurs sans se marcher dessus. Nous allons voir
  75             dans l'exemple qui suit comment créer un simple compteur de session qui commence à 1000
  76             et se remet à zéro après 1999.
  77         </para>
  78
  79         <programlisting language="php"><![CDATA[
  80 $mysession = new Zend_Session_Namespace('mysession');
  81
  82 if (!isset($mysession->counter)) {
  83     $mysession->counter = 1000;
  84 } else {
  85     $mysession->counter++;
  86 }
  87
  88 if ($mysession->counter > 1999) {
  89     unset($mysession->counter);
  90 }
  91 ]]></programlisting>
  92
  93         <para>
  94             Comme vous le remarquez, l'objet de session utilise les méthodes magiques __get, __set,
  95             __isset, et __unset pour proposer une API intuitive. Les informations stockées dans
  96             notre exemple le sont en réalité dans $_SESSION['mysession']['counter'].
  97         </para>
  98     </sect2>
  99
 100     <sect2 id="learning.multiuser.sessions.advanced-usage">
 101         <title>Utilisation avancée de Zend_Session</title>
 102
 103         <para>
 104             Si vous voulez utiliser le gestionnaire de sauvegarde des sessions "DbTable", vous
 105             pouvez simplement ajouter ces options à application.ini:
 106         </para>
 107
 108         <programlisting language="php"><![CDATA[
 109 resources.session.saveHandler.class = "Zend_Session_SaveHandler_DbTable"
 110 resources.session.saveHandler.options.name = "session"
 111 resources.session.saveHandler.options.primary.session_id = "session_id"
 112 resources.session.saveHandler.options.primary.save_path = "save_path"
 113 resources.session.saveHandler.options.primary.name = "name"
 114 resources.session.saveHandler.options.primaryAssignment.sessionId = "sessionId"
 115 resources.session.saveHandler.options.primaryAssignment.sessionSavePath = "sessionSavePath"
 116 resources.session.saveHandler.options.primaryAssignment.sessionName = "sessionName"
 117 resources.session.saveHandler.options.modifiedColumn = "modified"
 118 resources.session.saveHandler.options.dataColumn = "session_data"
 119 resources.session.saveHandler.options.lifetimeColumn = "lifetime"
 120 ]]></programlisting>
 121     </sect2>
 122 </sect1>