dams Thu Jul 12 08:17:02 2001 EDT
Modified files:
/phpdoc/fr/functions session.xml
Log:
Correcting docBook/Jade errors
Index: phpdoc/fr/functions/session.xml
diff -u phpdoc/fr/functions/session.xml:1.12 phpdoc/fr/functions/session.xml:1.13
--- phpdoc/fr/functions/session.xml:1.12 Sat Jul 7 18:22:24 2001
+++ phpdoc/fr/functions/session.xml Thu Jul 12 08:17:02 2001
@@ -3,41 +3,41 @@
<titleabbrev>Sessions</titleabbrev>
<partintro>
<para>
- La gestion des sessions avec PHP est un moyen de sauver des informations
- entre deux accès. Cela permet notamment de construire des
- applications personnalisées, et d'accroître l'attrait de votre
site.
+ La gestion des sessions avec PHP est un moyen de sauver des informations
+ entre deux accès. Cela permet notamment de construire des
+ applications personnalisées, et d'accroître l'attrait de votre site.
</para>
<para>
- Si vous connaissez déjà la gestion des sessions avec
- phplib, vous remarquerez que certains concepts sont similaires.
+ Si vous connaissez déjà la gestion des sessions avec
+ phplib, vous remarquerez que certains concepts sont similaires.
</para>
<para>
- Chaque visiteur qui accède à votre site se voit assigner
- un numéro d'identifiant, appelé plus loin "identifiant de
- session". Celui ci est enregistré soit dans un cookie, chez
- le client, soit dans l'URL.
+ Chaque visiteur qui accède à votre site se voit assigner
+ un numéro d'identifiant, appelé plus loin "identifiant de
+ session". Celui-ci est enregistré soit dans un cookie, chez
+ le client, soit dans l'URL.
</para>
<para>
- Les sessions vous permettront d'enregistrer des variables, pour
- les préserver et les réutiliser tout au long des
- requêtes. Lorsqu'un visiteur accède à votre site,
- PHP vérifiera automatiquement (si session.auto_start est à
- 1) ou manuellement (explicitement avec <function>session_start</function>
- ou implicitement avec <function>session_register</function>) si une
- session a déjà été ouverte. Si
- une telle session existe déjà, l'environnement
- précédent sera recréé.
+ Les sessions vous permettront d'enregistrer des variables pour
+ les préserver et les réutiliser tout au long de la
+ visites de votre site. Lorsqu'un visiteur accèdere à votre site,
+ PHP vérifiera automatiquement (si session.auto_start est à
+ 1) ou manuellement (explicitement avec <function>session_start</function>
+ ou implicitement avec <function>session_register</function>) si une
+ session a déjà été ouverte. Si
+ une telle session existe déjà, l'environnement
+ précédent sera recréé.
</para>
<para>
- Toutes les variables à enregistrer seront enregistrées
- sur le disque à la fin de chaque requête. Les variables
- enregistrées mais non définies seront marquées
- comme tel. Lors des accès ultérieurs, elles ne seront
- définies que si l'utilisateur le fait.
+ Toutes les variables à enregistrer seront enregistrées
+ sur le disque à la fin de chaque requête. Les variables
+ enregistrées mais non définies seront marquées
+ comme telles. Lors des accès ultérieurs, elles ne seront
+ définies que si l'utilisateur le fait.
</para>
<para>
Les options <literal>track_vars</literal> et <literal>gpc_globals</literal>
- modifient la façon avec laquelle les variables sont rechargéees.
+ modifient la façon dont les variables sont rechargées.
</para>
<note>
<para>
@@ -49,9 +49,9 @@
<para>
Si <literal>track_vars</literal> est activée, et <link
linkend="ini.register-globals"><literal>register_globals</literal></link>
- est désactivée, alors les variables de session seront accessibles
+ désactivée, alors les variables de session seront accessibles
uniquement dans le tableau associatif global $HTTP_STATE_VARS.
- Les variables de sessions lues seront disponibles dans
+ Les variables de session lues seront disponibles dans
$HTTP_STATE_VARS.
<example>
<title>
@@ -61,15 +61,15 @@
</title>
<programlisting role="php">
<?php
-session_register("compte");
-$HTTP_SESSION_VARS["compte"]++;
+ session_register("compte");
+ $HTTP_SESSION_VARS["compte"]++;
?>
</programlisting>
</example>
</para>
<para>
Si <link linkend="ini.register-globals"><literal>register_globals</literal></link>
- est activé, alors les variables de session seront placés
+ est activée, alors les variables de session seront placées
dans les variables globales associées.
<example>
<title>
@@ -79,8 +79,8 @@
</title>
<programlisting role="php">
<?php
-session_register("compte");
-$compte++;
+ session_register("compte");
+ $compte++;
?>
</programlisting>
</example>
@@ -96,28 +96,29 @@
Il y a deux modes de propagation de l'identifiant de session :
<itemizedlist>
<listitem>
- <simpara>
- Cookies
- </simpara>
+ <simpara>
+ Cookies
+ </simpara>
</listitem>
<listitem>
- <simpara>
- Paramètre URL
- </simpara>
+ <simpara>
+ Paramètre URL
+ </simpara>
</listitem>
</itemizedlist>
</para>
<para>
Le module de session supporte les deux techniques. La
méthode par cookies est optimale, mais étant
- donné le peu de fiabilité (les clients peuvent les refuser,
- ou les effacer), on ne peut pas se contenter de cette technique.
+ donné son peu de fiabilité (les clients peuvent refuser
+ ou effacer les cookies), on ne peut pas se contenter de cette technique.
La deuxième méthode place l'identifiant de session
directement dans l'URL.
</para>
<para>
PHP est capable de gérer ceci de manière transparente,
- lorsque vous le compilez avec l'option <literal>--enable-trans-sid</literal>.
+ lorsque vous le compilez avec l'option <link
+linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link>.
Dans ce cas, les URL relatives seront modifiées pour
contenir l'identifiant de session automatiquement. Sinon,
vous pouvez toujours utiliser la constante <literal>SID</literal>,
@@ -130,9 +131,9 @@
<note>
<para>
La fonction qui gérera l'écriture des données ne sera
appelée
- qu'une fois le script aura envoyé toutes ses données. Ainsi,
+ qu'une fois que le script aura envoyé toutes ses données. Ainsi,
les affichages tentés par cette fonction ne pourront jamais
- être recus par le navigateur. Si un tel affichage est nécessaire,
+ être reçus par le navigateur. Si un tel affichage est
+nécessaire,
il est conseillé d'écrire les debugs dans un fichier.
</para>
</note>
@@ -141,16 +142,16 @@
L'exemple suivant montre comment enregistrer une variable, et comment relier
correctement des pages avec SID.
<example>
- <title>Compter le nombre de hit d'un utilisateur.</title>
+ <title>Compter le nombre de hits d'un utilisateur.</title>
<programlisting role="php">
<?php
-session_register("compteur");
-$compteur++;
+ session_register("compteur");
+ $compteur++;
?>
Salut visiteur, vous avez vu cette page <?php echo $compteur; ?> times.<P>
<php?
# le <?=SID> est nécessaire pour transmettre l'identifiant de session
-# au cas oú les utilisateurs auraient inactivé les cookies
+# au cas où les utilisateurs auraient inactivé les cookies
?>
</programlisting>
<simpara>
@@ -160,7 +161,8 @@
</para>
<para>
Le <literal><?=SID-></literal> n'est pas nécessaire, si l'option
- <literal>--enable-trans-sid</literal> a été utilisé
+ <link linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link> a été utilisée
pour compiler PHP.
</para>
<para>
@@ -176,7 +178,7 @@
Pour enregistrer ces informations dans une base de données,
il vous faut utiliser la fonction <function>session_set_save_handler</function>.
Il faudra alors implémenter la fonction suivante pour
- l'adapter à MySQL ou toute autre base de données :
+ l'adapter à MySQL ou à toute autre base de données :
</para>
<para>
Le système de gestion des sessions dispose d'un grand nombre d'options,
@@ -184,112 +186,113 @@
un survol rapide :
<itemizedlist>
<listitem>
- <simpara>
- <literal>session.save_handler</literal> défini les noms
- des fonctions qui seront utilisées pour enregistrer et
- retrouver les données associées à une session.
- Par défaut, les sessions sont enregistrées dans des
- <literal>fichiers</literal>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.save_path</literal> défini l'argument qui
- est passé à la fonction de sauvegarde. Si vous utilisez
- la sauvegarde par fichier, cet argument est le chemin jusqu'au dossier
- oú les fichiers sont créés. Par défaut, le
- dossier est <literal>/tmp</literal>.
- </simpara>
+ <simpara>
+ <literal>session.save_handler</literal> définit les noms
+ des fonctions qui seront utilisées pour enregistrer et
+ retrouver les données associées à une session.
+ Par défaut, les sessions sont enregistrées dans des
+ <literal>fichiers</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.save_path</literal> définit l'argument qui
+ est passé à la fonction de sauvegarde. Si vous utilisez
+ la sauvegarde par fichier, cet argument est le chemin jusqu'au dossier
+ où les fichiers sont créés. Par défaut, le
+ dossier est <literal>/tmp</literal>.
+ </simpara>
<warning>
<para>
Si le dossier que vous utilisez a les droits de lecture universels,
comme <filename>/tmp</filename> (valeur par défaut), les autres
utilisateurs
- du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions.
+ du serveur peuvent aussi lire ces fichiers, et s'immiscer dans vos sessions.
</para>
</warning>
</listitem>
<listitem>
- <simpara>
- <literal>session.name</literal> spécifie le nom de la session,
- qui sera utilisé comme nom de cookie. Par défaut :
- <literal>PHPSESSID</literal>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.auto_start</literal> indique qu'une session doit
- commencer automatiquement lors de la premier requête. Par
- défaut à <literal>0</literal> (inactivé).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.lifetime</literal> fixe la durée de vie,
- en secondes, du cookie envoyé au client. La valeur 0 signifie
- "jusqu'à ce que le client soit fermé". Par défaut
- à <literal>0</literal> (inactivé).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.serialize_handler</literal> défini le
- nom de la fonction qui sera utilisée pour enregistrer et
- relire les donnés. Actuellement, c'est un format interne
- de PHP (nom : <literal>php</literal>) et WDDX (nom :
- <literal>wddx</literal>). WDDX n'est utilisable que si
- PHP a été compilé avec le
- <link linkend="ref.wddx">support WDDX</link>. Par défaut,
- c'est le mode <literal>php</literal> qui est selectionné.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.gc_probability</literal> précise la
- probabilité que la routine gc (garbage collection) soit
- lancée, en pourcentage. Par défaut, <literal>1</literal>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.gc_maxlifetime</literal> fixe la durée,
- en secondes, au-dela de laquelle les données
- considérées comme inutiles seront supprimées.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.referer_check</literal> détermine si
- l'identifiant de session ids utilisé par des sites externe
- seront éliminé. Si les identifiants de sessions sont
- propagés avec la méthode des URL, des utilisateurs qui
- n'en connaîtrait pas l'utilité risque de divulguer ces
- valeurs, et cela ménera à des problèmes de
- sécurité. Cette option y remédie. Par
- défaut : <literal>0</literal>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.entropy_file</literal> est le chemin jusqu'à
- une source externe (fichier) d'entropie, qui sera utilisée
- lors de la création de l'identifiant de session. Par exemple,
- <literal>/dev/random</literal> ou <literal>/dev/urandom</literal> qui
- sont disponibles sur de nombreux systèmes UNIX.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.entropy_length</literal> précise le
- nombre d'octets qui seront lus dans le fichier ci-dessus.
- Par défaut, <literal>0</literal> (inactivé).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <literal>session.use_cookies</literal> cookies indique si le module doit
- utiliser des cookies pour enregistrer l'identifiant de session chez le client.
- Par défaut, <literal>1</literal> (activé).
- </simpara>
+ <simpara>
+ <literal>session.name</literal> spécifie le nom de la session,
+ qui sera utilisé comme nom de cookie. Par défaut :
+ <literal>PHPSESSID</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.auto_start</literal> indique qu'une session doit
+ commencer automatiquement lors de la premier requête. Par
+ défaut, la valeur est à <literal>0</literal> (inactivé).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.lifetime</literal> fixe la durée de vie,
+ en secondes, du cookie envoyé au client. La valeur 0 signifie
+ "jusqu'à ce que le client soit fermé". Par défaut
+ à <literal>0</literal> (inactivé).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.serialize_handler</literal> définit le
+ nom de la fonction qui sera utilisée pour enregistrer et
+ relire les donnés. Actuellement, c'est un format interne
+ de PHP (nom : <literal>php</literal>) et WDDX (nom :
+ <literal>wddx</literal>). WDDX n'est utilisable que si
+ PHP a été compilé avec le
+ <link linkend="ref.wddx">support WDDX</link>. Par défaut,
+ c'est le mode <literal>php</literal> qui est sélectionné.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.gc_probability</literal> précise la
+ probabilité que la routine gc (garbage collection) soit
+ lancée, en pourcentage. Par défaut, la valeur est à
+ <literal>1</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.gc_maxlifetime</literal> fixe la durée,
+ en secondes, au-delà de laquelle les données
+ considérées comme inutiles seront supprimées.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.referer_check</literal> détermine si
+ l'identifiant de session (session id) utilisé par des sites externes
+ seront éliminés. Si les identifiants de session sont
+ propagés avec la méthode des URL, des utilisateurs qui
+ n'en connaîtraient pas l'utilité risquent de divulguer ces
+ valeurs, et cela mènera à des problèmes de
+ sécurité. Cette option y remédie. Par
+ défaut : <literal>0</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.entropy_file</literal> est le chemin jusqu'à
+ une source externe (fichier) d'entropie, qui sera utilisée
+ lors de la création de l'identifiant de session. Par exemple,
+ <literal>/dev/random</literal> ou <literal>/dev/urandom</literal> qui
+ sont disponibles sur de nombreux systèmes UNIX.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.entropy_length</literal> précise le
+ nombre d'octets qui seront lus dans le fichier ci-dessus.
+ Par défaut, <literal>0</literal> (inactivé).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>session.use_cookies</literal> cookies indique si le module doit
+ utiliser des cookies pour enregistrer l'identifiant de session chez le client.
+ Par défaut, <literal>1</literal> (activé).
+ </simpara>
</listitem>
<listitem>
<simpara>
@@ -305,22 +308,38 @@
</listitem>
<listitem>
<simpara>
- <literal>session.cache_limiter</literal> spécifie le controle du
- cache, à utiliser avec les pages de sessions (nocache/private/public).
- Par défaut, <literal>nocache</literal>.
+ <literal>session.cache_limiter</literal> spécifie le contrôle du
+ cache, à utiliser avec les pages de session (nocache/private/public).
+ Par défaut, <literal>nocache</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>session.cache_expire</literal> spécifie la durée de vie
- des pages de sessions cachées, en minutes, mais sans que cela
- n'ait d'efft sur le limiteur "nocache". Par défaut,
<literal>180</literal>.
+ des pages de session cachées, en minutes, mais sans que cela
+ ait d'effets sur le limiteur "nocache". Par défaut,
+<literal>180</literal>.
</simpara>
</listitem>
- </itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>session.use_trans_sid</literal> indique si le support du
+ SID est activé ou pas, lors de la compilation avec l'option
+ <link linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link>.
+ Par défaut, elle vaut <literal>1</literal> (activée).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>url_rewriter.tags</literal> spefifies which html tags are
+ rewritten to include session id if transient sid support is enabled.
+ Defaults to
+<literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
+ </simpara>
+ </listitem>
+ </itemizedlist>
<note>
<para>
- La gestion des sessions a été ajoutée dans PHP 4.0.
+ La gestion des sessions a été ajoutée en PHP 4.0.
</para>
</note>
</para>
@@ -334,7 +353,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_start</function></funcdef>
+ <funcdef>boolean <function>session_start</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
@@ -344,11 +363,11 @@
session passé par une variable GET ou par un cookie)
</simpara>
<simpara>
- <function>session_start</function> retourne toujours &true;.
+ <function>session_start</function> retourne toujours <literal>TRUE</literal>.
</simpara>
<note>
<para>
- <function>session_start</function> a été ajoutée en
PHP 4.0.
+ <function>session_start</function> a été ajoutée en PHP
+4.0.
</para>
</note>
</refsect1>
@@ -364,7 +383,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_destroy</function></funcdef>
+ <funcdef>boolean <function>session_destroy</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
@@ -373,8 +392,8 @@
données associées à la session courante.
</simpara>
<simpara>
- <function>session_destroy</function> retourne &true; en
- cas de succès, et &false; sinon.
+ <function>session_destroy</function> retourne <literal>TRUE</literal> en
+ cas de succès, et <literal>FALSE</literal> sinon.
</simpara>
</refsect1>
</refentry>
@@ -386,10 +405,12 @@
<refsect1>
<title>Description</title>
<funcsynopsis>
+ <funcprototype>
<funcdef>string <function>session_name</function></funcdef>
<paramdef>string
- <parameter><optional>name</optional></parameter>
+ <parameter><optional>name</optional></parameter>
</paramdef>
+ </funcprototype>
</funcsynopsis>
<para>
<function>session_name</function>retourne le nom de la session courante.
@@ -402,7 +423,7 @@
caractères alpha-numériques; il doit être court et
descriptif. (i.e. surtout pour les utilisateurs d'alertes de cookie).
Le nom de session est remis à une valeur par défaut,
- enregistrées dans <literal>session.name</literal> au moment
+ enregistrée dans <literal>session.name</literal> au moment
du démarrage. Ainsi, vous devez appeler
<function>session_name</function> à chaque requête
(et avant <function>session_start</function> ou
@@ -420,8 +441,8 @@
</example>
<note>
<para>
- <function>session_name</function> a été ajoutée
- en PHP 4.0.
+ <function>session_name</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</refsect1>
@@ -446,10 +467,10 @@
le module courant de session courante. Si <parameter>module</parameter>
est fourni, ce module sera utilisé à la place du courant.
<note>
- <para>
- <function>session_module_name</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_module_name</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -475,19 +496,19 @@
sessions. Si <parameter>path</parameter> est fourni, le chemin
prendra alors la valeur fournie.
<note>
- <para>
- Sur certains systèmes d'exploitation, il vous faudra peut
- être fournir un chemin vers un système de sauvegarde
- qui peut gérer de grandes quantités de petits
- fichiers efficacement : par exemple, sous Linux, reiserfs peut
- être plus efficace que ext2fs.
- </para>
+ <para>
+ Sur certains systèmes d'exploitation, il vous faudra peut
+ être fournir un chemin vers un système de sauvegarde
+ qui peut gérer efficacement de grandes quantités de petits
+ fichiers : par exemple, sous Linux, reiserfs peut être plus efficace
+ que ext2fs.
+ </para>
</note>
<note>
- <para>
- <function>session_save_path</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_save_path</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -515,10 +536,10 @@
utilisée pour retrouver le nom de la session courante et
son identifiant, comme chaîne à ajouter dans les URL.
<note>
- <para>
- <function>session_id</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_id</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -534,7 +555,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_register</function></funcdef>
+ <funcdef>boolean <function>session_register</function></funcdef>
<paramdef>mixed <parameter>name</parameter></paramdef>
<paramdef>mixed
<parameter><optional>...</optional></parameter></paramdef>
@@ -542,19 +563,32 @@
</funcsynopsis>
<para>
<function>session_register</function> enregistre une variable avec
- le nom name dans la session courante. <function>session_register</function>
- accepte un nombre d'arguments variable, qui peuvent être des chaînes
- représentant le nom de la variable, ou bien un tableau,
représentant
- des chaînes ou d'autre tableau (récursif).
+ le nom <parameter>name</parameter> dans la session courante.
+ <function>session_register</function> accepte un nombre d'arguments
+ variable. Ces arguments peuvent être soit des chaînes
+représentants
+ le nom de la variable, soit un tableau, contenant des chaînes ou
+ d'autres tableaux (cas d'un tableau récursif).
</para>
<para>
- <function>session_register</function> retourne &true; lorsque
- la variable est correctement enregistrée.
+ <function>session_register</function> retourne <literal>TRUE</literal> lorsque
+ les variables sont correctement enregistrées.
+ <note>
+ <para>
+ Actuellement, il n'est pas possible d'enregistrer des variables de
+ ressources dans une session. Par exemple, vous ne pouvez pas créer une
+ connexion à une base de données dans un script, la stocker dans
+une session,
+ et retrouver cette connexion lors de la prochaine utilisation de la
+ session. Les fonctions qui retournent des ressources PHP sont identifées
+ par leur valeur de retour <literal>resource</literal>, dans leur fonction
+ de définition. Vous pouvez aussi les retrouver dans les
+ <link linkend="resources">annexes</link>.
+ </para>
+ </note>
<note>
- <para>
- <function>session_register</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_register</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -570,7 +604,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_unregister</function></funcdef>
+ <funcdef>boolean <function>session_unregister</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -579,14 +613,14 @@
nommée <parameter>name</parameter> dans la session courante.
</para>
<para>
- <function>session_unregister</function> retourne &true;
+ <function>session_unregister</function> retourne <literal>TRUE</literal>
lorsque la variable a été correctement supprimée
de la session.
<note>
- <para>
- <function>session_unregister</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_unregister</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -623,19 +657,19 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_is_registered</function></funcdef>
+ <funcdef>boolean <function>session_is_registered</function></funcdef>
<paramdef>string <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
- <function>session_is_registered</function> retourne &true;
+ <function>session_is_registered</function> retourne <literal>TRUE</literal>
s'il y a une variable du nom de <parameter>name</parameter>
enregistrée dans la session courante.
<note>
- <para>
- <function>session_is_registered</function> a été
ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_is_registered</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -693,21 +727,21 @@
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_set_cookie_params</function></funcdef>
- <paramdef>
- int <parameter>lifetime</parameter>
+ <paramdef>int
+ <parameter>lifetime</parameter>
</paramdef>
- <paramdef>
- string <parameter><optional>path</optional></parameter>
+ <paramdef>string
+ <parameter><optional>path</optional></parameter>
</paramdef>
- <paramdef>
- string <parameter><optional>domain</optional></parameter>
+ <paramdef>string
+ <parameter><optional>domain</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>session_set_cookie_params</function> modifie les
- paramètres du cookie de session, tel qu'ils ont été
définis dans
- le fichier <filename>php.ini</filename>. L'effet de cette
+ paramètres du cookie de session, tels qu'ils ont été
+ définis dans le fichier <filename>php.ini</filename>. L'effet de cette
fonction ne dure que le temps du script.
</para>
</refsect1>
@@ -723,7 +757,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>session_decode</function></funcdef>
+ <funcdef>boolean <function>session_decode</function></funcdef>
<paramdef>string <parameter>data</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -732,10 +766,10 @@
de session à partir de la chaîne <parameter>data</parameter>,
et affecte les valeurs des variables de session.
<note>
- <para>
- <function>session_decode</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_decode</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -750,17 +784,19 @@
<refsect1>
<title>Description</title>
<funcsynopsis>
- <funcdef>bool <function>session_encode</function></funcdef>
+ <funcprototype>
+ <funcdef>boolean <function>session_encode</function></funcdef>
<paramdef>void</paramdef>
+ </funcprototype>
</funcsynopsis>
<para>
<function>session_encode</function> retourne les données de
session dans une chaîne.
<note>
- <para>
- <function>session_encode</function> a été ajoutée
- en PHP 4.0.
- </para>
+ <para>
+ <function>session_encode</function> a été ajoutée
+ en PHP 4.0.
+ </para>
</note>
</para>
</refsect1>
@@ -806,7 +842,7 @@
</note>
<para>
L'exemple suivant fournit un exemple de stockage de session
- dans un fichier, similaire aux fonctions standard de PHP. Cet
+ dans un fichier, similaire aux fonctions standards de PHP. Cet
exemple peut être facilement étendu pour utiliser un
stockage en base de données, en utilisant votre base
préférée.
</para>
@@ -887,12 +923,13 @@
le nom du limiteur de cache est remplacé par cette nouvelle valeur.
</para>
<para>
- Le limiteur de cache contrôle l'envoi des entête HTTP envoyés
au client.
- Ces entêtes déterminent les règles de mise en cache des
pages. En utilisant
- la valeur de <literal>nocache</literal>, par exemple, vous désactiverez
- la mise en cache coté client. La valeur de <literal>public</literal>,
- cependant, le permettra. <literal>private</literal> aussi,
- tout en étant légèrement plus restrictive que
<literal>public</literal>.
+ Le limiteur de cache contrôle l'envoi des en-têtes HTTP
+envoyés
+ au client. Ces en-têtes déterminent les règles de mise en
+ cache des pages. En utilisant la valeur de <literal>nocache</literal>, par
+ exemple, vous désactiverez la mise en cache côté client. La
+ valeur de <literal>public</literal>, cependant, le permettra.
+ <literal>private</literal> aussi, tout en étant légèrement
+ plus restrictive que <literal>public</literal>.
</para>
<para>
Le limiteur de cache est remis à sa valeur par défaut,
stockée dans