cvs: phpdoc /fr/functions session.xml
| From: | Damien Seguy | Date: | Thu, 12 Jul 2001 12:17:02 +0000 |
| Subject: | cvs: phpdoc /fr/functions session.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336203@lists.php.net to get a copy of this message | ||
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
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