cvs: phpdoc-fr /features commandline.xml connection-handling.xml cookies.xml file-upload.xml safe-mode.xml
| From: | Damien Seguy | Date: | Tue, 04 Feb 2003 17:46:31 +0000 |
| Subject: | cvs: phpdoc-fr /features commandline.xml connection-handling.xml cookies.xml file-upload.xml safe-mode.xml | ||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-203@lists.php.net to get a copy of this message | ||
dams Tue Feb 4 12:46:31 2003 EDT
Modified files:
/phpdoc-fr/features commandline.xml connection-handling.xml
cookies.xml file-upload.xml safe-mode.xml
Log:
early spring cleaning
Index: phpdoc-fr/features/commandline.xml diff -u phpdoc-fr/features/commandline.xml:1.3 phpdoc-fr/features/commandline.xml:1.4 --- phpdoc-fr/features/commandline.xml:1.3 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/commandline.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <chapter id="features.commandline"> <title>Utiliser PHP en ligne de commande</title> <!-- NEW DOCUMENTATION STARTS --> @@ -81,8 +81,9 @@ <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> <entry>0 (unlimited)</entry> <entry> - Etant donné les possibilités infinies de PHP en environnement shell, - le temps d'exécution maximal d'un script PHP a été rendu illimité. + Etant donné les possibilités infinies de PHP en + environnement shell, le temps d'exécution maximal d'un + script PHP a été rendu illimité. Alors que les scripts destinés au web doivent s'accomplir en une fraction de seconde, il arrive que les scripts shell requièrent bien plus de temps. @@ -92,11 +93,27 @@ <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry> <entry>&true;</entry> <entry> - Les variables globales de PHP <literal>$argc</literal> - (numbre d'arguments passés à l'application) et - <literal>$argv</literal> (tableau contenant les arguments passés à l'application) - sont toujours enregistré et rempli avec les données appropriées, lorsque - vous utilisez le <literal>CLI SAPI</literal>. + <para> + En donnant la valeur de &true; cette directive, vous aurez toujours + accs la variable <emphasis>argc</emphasis> (reprsentant le nombre + d'arguments passs l'application) et + <emphasis>argv</emphasis> (le tableau contenant les arguments passs) + dans le <literal>CLI SAPI</literal>. + </para> + <para> + Depuis &php; 4.3.0, les variables <varname>$argc</varname> + et <varname>$argv</varname> sont dfinies et remplies avec les valeurs + appropries, en utilisant <literal>CLI SAPI</literal>. Avant cette version, + la cration de ces variables tait lie au comportement des versions + <literal>CGI</literal> et <literal>MODULE</literal>, qui requirent l'activation + de la directive &php; + <link linkend="ini.register-globals">register_globals</link>. + Indpendamment de la version ou de la valeur de register_globals, + vous pouvez toujour accder + <link linkend="reserved.variables.server"><varname>$_SERVER</varname></link> et + <varname>$HTTP_SERVER_VARS</varname>. Par exemple: + <varname>$_SERVER['argv']</varname> + </para> </entry> </row> </tbody> Index: phpdoc-fr/features/connection-handling.xml diff -u phpdoc-fr/features/connection-handling.xml:1.11 phpdoc-fr/features/connection-handling.xml:1.12 --- phpdoc-fr/features/connection-handling.xml:1.11 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/connection-handling.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="features.connection-handling"> <title>Gestion des connexions</title> <note> @@ -30,12 +30,13 @@ <simpara> Vous pouvez en outre décider si vous voulez que la déconnexion d'un client provoque l'arrêt de votre - script. Il est parfois pratique de terminer le script, même - si le client n'est plus là pour recevoir les informations. - Cependant, par défaut, le script sera interrompu, et terminé - dès que le client se déconnecte. Ce comportement peut - être modifié avec la directive ignore_user_abort dans le - fichier &php.ini ou bien avec la directive Apache + script. Il est parfois pratique que vos scripts continuent + à s'exécuter jusqu'à la fin, même si le client n'est plus là + pour recevoir les informations. Cependant, par défaut, le script + s'arrêtera dès que le client se déconnecte. + Ce comportement peut + être modifié avec la directive <parameter>ignore_user_abort</parameter> + dans le fichier &php.ini ou bien avec la directive Apache <parameter>ignore_user_abort</parameter> du fichier Apache <filename>httpd.conf</filename> ou avec la fonction <function>ignore_user_abort</function>. Si vous Index: phpdoc-fr/features/cookies.xml diff -u phpdoc-fr/features/cookies.xml:1.8 phpdoc-fr/features/cookies.xml:1.9 --- phpdoc-fr/features/cookies.xml:1.8 Wed Dec 12 15:48:50 2001 +++ phpdoc-fr/features/cookies.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="features.cookies"> <title>Cookies</title> <para> @@ -20,6 +20,20 @@ au nom du cookie. Pour plus détails, reportez-vous à la fonction <function>setcookie</function>. </para> + + <para> + En PHP 4.1.0 et plus rcent, le tableau superglobal + <varname>$_COOKIE</varname> sera aussi prdfini avec les cookies transmis + par l'internaute. <varname>$HTTP_COOKIE_VARS</varname> est aussi prdfini dans + les versions de &php; plus anciennes, lorsque la directive + <literal>track_vars</literal> est active. + </para> + + <para> + Pour plus de dtails, y compris des notes sur les bogues des navigateurs, + voyez la fonction <function>setcookie</function>. + </para> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/features/file-upload.xml diff -u phpdoc-fr/features/file-upload.xml:1.14 phpdoc-fr/features/file-upload.xml:1.15 --- phpdoc-fr/features/file-upload.xml:1.14 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/file-upload.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> +<!-- $Revision: 1.15 $ --> <chapter id="features.file-upload"> <title>Gestion des chargements de fichier</title> <sect1 id="features.file-upload.post-method"> @@ -170,14 +170,22 @@ <programlisting role="php"> <![CDATA[ <?php -// En PHP < 4.1.0, $HTTP_POST_FILES doit être utilisé à la place de $_FILES. -if (is_uploaded_file($_FILES['userfile']['tmp_name'])) { - copy($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); +// En PHP < 4.1.0, $HTTP_POST_FILES doit être utilisé +// à la place de $_FILES. +// En PHP plus ancien que 4.0.3, utilisez copy() et is_uploaded_file() +// à la place de move_uploaded_file + +$uploaddir = '/var/www/uploads/'; + +print "<pre>"; +if (move_uploaded_file($_FILES['userfile']['tmp_name'], $uploaddir . $_FILES['userfile']['name'])) { + print "Le fichier est valide, et a t tlcharg + avec succs. Voici plus d'informations :\n"; + print_r($_FILES); } else { - echo "Attaque par upload potentielle le fichier : " . $_FILES['userfile']['name']; + echo "Attaque par upload potentielle. Voici plus d'informations :\n"; + print_r($_FILES); } -/* ...ou bien... */ -move_uploaded_file($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); ?> ]]> </programlisting> @@ -355,6 +363,41 @@ </sect1> <sect1 id="features.file-upload.put-method"> <title>Chargement par méthode PUT </title> + <simpara> + Le suppor de la mthode PUT a t modifi entre PHP 3 et PHP 4. + En PHP 4, il faut utiliser le flt d'entre standard pour recevoir + le contenu du fichier. + </simpara> + <para> + <example> + <title>Sauver un fichier par mthode PUT en PHP 4</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Les donnes via la mthode PUT arrivent dans stdin */ +$putdata = fopen("php://stdin","r"); + +/* Ouvre un fichier pour criture */ +$fp = fopen("myputfile.ext","w"); + +/* Lit les donnes par bloc de 1ko + et les crit dans le fichier */ +while ($data = fread($putdata,1024)) + fwrite($fp,$data); + +/* Ferme les flts */ +fclose($fp); +fclose($putdata); +?> +]]> + </programlisting> + </example> + </para> + <note> + <para> + Toute la documentation ci-dessous s'applique &php; 3 uniquement. + </para> + </note> <para> PHP supporte la méthode HTTP PUT utilisée par les navigateurs tels que Netscape Composer et W3C Amaya. Les Index: phpdoc-fr/features/safe-mode.xml diff -u phpdoc-fr/features/safe-mode.xml:1.7 phpdoc-fr/features/safe-mode.xml:1.8 --- phpdoc-fr/features/safe-mode.xml:1.7 Mon Feb 3 07:54:12 2003 +++ phpdoc-fr/features/safe-mode.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <chapter id="features.safe-mode"> <title>Safe mode</title> @@ -283,7 +283,7 @@ ?> ]]> </programlisting> - générera cette erreur, si le &safemode; est activé : + générera cette erreur, si le Safe Mode est activé : <screen> <![CDATA[ Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not
Index: phpdoc-fr/features/commandline.xml diff -u phpdoc-fr/features/commandline.xml:1.3 phpdoc-fr/features/commandline.xml:1.4 --- phpdoc-fr/features/commandline.xml:1.3 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/commandline.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <chapter id="features.commandline"> <title>Utiliser PHP en ligne de commande</title> <!-- NEW DOCUMENTATION STARTS --> @@ -81,8 +81,9 @@ <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> <entry>0 (unlimited)</entry> <entry> - Etant donné les possibilités infinies de PHP en environnement shell, - le temps d'exécution maximal d'un script PHP a été rendu illimité. + Etant donné les possibilités infinies de PHP en + environnement shell, le temps d'exécution maximal d'un + script PHP a été rendu illimité. Alors que les scripts destinés au web doivent s'accomplir en une fraction de seconde, il arrive que les scripts shell requièrent bien plus de temps. @@ -92,11 +93,27 @@ <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry> <entry>&true;</entry> <entry> - Les variables globales de PHP <literal>$argc</literal> - (numbre d'arguments passés à l'application) et - <literal>$argv</literal> (tableau contenant les arguments passés à l'application) - sont toujours enregistré et rempli avec les données appropriées, lorsque - vous utilisez le <literal>CLI SAPI</literal>. + <para> + En donnant la valeur de &true; cette directive, vous aurez toujours + accs la variable <emphasis>argc</emphasis> (reprsentant le nombre + d'arguments passs l'application) et + <emphasis>argv</emphasis> (le tableau contenant les arguments passs) + dans le <literal>CLI SAPI</literal>. + </para> + <para> + Depuis &php; 4.3.0, les variables <varname>$argc</varname> + et <varname>$argv</varname> sont dfinies et remplies avec les valeurs + appropries, en utilisant <literal>CLI SAPI</literal>. Avant cette version, + la cration de ces variables tait lie au comportement des versions + <literal>CGI</literal> et <literal>MODULE</literal>, qui requirent l'activation + de la directive &php; + <link linkend="ini.register-globals">register_globals</link>. + Indpendamment de la version ou de la valeur de register_globals, + vous pouvez toujour accder + <link linkend="reserved.variables.server"><varname>$_SERVER</varname></link> et + <varname>$HTTP_SERVER_VARS</varname>. Par exemple: + <varname>$_SERVER['argv']</varname> + </para> </entry> </row> </tbody> Index: phpdoc-fr/features/connection-handling.xml diff -u phpdoc-fr/features/connection-handling.xml:1.11 phpdoc-fr/features/connection-handling.xml:1.12 --- phpdoc-fr/features/connection-handling.xml:1.11 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/connection-handling.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="features.connection-handling"> <title>Gestion des connexions</title> <note> @@ -30,12 +30,13 @@ <simpara> Vous pouvez en outre décider si vous voulez que la déconnexion d'un client provoque l'arrêt de votre - script. Il est parfois pratique de terminer le script, même - si le client n'est plus là pour recevoir les informations. - Cependant, par défaut, le script sera interrompu, et terminé - dès que le client se déconnecte. Ce comportement peut - être modifié avec la directive ignore_user_abort dans le - fichier &php.ini ou bien avec la directive Apache + script. Il est parfois pratique que vos scripts continuent + à s'exécuter jusqu'à la fin, même si le client n'est plus là + pour recevoir les informations. Cependant, par défaut, le script + s'arrêtera dès que le client se déconnecte. + Ce comportement peut + être modifié avec la directive <parameter>ignore_user_abort</parameter> + dans le fichier &php.ini ou bien avec la directive Apache <parameter>ignore_user_abort</parameter> du fichier Apache <filename>httpd.conf</filename> ou avec la fonction <function>ignore_user_abort</function>. Si vous Index: phpdoc-fr/features/cookies.xml diff -u phpdoc-fr/features/cookies.xml:1.8 phpdoc-fr/features/cookies.xml:1.9 --- phpdoc-fr/features/cookies.xml:1.8 Wed Dec 12 15:48:50 2001 +++ phpdoc-fr/features/cookies.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="features.cookies"> <title>Cookies</title> <para> @@ -20,6 +20,20 @@ au nom du cookie. Pour plus détails, reportez-vous à la fonction <function>setcookie</function>. </para> + + <para> + En PHP 4.1.0 et plus rcent, le tableau superglobal + <varname>$_COOKIE</varname> sera aussi prdfini avec les cookies transmis + par l'internaute. <varname>$HTTP_COOKIE_VARS</varname> est aussi prdfini dans + les versions de &php; plus anciennes, lorsque la directive + <literal>track_vars</literal> est active. + </para> + + <para> + Pour plus de dtails, y compris des notes sur les bogues des navigateurs, + voyez la fonction <function>setcookie</function>. + </para> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/features/file-upload.xml diff -u phpdoc-fr/features/file-upload.xml:1.14 phpdoc-fr/features/file-upload.xml:1.15 --- phpdoc-fr/features/file-upload.xml:1.14 Thu Jan 30 08:44:04 2003 +++ phpdoc-fr/features/file-upload.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> +<!-- $Revision: 1.15 $ --> <chapter id="features.file-upload"> <title>Gestion des chargements de fichier</title> <sect1 id="features.file-upload.post-method"> @@ -170,14 +170,22 @@ <programlisting role="php"> <![CDATA[ <?php -// En PHP < 4.1.0, $HTTP_POST_FILES doit être utilisé à la place de $_FILES. -if (is_uploaded_file($_FILES['userfile']['tmp_name'])) { - copy($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); +// En PHP < 4.1.0, $HTTP_POST_FILES doit être utilisé +// à la place de $_FILES. +// En PHP plus ancien que 4.0.3, utilisez copy() et is_uploaded_file() +// à la place de move_uploaded_file + +$uploaddir = '/var/www/uploads/'; + +print "<pre>"; +if (move_uploaded_file($_FILES['userfile']['tmp_name'], $uploaddir . $_FILES['userfile']['name'])) { + print "Le fichier est valide, et a t tlcharg + avec succs. Voici plus d'informations :\n"; + print_r($_FILES); } else { - echo "Attaque par upload potentielle le fichier : " . $_FILES['userfile']['name']; + echo "Attaque par upload potentielle. Voici plus d'informations :\n"; + print_r($_FILES); } -/* ...ou bien... */ -move_uploaded_file($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); ?> ]]> </programlisting> @@ -355,6 +363,41 @@ </sect1> <sect1 id="features.file-upload.put-method"> <title>Chargement par méthode PUT </title> + <simpara> + Le suppor de la mthode PUT a t modifi entre PHP 3 et PHP 4. + En PHP 4, il faut utiliser le flt d'entre standard pour recevoir + le contenu du fichier. + </simpara> + <para> + <example> + <title>Sauver un fichier par mthode PUT en PHP 4</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Les donnes via la mthode PUT arrivent dans stdin */ +$putdata = fopen("php://stdin","r"); + +/* Ouvre un fichier pour criture */ +$fp = fopen("myputfile.ext","w"); + +/* Lit les donnes par bloc de 1ko + et les crit dans le fichier */ +while ($data = fread($putdata,1024)) + fwrite($fp,$data); + +/* Ferme les flts */ +fclose($fp); +fclose($putdata); +?> +]]> + </programlisting> + </example> + </para> + <note> + <para> + Toute la documentation ci-dessous s'applique &php; 3 uniquement. + </para> + </note> <para> PHP supporte la méthode HTTP PUT utilisée par les navigateurs tels que Netscape Composer et W3C Amaya. Les Index: phpdoc-fr/features/safe-mode.xml diff -u phpdoc-fr/features/safe-mode.xml:1.7 phpdoc-fr/features/safe-mode.xml:1.8 --- phpdoc-fr/features/safe-mode.xml:1.7 Mon Feb 3 07:54:12 2003 +++ phpdoc-fr/features/safe-mode.xml Tue Feb 4 12:46:31 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <chapter id="features.safe-mode"> <title>Safe mode</title> @@ -283,7 +283,7 @@ ?> ]]> </programlisting> - générera cette erreur, si le &safemode; est activé : + générera cette erreur, si le Safe Mode est activé : <screen> <![CDATA[ Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not