cvs: phpdoc-fr /reference/posix/functions posix-mknod.xml /reference/session ini.xml reference.xml /reference/session/functions session-id.xml
session-set-save-handler.xml
| From: | Yannick Torres | Date: | Sat, 26 Nov 2005 15:25:37 +0000 |
| Subject: | cvs: phpdoc-fr /reference/posix/functions posix-mknod.xml /reference/session ini.xml reference.xml /reference/session/functions session-id.xml session-set-save-handler.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-4639@lists.php.net to get a copy of this message | ||
yannick Sat Nov 26 10:25:37 2005 EDT
Modified files:
/phpdoc-fr/reference/posix/functions posix-mknod.xml
/phpdoc-fr/reference/session/functions session-id.xml
session-set-save-handler.xml
/phpdoc-fr/reference/session ini.xml reference.xml
Log:
sync with EN
http://cvs.php.net/diff.php/phpdoc-fr/reference/posix/functions/posix-mknod.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-fr/reference/posix/functions/posix-mknod.xml diff -u phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.1 phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.2 --- phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.1 Sat Jul 9 08:54:04 2005 +++ phpdoc-fr/reference/posix/functions/posix-mknod.xml Sat Nov 26 10:25:36 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.posix-mknod"> <refnamediv> @@ -51,7 +51,8 @@ <term><parameter>major</parameter></term> <listitem> <para> - L'identifiant majeur du dispositif du noyau + L'identifiant majeur du dispositif du noyau (requis lorsque vous utilisez + <constant>S_IFCHR</constant> ou <constant>S_IFBLK</constant>). </para> </listitem> </varlistentry> @@ -59,7 +60,7 @@ <term><parameter>minor</parameter></term> <listitem> <para> - L'identifiant mineur du dispositif du noyau + L'identifiant mineur du dispositif du noyau (par défaut, 0). </para> </listitem> </varlistentry> @@ -84,10 +85,12 @@ <?php $file = '/tmp/tmpfile'; // nom du fichier -$type = POSIX_S_IFBLOCK; // type du fichier +$type = POSIX_S_IFBLK; // type du fichier $permissions = 0777; // octal +$major = 1; +$minor = 8; // /dev/random -if (!posix_mknod($file, $type | $permissions)) { +if (!posix_mknod($file, $type | $permissions, $major, $minor)) { die('Erreur : ' . posix_get_last_error() . ': ' . posix_strerror(posix_get_last_error())); } http://cvs.php.net/diff.php/phpdoc-fr/reference/session/functions/session-id.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-fr/reference/session/functions/session-id.xml diff -u phpdoc-fr/reference/session/functions/session-id.xml:1.14 phpdoc-fr/reference/session/functions/session-id.xml:1.15 --- phpdoc-fr/reference/session/functions/session-id.xml:1.14 Sat Jul 9 08:38:32 2005 +++ phpdoc-fr/reference/session/functions/session-id.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> @@ -20,9 +21,7 @@ <para> La constante <constant>SID</constant> peut également être utilisée pour lire le nom de la session courante et l'identifiant de session à fournir - dans les URL. Notez que <constant>SID</constant> est uniquement - défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link - linkend="ref.session">Gestion de session</link>. + dans les URL. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-fr/reference/session/functions/session-set-save-handler.xml?r1=1.17&r2=1.18&ty=u Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.17 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.18 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.17 Sat May 14 13:53:54 2005 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + <refentry id="function.session-set-save-handler"> <refnamediv> <refname>session_set_save_handler</refname> @@ -54,6 +55,16 @@ converties en booléen avant d'être retournées au script. &true; pour la réussite, &false; pour l'échec. </para> + <warning> + <para> + Les gestionnaires d'écriture et de fermeture sont appelés après la destruction + des objets depuis &php; 5.0.5. Ces destructeurs peuvent utiliser les sessions + mais le gestionnaire de session ne peut pas utiliser les objets. Dans les versions + antérieures, ils étaient appelés dans l'ordre inverse. Il est possible d'appeler + <function>session_write_close</function> depuis le destructeur pour résoudre + ce problème. + </para> + </warning> <para> <example> <title> http://cvs.php.net/diff.php/phpdoc-fr/reference/session/ini.xml?r1=1.32&r2=1.33&ty=u Index: phpdoc-fr/reference/session/ini.xml diff -u phpdoc-fr/reference/session/ini.xml:1.32 phpdoc-fr/reference/session/ini.xml:1.33 --- phpdoc-fr/reference/session/ini.xml:1.32 Sat Sep 10 17:43:34 2005 +++ phpdoc-fr/reference/session/ini.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.32 $ --> -<!-- EN-Revision: 1.35 Maintainer: dams Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.33 $ --> +<!-- EN-Revision: 1.36 Maintainer: dams Status: ready --> +<!-- Reviewed: no --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -335,6 +335,15 @@ et supprimées. </simpara> <note> + <para> + Si des scripts différents ont des valeurs différentes de + <literal>session.gc_maxlifetime</literal> mais partagent le même + endroit pour y stocker les données de session, alors, le script dont la valeur + est la plus petite effacera la donnée. Dans ce cas, utilisez cette directive + conjointement avec <link linkend="ini.session.save-path">session.save_path</link>. + </para> + </note> + <note> <simpara> Si vous utilisez le gestionnaire de sessions par fichier, qui est fourni par défaut votre système doit garder la trace des http://cvs.php.net/diff.php/phpdoc-fr/reference/session/reference.xml?r1=1.32&r2=1.33&ty=u Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.32 phpdoc-fr/reference/session/reference.xml:1.33 --- phpdoc-fr/reference/session/reference.xml:1.32 Mon Sep 5 12:11:16 2005 +++ phpdoc-fr/reference/session/reference.xml Sat Nov 26 10:25:36 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.32 $ --> -<!-- EN-Revision: 1.51 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.33 $ --> +<!-- EN-Revision: 1.55 Maintainer: yannick Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: core --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> <reference id="ref.session"> <title>Sessions</title> @@ -250,25 +250,6 @@ </para> </warning> <para> - <example> - <title> - Retirer une variable de session avec <varname>$_SESSION</varname> et - <link - linkend="ini.register-globals"><option>register_globals</option></link> - activé, après l'avoir enregistré avec <varname>$_SESSION</varname>. - </title> - <programlisting role="php"> -<![CDATA[ -<?php -session_start(); -// Avec PHP 4.3 et plus récent, vous pouvez simplement utiliser l'exemple précédent -session_unregister('compteur'); -?> -]]> - </programlisting> - </example> - </para> - <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> est activé, alors toutes les variables globales peuvent être enregistrées comme variables de session, et toutes les variables de @@ -280,7 +261,7 @@ ne nécessitent pas <function>session_register</function>. <caution> <para> - Avant &php; 4.3, si vous utilisez <varname>$_SESSION</varname> et que + Avant &php; 4.3, si vous utilisez <varname>$_SESSION</varname> et que vous avez désactivé <link linkend="ini.register-globals"><option>register_globals</option></link>, n'utilisez pas <function>session_register</function>, @@ -288,33 +269,11 @@ <function>session_unregister</function>. </para> <para> - Si vous activez <link - linkend="ini.register-globals"><literal>register_globals</literal></link>, - <function>session_unregister</function> doit être utilisé, car les - variables de sessions sont enregistrés comme variables globales lorsque - les données de sessions sont relues. Désactiver + Désactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> est recommandé pour des raisons de sécurité et de performances. </para> </caution> - <example> - <title> - Enregistrer une variable avec - <link linkend="ini.register-globals"><option>register_globals</option></link> - activé - </title> - <programlisting role="php"> -<![CDATA[ -<?php -if (! isset($_SESSION['compteur'])) { - $_SESSION['compteur'] = 1; -} else { - $_SESSION['compteur']++; -} -?> -]]> - </programlisting> - </example> </para> <para> Si <link @@ -322,7 +281,9 @@ est activé, alors les variables globales et les entrées dans le tableau <varname>$_SESSION</varname> seront des références sur la même valeur pour les valeurs qui auront été enregistrées avant le démarrage de la session - (donc, dans les page précédentes). + (donc, dans les page précédentes). Cependant, si la variable a été enregistrée + avec <varname>$_SESSION</varname>, alors, la variable globale est disponible + jusqu'à la prochaine requête. </para> <para> De plus, si vous enregistrez une nouvelle variable avec la fonction @@ -372,7 +333,7 @@ <literal>session_name=session_id</literal> ou une chaîne vide. <note> <para> - L'option <link linkend="ini.arg-separator.output"><option>arg_separator.output</option></link> + L'option <link linkend="ini.arg-separator.output">arg_separator.output</link> de &php.ini; vous permet de personnaliser le séparateur d'arguments. Pour être complètement en accord avec les spécifications XHTML, spécifiez &amp; ici. @@ -381,7 +342,7 @@ </para> <para> Alternativement, vous pouvez utiliser la constante <constant>SID</constant> - qui est toujours définie. Si le client n'envoie pas un cookie de session + qui est définie si la session a commencé. Si le client n'envoie pas un cookie de session approprié, il aura la forme <literal>session_name=session_id</literal>. Sinon, il vaudra une chaîne vide. Ainsi, vous pouvez dans tous les cas l'inclure dans l'URL.
http://cvs.php.net/diff.php/phpdoc-fr/reference/posix/functions/posix-mknod.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-fr/reference/posix/functions/posix-mknod.xml diff -u phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.1 phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.2 --- phpdoc-fr/reference/posix/functions/posix-mknod.xml:1.1 Sat Jul 9 08:54:04 2005 +++ phpdoc-fr/reference/posix/functions/posix-mknod.xml Sat Nov 26 10:25:36 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.posix-mknod"> <refnamediv> @@ -51,7 +51,8 @@ <term><parameter>major</parameter></term> <listitem> <para> - L'identifiant majeur du dispositif du noyau + L'identifiant majeur du dispositif du noyau (requis lorsque vous utilisez + <constant>S_IFCHR</constant> ou <constant>S_IFBLK</constant>). </para> </listitem> </varlistentry> @@ -59,7 +60,7 @@ <term><parameter>minor</parameter></term> <listitem> <para> - L'identifiant mineur du dispositif du noyau + L'identifiant mineur du dispositif du noyau (par défaut, 0). </para> </listitem> </varlistentry> @@ -84,10 +85,12 @@ <?php $file = '/tmp/tmpfile'; // nom du fichier -$type = POSIX_S_IFBLOCK; // type du fichier +$type = POSIX_S_IFBLK; // type du fichier $permissions = 0777; // octal +$major = 1; +$minor = 8; // /dev/random -if (!posix_mknod($file, $type | $permissions)) { +if (!posix_mknod($file, $type | $permissions, $major, $minor)) { die('Erreur : ' . posix_get_last_error() . ': ' . posix_strerror(posix_get_last_error())); } http://cvs.php.net/diff.php/phpdoc-fr/reference/session/functions/session-id.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-fr/reference/session/functions/session-id.xml diff -u phpdoc-fr/reference/session/functions/session-id.xml:1.14 phpdoc-fr/reference/session/functions/session-id.xml:1.15 --- phpdoc-fr/reference/session/functions/session-id.xml:1.14 Sat Jul 9 08:38:32 2005 +++ phpdoc-fr/reference/session/functions/session-id.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> @@ -20,9 +21,7 @@ <para> La constante <constant>SID</constant> peut également être utilisée pour lire le nom de la session courante et l'identifiant de session à fournir - dans les URL. Notez que <constant>SID</constant> est uniquement - défini si le client n'a pas envoyé le bon cookie. Voyez aussi <link - linkend="ref.session">Gestion de session</link>. + dans les URL. Voyez aussi <link linkend="ref.session">Gestion de session</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-fr/reference/session/functions/session-set-save-handler.xml?r1=1.17&r2=1.18&ty=u Index: phpdoc-fr/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.17 phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.18 --- phpdoc-fr/reference/session/functions/session-set-save-handler.xml:1.17 Sat May 14 13:53:54 2005 +++ phpdoc-fr/reference/session/functions/session-set-save-handler.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> +<!-- Reviewed: no --> + <refentry id="function.session-set-save-handler"> <refnamediv> <refname>session_set_save_handler</refname> @@ -54,6 +55,16 @@ converties en booléen avant d'être retournées au script. &true; pour la réussite, &false; pour l'échec. </para> + <warning> + <para> + Les gestionnaires d'écriture et de fermeture sont appelés après la destruction + des objets depuis &php; 5.0.5. Ces destructeurs peuvent utiliser les sessions + mais le gestionnaire de session ne peut pas utiliser les objets. Dans les versions + antérieures, ils étaient appelés dans l'ordre inverse. Il est possible d'appeler + <function>session_write_close</function> depuis le destructeur pour résoudre + ce problème. + </para> + </warning> <para> <example> <title> http://cvs.php.net/diff.php/phpdoc-fr/reference/session/ini.xml?r1=1.32&r2=1.33&ty=u Index: phpdoc-fr/reference/session/ini.xml diff -u phpdoc-fr/reference/session/ini.xml:1.32 phpdoc-fr/reference/session/ini.xml:1.33 --- phpdoc-fr/reference/session/ini.xml:1.32 Sat Sep 10 17:43:34 2005 +++ phpdoc-fr/reference/session/ini.xml Sat Nov 26 10:25:36 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.32 $ --> -<!-- EN-Revision: 1.35 Maintainer: dams Status: ready --> -<!-- Reviewed: yes --> +<!-- $Revision: 1.33 $ --> +<!-- EN-Revision: 1.36 Maintainer: dams Status: ready --> +<!-- Reviewed: no --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -335,6 +335,15 @@ et supprimées. </simpara> <note> + <para> + Si des scripts différents ont des valeurs différentes de + <literal>session.gc_maxlifetime</literal> mais partagent le même + endroit pour y stocker les données de session, alors, le script dont la valeur + est la plus petite effacera la donnée. Dans ce cas, utilisez cette directive + conjointement avec <link linkend="ini.session.save-path">session.save_path</link>. + </para> + </note> + <note> <simpara> Si vous utilisez le gestionnaire de sessions par fichier, qui est fourni par défaut votre système doit garder la trace des http://cvs.php.net/diff.php/phpdoc-fr/reference/session/reference.xml?r1=1.32&r2=1.33&ty=u Index: phpdoc-fr/reference/session/reference.xml diff -u phpdoc-fr/reference/session/reference.xml:1.32 phpdoc-fr/reference/session/reference.xml:1.33 --- phpdoc-fr/reference/session/reference.xml:1.32 Mon Sep 5 12:11:16 2005 +++ phpdoc-fr/reference/session/reference.xml Sat Nov 26 10:25:36 2005 @@ -1,9 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.32 $ --> -<!-- EN-Revision: 1.51 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.33 $ --> +<!-- EN-Revision: 1.55 Maintainer: yannick Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: core --> -<!-- Reviewed: yes --> +<!-- Reviewed: no --> <reference id="ref.session"> <title>Sessions</title> @@ -250,25 +250,6 @@ </para> </warning> <para> - <example> - <title> - Retirer une variable de session avec <varname>$_SESSION</varname> et - <link - linkend="ini.register-globals"><option>register_globals</option></link> - activé, après l'avoir enregistré avec <varname>$_SESSION</varname>. - </title> - <programlisting role="php"> -<![CDATA[ -<?php -session_start(); -// Avec PHP 4.3 et plus récent, vous pouvez simplement utiliser l'exemple précédent -session_unregister('compteur'); -?> -]]> - </programlisting> - </example> - </para> - <para> Si <link linkend="ini.register-globals"><literal>register_globals</literal></link> est activé, alors toutes les variables globales peuvent être enregistrées comme variables de session, et toutes les variables de @@ -280,7 +261,7 @@ ne nécessitent pas <function>session_register</function>. <caution> <para> - Avant &php; 4.3, si vous utilisez <varname>$_SESSION</varname> et que + Avant &php; 4.3, si vous utilisez <varname>$_SESSION</varname> et que vous avez désactivé <link linkend="ini.register-globals"><option>register_globals</option></link>, n'utilisez pas <function>session_register</function>, @@ -288,33 +269,11 @@ <function>session_unregister</function>. </para> <para> - Si vous activez <link - linkend="ini.register-globals"><literal>register_globals</literal></link>, - <function>session_unregister</function> doit être utilisé, car les - variables de sessions sont enregistrés comme variables globales lorsque - les données de sessions sont relues. Désactiver + Désactiver <link linkend="ini.register-globals"><literal>register_globals</literal></link> est recommandé pour des raisons de sécurité et de performances. </para> </caution> - <example> - <title> - Enregistrer une variable avec - <link linkend="ini.register-globals"><option>register_globals</option></link> - activé - </title> - <programlisting role="php"> -<![CDATA[ -<?php -if (! isset($_SESSION['compteur'])) { - $_SESSION['compteur'] = 1; -} else { - $_SESSION['compteur']++; -} -?> -]]> - </programlisting> - </example> </para> <para> Si <link @@ -322,7 +281,9 @@ est activé, alors les variables globales et les entrées dans le tableau <varname>$_SESSION</varname> seront des références sur la même valeur pour les valeurs qui auront été enregistrées avant le démarrage de la session - (donc, dans les page précédentes). + (donc, dans les page précédentes). Cependant, si la variable a été enregistrée + avec <varname>$_SESSION</varname>, alors, la variable globale est disponible + jusqu'à la prochaine requête. </para> <para> De plus, si vous enregistrez une nouvelle variable avec la fonction @@ -372,7 +333,7 @@ <literal>session_name=session_id</literal> ou une chaîne vide. <note> <para> - L'option <link linkend="ini.arg-separator.output"><option>arg_separator.output</option></link> + L'option <link linkend="ini.arg-separator.output">arg_separator.output</link> de &php.ini; vous permet de personnaliser le séparateur d'arguments. Pour être complètement en accord avec les spécifications XHTML, spécifiez &amp; ici. @@ -381,7 +342,7 @@ </para> <para> Alternativement, vous pouvez utiliser la constante <constant>SID</constant> - qui est toujours définie. Si le client n'envoie pas un cookie de session + qui est définie si la session a commencé. Si le client n'envoie pas un cookie de session approprié, il aura la forme <literal>session_name=session_id</literal>. Sinon, il vaudra une chaîne vide. Ainsi, vous pouvez dans tous les cas l'inclure dans l'URL.