1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.session.basic_usage">
<title>Usage basique</title>
<para>
Les instances <classname>Zend_Session_Namespace</classname> fournissent l'API primaire
pour manipuler les données de session dans Zend Framework. Les espaces de noms sont utilisés
pour isoler toutes les données de session, bien qu'un espace de noms par défaut existe pour
ceux qui veulent juste un endroit pour stocker toutes leurs données de session.
<classname>Zend_Session</classname> utilise ext/session et sa superglobale spéciale
<varname>$_SESSION</varname> comme mécanisme de stockage pour les données d'état de session. Bien
que <varname>$_SESSION</varname> est toujours disponible dans l'espace global de <acronym>PHP</acronym>, les
développeurs devraient s'abstenir d'accéder directement à elle, alors que
<classname>Zend_Session</classname> et <classname>Zend_Session_Namespace</classname>
fournissent plus efficacement et plus solidement leur suite de fonctionnalités liées à
session.
</para>
<para>
Chaque instance de <classname>Zend_Session_Namespace</classname> correspond à une
entrée dans le tableau de la superglobale <varname>$_SESSION</varname>, où l'espace de noms est
utilisée comme une clé. <programlisting language="php"><![CDATA[
$monNamespace = new Zend_Session_Namespace('monNamespace');
// $monNamespace corresponds to $_SESSION['monNamespace']
]]></programlisting> Il est possible d'utiliser <classname>Zend_Session</classname>
conjointement avec d'autre code utilisant directement <varname>$_SESSION</varname>. Cependant,
pour éviter les problèmes, il est fortement recommandé que ce code utilise seulement les
parties de <varname>$_SESSION</varname> ne correspondant pas aux instances de
<classname>Zend_Session_Namespace</classname>.
</para>
<sect2 id="zend.session.basic_usage.basic_examples">
<title>Tutoriel d'exemples</title>
<para>
Si aucun espace de noms n'est spécifié lors de l'instanciation de
<classname>Zend_Session_Namespace</classname>, toutes les données sont stockées de
manière transparente dans un espace de noms appelé "<code>Default</code>".
<classname>Zend_Session</classname> n'est pas prévu pour fonctionner directement sur le
contenu des conteneurs des espaces de noms. Au lieu de cela, nous utilisons
<classname>Zend_Session_Namespace</classname>. L'exemple ci-dessous montre l'utilisation
de cet espace de noms par défaut, en montrant comment compter le nombre de fois qu'un
utilisateur a vu une page sur le site Web. Pour tester cet exemple, ajouter le code
suivant à votre fichier d'amorçage ZF :
</para>
<example id="zend.session.basic_usage.basic_examples.example.counting_page_views">
<title>Compter le nombre de pages vues</title>
<programlisting language="php"><![CDATA[
$defaultNamespace = new Zend_Session_Namespace('Default');
if (isset($defaultNamespace->numberOfPageRequests)) {
$defaultNamespace->numberOfPageRequests++;
// ceci s'incrémente à chaque chargement de page.
} else {
$defaultNamespace->numberOfPageRequests = 1;
// première page
}
echo "Page demandée lors de cette session : ",
$defaultNamespace->numberOfPageRequests;
]]></programlisting>
</example>
<para>
Quand de multiples modules utilisent des instances de
<classname>Zend_Session_Namespace</classname> ayant différents espaces de noms, chaque
module obtient une encapsulation pour ses propres données de session. Le constructeur de
<classname>Zend_Session_Namespace</classname> peut recevoir un paramètre facultatif
<varname>$namespace</varname>, qui permet aux développeurs la partition des données de session
dans des espaces de noms séparés. Les espaces de noms fournissent une manière efficace
et populaire de protéger un sous-ensemble de données de session contre un changement
accidentel dû à des collisions de noms.
</para>
<para>
Les noms des espaces de noms sont limités à des chaînes de caractères <acronym>PHP</acronym>
non-vides qui ne commencent par un tiret-bas ("<code>_</code>"). De plus, seuls les
composants coeur de Zend Framework devraient employer un nom d'espace de noms commençant
par "<code>Zend</code>".
</para>
<example id="zend.session.basic_usage.basic_examples.example.namespaces.new">
<title>Nouvelle méthode : les espaces de noms évitent les collisions</title>
<programlisting language="php"><![CDATA[
// Dans le composant Zend_Auth
$authNamespace = new Zend_Session_Namespace('Zend_Auth');
$authNamespace->user = "monusername";
// Dans un composant service web
$webServiceNamespace = new Zend_Session_Namespace('Un_Service_Web');
$webServiceNamespace->user = "monwebusername";
]]></programlisting>
</example>
<para>
L'exemple ci-dessus réalise la même chose que celui ci-dessous, excepté que les
objets de session ci-dessus préserve l'encapsulation des données de session dans leur
espace de noms respectif.
</para>
<example id="zend.session.basic_usage.basic_examples.example.namespaces.old">
<title>Ancienne méthode : accès aux sessions PHP</title>
<programlisting language="php"><![CDATA[
$_SESSION['Zend_Auth']['user'] = "monusername";
$_SESSION['Un_Service_Web']['user'] = "monwebusername";
]]></programlisting>
</example>
</sect2>
<sect2 id="zend.session.basic_usage.iteration">
<title>Énumérer les espaces de noms de session</title>
<para>
<classname>Zend_Session_Namespace</classname> fournit une <ulink
url="http://www.php.net/~helly/php/ext/spl/interfaceIteratorAggregate.html">interface
IteratorAggregate</ulink> complète, incluant le support de l'instruction
<code>foreach</code> :
</para>
<example id="zend.session.basic_usage.iteration.example">
<title>Énumération des sessions</title>
<programlisting language="php"><![CDATA[
$unNamespace =
new Zend_Session_Namespace('un_namespace_avec_des_donnes_presentes');
foreach ($unNamespace as $index => $valeur) {
echo "unNamespace->$index = '$valeur';\n";
}
]]></programlisting>
</example>
</sect2>
<sect2 id="zend.session.basic_usage.accessors">
<title>Accesseurs pour les espaces de noms de session</title>
<para>
<classname>Zend_Session_Namespace</classname> implémente <methodname>__get()</methodname>,
<methodname>__set()</methodname>, <methodname>__isset()</methodname>, et <methodname>__unset()</methodname>. <ulink
url="http://www.php.net/manual/fr/language.oop5.overloading.php">Les méthodes
magiques</ulink> ne devraient pas être utilisées directement, excepté à l'intérieur
d'une sous-classe. Au lieu de cela, utilisez les opérateurs normaux pour appeler ces
méthodes magiques, comme :
</para>
<example id="zend.session.basic_usage.accessors.example">
<title>Accéder aux données de session</title>
<programlisting language="php"><![CDATA[
$namespace = new Zend_Session_Namespace();
// Espace de noms par défaut
$namespace->foo = 100;
echo "\$namespace->foo = $namespace->foo\n";
if (!isset($namespace->bar)) {
echo "\$namespace->bar n'existe pas\n";
}
unset($namespace->foo);
]]></programlisting>
</example>
</sect2>
</sect1>
|
