cvs: phpdoc-fr /features commandline.xml connection-handling.xml error-handling.xml file-upload.xml http-auth.xml images.xml remote-files.xml
safe-mode.xml
| From: | Damien Seguy | Date: | Thu, 30 Jan 2003 13:44:04 +0000 |
| Subject: | cvs: phpdoc-fr /features commandline.xml connection-handling.xml error-handling.xml file-upload.xml http-auth.xml images.xml remote-files.xml safe-mode.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-175@lists.php.net to get a copy of this message | ||
dams Thu Jan 30 08:44:04 2003 EDT
Modified files:
/phpdoc-fr/features commandline.xml connection-handling.xml
error-handling.xml file-upload.xml
http-auth.xml images.xml remote-files.xml
safe-mode.xml
Log:
late winter update
Index: phpdoc-fr/features/commandline.xml diff -u phpdoc-fr/features/commandline.xml:1.2 phpdoc-fr/features/commandline.xml:1.3 --- phpdoc-fr/features/commandline.xml:1.2 Mon Aug 19 21:30:16 2002 +++ phpdoc-fr/features/commandline.xml Thu Jan 30 08:44:04 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <chapter id="features.commandline"> <title>Utiliser PHP en ligne de commande</title> <!-- NEW DOCUMENTATION STARTS --> <para> - Depuis la version 4.3, <literal>PHP</literal> supporte un nouveau type + Depuis la version 4.3, &php; supporte un nouveau type de <literal>SAPI</literal> (Server Application Programming Interface, c'est à dire Interface de Programmation d'Applications Serveur) appelé <literal>CLI</literal>, ce qui signifie <emphasis>Command Line Interface</emphasis> @@ -135,7 +135,9 @@ Un descripteur de fichier déjà disponible vers <literal>stdin</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stdin = fopen('php://stdin', 'r'); +]]> </programlisting> </entry> </row> @@ -145,17 +147,21 @@ Un descripteur de fichier déjà disponible vers <literal>stdout</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stdout = fopen('php://stdout', 'w'); +]]> </programlisting> </entry> </row> <row> <entry><constant>STDERR</constant></entry> <entry> - Un descripteur de fichier déjà disponible vers <literal>stdout</literal>. - Cela évite de l'ouvrir avec + Un descripteur de fichier déjà disponible vers + <literal>stderr</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stderr = fopen('php://stderr', 'w'); +]]> </programlisting> </entry> </row> @@ -168,7 +174,9 @@ vers <literal>stderr</literal> par vous-même, mais vous pouvez utiliser cette constante directement, comme un descripteur de fichier : <programlisting role="php"> +<![CDATA[ php -r 'fwrite(STDERR, "stderr\n");' +]]> </programlisting> Vous n'avez pas non plus à fermer explicitement ces fichiers, PHP s'en chargera automatiquement. @@ -201,7 +209,7 @@ /tmp/autre_dossier ]]> </screen> - Cela monter clairement que <literal>PHP</literal> modifie le dossier + Cela monter clairement que &php; modifie le dossier courant, et utilise le dossier du script exécuté. </para> <para> @@ -216,7 +224,7 @@ ]]> </screen> Cela donne beaucoup plus de souplesse lorsque vous rédigez des - scripts shell avec <literal>PHP</literal>. + scripts shell avec &php;. </para> <note> <para> @@ -229,8 +237,8 @@ </itemizedlist> </para> <para> - La liste des options de ligne de commande fournies par <literal>PHP</literal> - est disponible en exécutant <literal>PHP</literal> avec l'option <literal>-h</literal> : + La liste des options de ligne de commande fournies par &php; + est disponible en exécutant &php; avec l'option <literal>-h</literal> : <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -262,7 +270,7 @@ <orderedlist> <listitem> <para> - Indiquer à <literal>PHP</literal> d"exécuter un fichier : + Indiquer à &php; d'exécuter un fichier : </para> <para> <screen> @@ -281,7 +289,7 @@ </listitem> <listitem> <para> - Donner du code <literal>PHP</literal> à exécuter directement en ligne de commande. + Donner du code &php; à exécuter directement en ligne de commande. </para> <para> <screen> @@ -303,12 +311,12 @@ </listitem> <listitem> <para> - Donner du code <literal>PHP</literal> dans l'entrée standard + Donner du code &php; dans l'entrée standard (<literal>stdin</literal>). </para> <para> Cela donne la possibilité de créer dynamiquement du code - <literal>PHP</literal>, puis de le fournir à PHP, et enfin, + &php;, puis de le fournir à PHP, et enfin, de le traiter à nouveau en shell. Voici un exemple fictif : <screen> <![CDATA[ @@ -321,7 +329,7 @@ Il n'est pas possible de combiner ces trois modes d'exécution. </para> <para> - Comme toute application shell, l'exécutable <literal>PHP</literal> accepte + Comme toute application shell, l'exécutable &php; accepte des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments n'est pas limité par PHP, mais par le shell, qui a une limite en terme de nombre de caractères qui peuvent être passés. Généralement, vous n'atteidrez @@ -338,7 +346,7 @@ Tant que les arguments que vous passez à votre script ne commencent pas par le caractère <literal>-</literal>, il n'y a rien de spécial à surveiller. Si vous passez des arguments à voter script qui commencent par - <literal>-</literal>, cela posera des problèmes car <literal>PHP</literal> + <literal>-</literal>, cela posera des problèmes car &php; va penser qu'il doit les interpréter. Pour éviter cela, utilisez le séparateur <literal>--</literal>. Après cet argument, tous les arguments suivants seront passés à votre script sans être modifié ou analysé par PHP. @@ -615,7 +623,7 @@ <entry>-i</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et - affiche le résultat. Si <literal>PHP</literal> ne fonctionne pas + affiche le résultat. Si &php; ne fonctionne pas correctement, il est recommandé d'utiliser la commande <literal>php -i</literal> et de voir si il n'y a pas d'erreurs affichées avant ou après la table d'information. N'oubliez pas que le résutltat de cette @@ -627,8 +635,8 @@ <entry>-r</entry> <entry> <para> - Cette option permet l'exécution de <literal>PHP</literal> directement - dans la ligne de commande. Les balises de <literal>PHP</literal> + Cette option permet l'exécution de &php; directement + dans la ligne de commande. Les balises de &php; (<literal><?php</literal> et <literal>?></literal>) <emphasis role="strong">ne sont pas</emphasis> demandées, et coauseront une erreur d'analyse. @@ -636,7 +644,7 @@ <note> <para> De l'attention doit être portée lors de l'utilisation de cette option - de <literal>PHP</literal>, pour qu'il n'y ait pas de collision avec + de &php;, pour qu'il n'y ait pas de collision avec les substitutions de variables en lignes de commande, réalisées par le shell. </para> Index: phpdoc-fr/features/connection-handling.xml diff -u phpdoc-fr/features/connection-handling.xml:1.10 phpdoc-fr/features/connection-handling.xml:1.11 --- phpdoc-fr/features/connection-handling.xml:1.10 Wed Dec 12 15:48:49 2001 +++ phpdoc-fr/features/connection-handling.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <chapter id="features.connection-handling"> <title>Gestion des connexions</title> <note> @@ -35,7 +35,7 @@ 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 <filename>php.ini</filename> ou bien avec la directive Apache + 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 @@ -56,11 +56,12 @@ &true; si la connexion a été annulée. </simpara> <simpara> - Votre script peut aussi expirer après un laps de temps. + Votre script peut aussi être automatiquement interrompu + après une certaine durée de temps. Par défaut, le délai est de 30 secondes. Cette valeur peut être changée en utilisant la directive PHP <parameter>max_execution_time</parameter> dans le fichier - <filename>php.ini</filename> ou avec la directive + &php.ini; ou avec la directive <parameter>php3_max_execution_time</parameter>, dans le fichier Apache <filename>.conf</filename> ou encore avec la fonction <function>set_time_limit</function>. Index: phpdoc-fr/features/error-handling.xml diff -u phpdoc-fr/features/error-handling.xml:1.9 phpdoc-fr/features/error-handling.xml:1.10 --- phpdoc-fr/features/error-handling.xml:1.9 Wed Dec 12 15:48:50 2001 +++ phpdoc-fr/features/error-handling.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <chapter id="features.error-handling"> <title>Gestion des erreurs</title> <para> @@ -36,7 +36,7 @@ </row> <row> <entry>8</entry> - <entry>E_NOTICE </entry> + <entry>E_NOTICE</entry> <entry> Notes d'exécution (moins critique que les alertes) </entry> @@ -103,7 +103,7 @@ <link linkend="language.operators.bitwise">opérateurs de bits</link> pour combiner ces valeurs et conserver uniquement celle qui vous intéresse. Notez que seuls, '|', '~', '!', et '&' seront - utilisables dans <filename>php.ini</filename>, et qu'aucun opérateur + utilisables dans &php.ini;, et qu'aucun opérateur ne sera utilisable dans <filename>php3.ini</filename>. </para> <para> @@ -120,7 +120,7 @@ doit être numérique, c'est-à-dire <literal>7</literal>. </para> <para> - La valeur initiale peut être modifiée dans le fichier <filename>php.ini</filename>, + La valeur initiale peut être modifiée dans le fichier &php.ini;, avec la directive <link linkend="ini.error-reporting">error_reporting</link>, dans le fichier de configuration d'Apache @@ -173,67 +173,69 @@ <example> <title>Utiliser le contrôle d'erreur dans un script</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Nous effectuons nous-même notre contrôle d'erreur. error_reporting(0); // Fonction de gestion des erreurs utilisateur function usererrorhandler($errno, $errmsg, $filename, $linenum, $vars) { // timestamp pour dater l'erreur - $dt = date("Y-m-d H:i:s (T)"); + $dt = date("Y-m-d H:i:s (T)"); // definit un tableau associatif avec les chaînes d'erreur // en réalité, les seules entrées que nous considérerons // seront 2,8,256,512 et 1024 $errortype = array( - 1 => "Erreur", - 2 => "Alerte", - 4 => "Erreur d'analyse", - 8 => "Note", - 16 => "Erreur interne", - 32 => "Alerte interne", - 64 => "Erreur de compilation", - 128 => "Alerte de compilation", - 256 => "Erreur utilisateur", - 512 => "Alerte utilisateur", - 1024=> "Note utilisateur" + 1 => "Erreur", + 2 => "Alerte", + 4 => "Erreur d'analyse", + 8 => "Note", + 16 => "Erreur interne", + 32 => "Alerte interne", + 64 => "Erreur de compilation", + 128 => "Alerte de compilation", + 256 => "Erreur utilisateur", + 512 => "Alerte utilisateur", + 1024=> "Note utilisateur" ); // ensemble d'erreur pour lesquelles une trace sera conservée $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); - $err = "<errorentry>\n"; - $err .= "\t<datetime>".$dt."</datetime>\n"; - $err .= "\t<errornum>".$errno."</errnumber>\n"; - $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n"; - $err .= "\t<errormsg>".$errmsg."</errormsg>\n"; - $err .= "\t<scriptname>".$filename."</scriptname>\n"; - $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n"; + $err = "<errorentry>\n"; + $err .= "\t<datetime>".$dt."</datetime>\n"; + $err .= "\t<errornum>".$errno."</errnumber>\n"; + $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n"; + $err .= "\t<errormsg>".$errmsg."</errormsg>\n"; + $err .= "\t<scriptname>".$filename."</scriptname>\n"; + $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n"; if (in_array($errno, $user_errors)) - $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n"; - $err .= "</errorentry>\n\n"; + $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n"; + $err .= "</errorentry>\n\n"; // pour test // echo $err; // sauve l'erreur dans le fichier, et emaile moi si l'erreur est critique - error_log($err, 3, "/usr/local/php4/error.log"); + error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) - mail("phpdev@mydomain.com","Critical User Error",$err); + mail("phpdev@mydomain.com","Critical User Error",$err); } + function distance($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { - trigger_error("Paramètres incorrects : arrays attendus", E_USER_ERROR); + trigger_error("Paramètres incorrects : arrays attendus", E_USER_ERROR); return NULL; } if (count($vect1) != count($vect2)) { - trigger_error("Les vecteurs doivent être de la même taille", E_USER_ERROR); + trigger_error("Les vecteurs doivent être de la même taille", E_USER_ERROR); return NULL; } for ($i=0; $i<count($vect1); $i++) { $c1 = $vect1[$i]; $c2 = $vect2[$i]; $d = 0.0; if (!is_numeric($c1)) { - trigger_error("La coordonnée $i du vecteur 1 n'est pas un nombre. Remplacée par zéro", + trigger_error("La coordonnée $i du vecteur 1 n'est pas un nombre. Remplacée par zéro", E_USER_WARNING); $c1 = 0.0; } if (!is_numeric($c2)) { - trigger_error("La coordonnée $i du vecteur 2 n'est pas un nombre. Remplacée par zéro", + trigger_error("La coordonnée $i du vecteur 2 n'est pas un nombre. Remplacée par zéro", E_USER_WARNING); $c2 = 0.0; } @@ -241,31 +243,34 @@ } return sqrt($d); } -$old_error_handler = set_error_handler("userErrorHandler"); + +$old_error_handler = set_error_handler("userErrorHandler"); // Constante indéfinie, génère une alerte $t = I_AM_NOT_DEFINED; -// definition de quelques "vecteurs" -$a = array(2,3,"bla"); +// definition de quelques "vecteurs" +$a = array(2,3,"bla"); $b = array(5.5, 4.3, -1.6); $c = array(1,-3); // génère une erreur utilisateur -$t1 = distance($c,$b)."\n"; +$t1 = distance($c,$b)."\n"; // génère une autre erreur utilisateur -$t2 = distance($b,"i am not an array")."\n"; +$t2 = distance($b,"Je ne suis pas un tableau")."\n"; // génère une alerte -$t3 = distance($a,$b)."\n"; -?> +$t3 = distance($a,$b)."\n"; +?> +]]> </programlisting> </example> Ceci est un exemple simple, qui montre comment utiliser les fonctions de <link linkend="ref.errorfunc">Gestions des erreurs</link>. </para> <para> - Voir aussi <function>error_reporting</function>, + Voir aussi + <function>error_reporting</function>, <function>error_log</function>, <function>set_error_handler</function>, <function>restore_error_handler</function>, - <function>trigger_error</function>, + <function>trigger_error</function> et <function>user_error</function> </para> </chapter> Index: phpdoc-fr/features/file-upload.xml diff -u phpdoc-fr/features/file-upload.xml:1.13 phpdoc-fr/features/file-upload.xml:1.14 --- phpdoc-fr/features/file-upload.xml:1.13 Tue Jan 29 18:18:14 2002 +++ phpdoc-fr/features/file-upload.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <chapter id="features.file-upload"> <title>Gestion des chargements de fichier</title> <sect1 id="features.file-upload.post-method"> @@ -14,6 +14,16 @@ de manipulation des fichiers, vous avez un contrôle total sur le chargement et la gestion des fichiers chargés. </simpara> + <note> + <title>Notes de configuration</title> + <para> + Voir aussi les directives + <link linkend="ini.file-uploads">file_uploads</link>, + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, + <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> et + <link linkend="ini.post-max-size">post_max_size</link>, dans &php.ini; + </para> + </note> <para> Notez bien que PHP supporte aussi le chargement par la méthode PUT comme dans le navigateur Netscape Composer @@ -22,180 +32,157 @@ méthode PUT</link>. </para> <para> - Un écran de chargement de fichiers peut être constitué - en créant un formulaire de la manière suivante : - <example> + Un écran de chargement de fichiers peut être constitué + en créant un formulaire de la manière suivante : + <example> <title>Formulaire de chargement de fichier</title> <programlisting role="html"> -<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD="POST"> -<INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000"> -Envoyez ce fichier : <INPUT NAME="userfile" TYPE="file"> -<INPUT TYPE="submit" VALUE="Send File"> -</FORM> + <![CDATA[ +<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD="POST"> +<INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000"> +Envoyez ce fichier : <INPUT NAME="userfile" TYPE="file"> +<INPUT TYPE="submit" VALUE="Send File"> +</FORM> +]]> </programlisting> - </example> + </example> Le paramètre _URL_ doit pointer sur un fichier PHP. L'option MAX_FILE_SIZE cachée doit précéder le nom du fichier à charger, et représente la taille maximale du fichier à charger. La valeur est donnée en octets. Dans ce script, les valeurs suivantes doivent être - définies pour assurer un chargement correct : + définies pour assurer un chargement correct. + </para> + <warning> + <para> + Le champs MAX_FILE_SIZE est là à titre de conseil au navigateur. + Il est très facile de contourner cette restriction. Ne comptez pas + sur le respect de cette configuration par le navigateur! La configuration + de &php; sur la taille maximale à respecter (<link linkend="ini.upload-max-filesize">upload_max_filesize</link>) + ne peut être contournée, elle. + </para> + </warning> + <para> + Les variables définies après un téléchargement de fichiers diffèrent + beaucoup de version en version. La variable + <link linkend="reserved.variables.files">$_FILES</link> + existe depuis PHP 4.1.0. Le tableau <varname>$HTTP_POST_FILES</varname> + existe depuis PHP 4.0.0. Ces tableaux contiennent toutes les données + sur les fichiers téléchargés. L'utilisation de la variable <varname>$_FILES</varname> + est recommandée. Si la directive &php; + <link linkend="ini.register-globals">register_globals</link> vaut + <emphasis>on</emphasis>, les variables reliées existeront aussi. + <link linkend="ini.register-globals">register_globals</link> + vaut par défaut <emphasis>off</emphasis> depuis &php; + <ulink url="&url.php.release4.2.0;">4.2.0</ulink>. </para> - <para> - En PHP 3, les variables suivantes seront définies dans - le script de destination, en cas de téléchargement réussi, et en - supposant que <link linkend="ini.register-globals">register_globals</link> - est activé dans le fichier <filename>php.ini</filename>. Si <link - linkend="ini.track-vars">track_vars</link> est activé, elles seront aussi - disponibles dans le dossier <varname>$HTTP_POST_VARS</varname>. - Notez que les noms des variables suivantes supposent que nom du - fichier téléchargé est 'userfile', comme - présenté dans l'exemple ci-dessus. - <itemizedlist> - <listitem> - <simpara> - <varname>$userfile</varname> - Le nom temporaire du fichier qui - sera chargé sur la machine serveur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_name</varname> - Le nom du fichier original - sur le système de l'envoyeur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_size</varname> - La taille du fichier envoyé - en octets. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_type</varname> - Le type MIME du fichier, si - le navigateur a fourni cette information. Par exemple, - <literal>"image/gif"</literal>. - </simpara> - </listitem> - </itemizedlist> - Notez que "$userfile" prend la valeur qui est passée dans - le champs INPUT de type TYPE=file. Dans l'exemple ci-dessus, - nous avons choisi de l'appeler "userfile". - </para> - <para> - En PHP 4, le comportement est légèrement différent, car c'est la - variable d'environnement <varname>$HTTP_POST_FILES</varname>, qui - contiendra les informations sur les fichiers téléchargés. - Ces informations sont disponibles dans si l'option - <link linkend="ini.track-vars">track_vars</link> est activée, mais - <link linkend="ini.track-vars">track_vars</link> est toujours - activée dans les versions de PHP supérieures à la version - 4.0.2. - </para> - <para> - Le contenu du tableau <varname>$HTTP_POST_FILES</varname> décrit - ci-dessous. Notez que l'on suppose ici que le nom du fichier - téléchargé est '<literal>userfile</literal>', - comme présenté dans l'exemple ci-dessus : + <para> + Le contenu du tableau <link linkend="reserved.variables.files">$_FILES</link> + est détaillé dans notre exmple ci-dessous. Notez que l'un suppose que le nom + de la variable du fichier téléchargé est <emphasis>userfile</emphasis>, tel que + défini dans le formulaire ci-dessus. <variablelist> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['name']</varname></term> + <term><varname>$_FILES['userfile']['name']</varname></term> <listitem> <para> - Le nom du fichier original sur la machine source. + Le nom original du fichier, tel que sur la machine du client web. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['type']</varname></term> + <term><varname>$_FILES['userfile']['type']</varname></term> <listitem> <para> - Le type MIME du fichier, si le navigateur a fourni cette information. - Par exemple, <literal>"image/gif"</literal>. + Le type MIME du fichier, si le navigateur a fourni cette information. + Par exemple, cela pourra être <literal>"image/gif"</literal>. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['size']</varname></term> + <term><varname>$_FILES['userfile']['size']</varname></term> <listitem> <para> - La taille du fichier envoyé, en octets. + La taille, en octets, du fichier téléchargé. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['tmp_name']</varname></term> + <term><varname>$_FILES['userfile']['tmp_name']</varname></term> <listitem> <para> - Le nom temporaire du fichier qui sera chargé sur la machine serveur. + Le nom temporaire du fichier qui sera chargé sur la machine serveur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>$_FILES['userfile']['error']</varname></term> + <listitem> + <para> + Le code d'erreur <link linkend="features.file-upload.errors">error code</link> + associaé au téléchargement de fichier. <emphasis>['error']</emphasis> + a été introduit en PHP 4.2.0 </para> </listitem> </varlistentry> </variablelist> </para> + <note> + <para> + Dans les versions de &php; antérieure à la version 4.1.0, la variable + <varname>$_FILES</varname> s'appelait <varname>$HTTP_POST_FILES</varname> et + ce n'était pas une variable + <link linkend="language.variables.superglobals">autoglobale</link> + comme l'est <varname>$_FILES</varname>. PHP 3 ne supporte pas + <varname>$HTTP_POST_FILES</varname>. + </para> + </note> <para> - Les fichiers seront enregistrés par défaut dans le dossier - des fichiers temporaires, à moins qu'un autre dossier - n'ait été fourni avec la directive de configuration - <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> du fichier - <filename>php.ini</filename>. Le dossier par défaut du serveur - peut être modifié grâce à la variable d'environnement - <envar>TMPDIR</envar>, de l'utilisateur qui exécute PHP. - Sa modification avec <function>putenv</function> depuis un script PHP - ne fonctionnera pas. Cette variable d'environnement peut aussi être - utilisée pour s'assurer que d'autres opérations fonctionnent avec - les fichiers téléchargés. + Lorsque <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>on</emphasis> dans le &php.ini;, des variables supplémentaires + sont rendues disponibles. Par exemple + <varname>$userfile_name</varname> vaut + <varname>$_FILES['userfile']['name']</varname>, + <varname>$userfile_type</varname> vaut + <varname>$_FILES['userfile']['type']</varname>, etc... Gardez à l'esprit + que depuis &php; 4.2.0, <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>off</emphasis> par défaut. Il n'est pas prudent de + supposer que cette directive vaut <emphasis>on</emphasis>. + </para> + <para> + Le fichier téléchargé sera stocké temporairement dans le dossier + temporaire du système, à moins qu'un autre dossier soit fourni avec + la directive <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> du + &php.ini;. Le dossier par défaut du serveur peut être changé + dans l'environnement via la variable <envar>TMPDIR</envar>. + Modifier la valeur de cette variable avec la fonction <function>putenv</function> + dans un script &php; sera sans effet. Cette variable d'environnement + peut aussi être utilisée pour s'assurer que d'autres opérations + fonctionnent aussi sur les fichiers téléchargés. <example> - <title>Validation de fichiers téléchargés</title> - <para> - Les exemples suivants fonctionnent sur les versions - de PHP 3 supérieures à la version 3.0.16, et supérieures - à la version 4.0.2 pour PHP 4. Reportez-vous à - la section des fonctions pour étudier - <function>is_uploaded_file</function> et <function>move_uploaded_file</function>. - </para> - <programlisting role="php"> -<?;php -if (is_uploaded_file($userfile)) { - copy($userfile, "/dossier/des/fichiers/telecharges/"); -} else { - echo "Attaque potentielle par fichier téléchargé : fichier '$userfile'."; -} -/* ...ou... */ -move_uploaded_file($userfile, "/dossier/des/fichiers/telecharges"); -?> - </programlisting> + <title>Validation de téléchargement de fichiers</title> <para> - Pour les versions plus anciennes de PHP, vous devrez faire quelque - chose comme ceci : + Les exemples ci-dessous sont valables avec les versions de &php; + plus récentes que la 4.0.2. Voyez les fonctions + <function>is_uploaded_file</function> et + <function>move_uploaded_file</function>. </para> <programlisting role="php"> -<?;php -/* Test du fichier téléchargé. */ -function is_uploaded_file($filename) { - if (!$tmp_file = get_cfg_var('upload_tmp_dir')) { - $tmp_file = dirname(tempnam('', '')); - } - $tmp_file .= '/' . basename($filename); - /* L'utilisateur peut avoir un slash final dans <filename>php.ini</filename>... */ - return (ereg_replace('/+', '/', $tmp_file) == $filename); -} -if (is_uploaded_file($userfile)) { - copy($userfile, "/place/to/put/uploaded/file"); +<![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"); } else { - echo "Attaque potentielle par fichier téléchargé : fichier '$userfile'."; + echo "Attaque par upload potentielle le fichier : " . $_FILES['userfile']['name']; } -?> +/* ...ou bien... */ +move_uploaded_file($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); +?> +]]> </programlisting> </example> </para> - <note> - <para> - Cela ne fonctionnera <emphasis>PAS</emphasis> avec les versions de - PHP 4 supérieure à 4.0.2. Cela repose sur des fonctionnalités - internes à PHP qui ont évolué après cette version. - </para> - </note> <simpara> Le script PHP qui reçoit le fichier chargé doit pouvoir gérer le fichier de manière appropriée. Vous @@ -204,6 +191,11 @@ la variable <varname>$file_type</varname> pour recaler les fichiers qui n'ont pas le bon type. Quelques soient les actions, ce script doit pouvoir supprimer le fichier du dossier temporaire, ou le déplacer ailleurs. + Depuis &php; 4.2.0, vous pouvez utiliser l'information dans + <varname>$_FILES['userfile']['error']</varname> et adapter votre politique + en fonction des <link linkend="features.file-upload.errors">code d'erreur</link>. + Quelque soit votre politique, vous devriez soit effacer le fichier du + dossier temporaire, soit le déplacer. </simpara> <simpara> Le fichier sera automatiquement effacé du fichier temporaire @@ -211,6 +203,70 @@ déplacé ou renommé. </simpara> </sect1> + + <sect1 id="features.file-upload.errors"> + <title>Explication sur les messages d'erreurs de chargement de fichiers</title> + <simpara> + Depuis PHP 4.2.0, &php; retourne un code d'erreur approprié dans le + tableau de fichiers. Ce code d'erreur est accessible à l'index + <emphasis>error</emphasis> du tableau, qui est créé durant + le téléchargement, par &php;. En d'autres termes, le message d'erreur + est accessible dans la variable <varname>$_FILES['userfile']['error']</varname>. + </simpara> + <para> + <variablelist> + <varlistentry> + <term><varname>UPLOAD_ERR_OK</varname></term> + <listitem> + <para> + Valeur : 0. Aucune erreur, le téléchargement est correct. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_INI_SIZE</varname></term> + <listitem> + <para> + Valeur : 1. Le fichier téléchargé excède la taille de + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, + configuré dans le &php.ini;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_FORM_SIZE</varname></term> + <listitem> + <para> + Valeur : 2. Le fichier téléchargé excède la taille de + <emphasis>MAX_FILE_SIZE</emphasis>, qui a été spécifiée dans + le formulaire HTML. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_PARTIAL</varname></term> + <listitem> + <para> + Valeur : 3. Le fichier n'a été que partiellement téléchargé. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_NO_FILE</varname></term> + <listitem> + <para> + Valeur : 4. Aucun fichier n'a été téléchargé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <note> + <para> + Ces constantes sont apparues en PHP 4.3.0. + </para> + </note> + </sect1> <sect1 id="features.file-upload.common-pitfalls"> <title>Erreurs classiques</title> <simpara> @@ -230,60 +286,71 @@ CERN httpd ne pourra pas effectuer de chargement. </simpara> </sect1> - <sect1 id="feature-fileupload.multiple"> - <title>Chargement multiples de fichiers</title> + <sect1 id="features.file-upload.multiple"> + <title>Télécharger plusieurs fichiers simultanément</title> + <simpara> + Le téléchargement de plusieurs fichiers est possible + en utilisant des noms différents dans l'attribut + <literal>name</literal> de la balise <literal>input</literal>. + </simpara> <simpara> - Il est possible de charger plusieurs fichiers en même temps, et de - recevoir les informations adéquates organisées sous - forme de tableau. Pour ce faire, il faut utiliser la même - syntaxe d'envoi dans le code HTML que pour les sélections ou - boîtes à cocher multiples. + Il est aussi possible de télécharger plusieurs fichiers simultanément + et d'obtenir les informations sous forme de tableau. Pour cela, vous + devez utiliser la syntaxe de tableau dans les noms de balises + HTML, comme vous l'avez fait avec les sélections multiples + et les boîtes à cocher. </simpara> <note> <para> - Le support du chargement multiple de fichier a été - ajouté dans la version 3.0.10. + Le support des téléchargement multiples a été ajouté + en &php; 3.0.10. </para> </note> <para> <example> - <title>Chargement multiple de fichier </title> + <title>Télécharger plusieurs fichiers simultanément</title> <programlisting role="html"> -<form action="file-upload.html" method="post" enctype="multipart/form-data"> - Send these files:<br> - <input name="userfile[]" type="file"><br> - <input name="userfile[]" type="file"><br> - <input type="submit" value="Send files"> -</form> +<![CDATA[ +<FORM ACTION="file-upload.php" METHOD="post" ENCTYPE="multipart/form-data"> + Envoyez plusieurs fichiers : <BR> + <INPUT NAME="userfile[]" TYPE="file"><BR> + <INPUT NAME="userfile[]" TYPE="file"><BR> + <INPUT TYPE="submit" VALUE="Send files"> +</FORM> +]]> </programlisting> </example> </para> <simpara> - Lorsque le formulaire ci-dessus a étéF envoyé, les tableaux - <computeroutput>$userfile</computeroutput>, - <computeroutput>$userfile_name</computeroutput>, et - <computeroutput>$userfile_size</computeroutput> seront initialisés - (ainsi que $HTTP_POST_VARS). Chaque tableau sera de type - numérique, et contiendra les valeurs appropriées - pour le chargement des fichiers. + Lorsque le formulaire ci-dessus a été envoyé, les + tableaux <varname>$_FILES['userfile']</varname>, + <varname>$_FILES['userfile']['name']</varname>, et + <varname>$_FILES['userfile']['size']</varname> seront initialisés + (tout comme <varname>$HTTP_POST_FILES</varname> pour les versions + de &php; antérieure à la 4.1.0). Lorsque + <literal>register_globals</literal> est activé, les variables + globales concernant les fichiers téléchargés sont aussi + initialisées. Chacune d'entre elle contiendra un tableau + numériquement indexé, avec les valeurs décrivant les fichiers + téléchargés. </simpara> <simpara> - Par exemple, supposons que les noms de fichier + Par exemple, supposons que les fichiers <filename>/home/test/review.html</filename> et - <filename>/home/test/xwp.out</filename> soient envoyés. - Dans ce cas, <computeroutput>$userfile_name[0]</computeroutput> - va contenir <computeroutput>review.html</computeroutput>, - et <computeroutput>$userfile_name[1]</computeroutput> contiendra - <computeroutput>xwp.out</computeroutput>. Similairement, - <computeroutput>$userfile_size[0]</computeroutput> contiendra - la taille de <filename>review.html</filename>, etc... + <filename>/home/test/xwp.out</filename> ont été téléchargé. Dans ce cas, + <varname>$_FILES['userfile']['name'][0]</varname> + contient <filename>review.html</filename> et + <varname>$_FILES['userfile']['name'][1]</varname> contient + <filename>xwp.out</filename>. Similairement, + <varname>$_FILES['userfile']['size'][0]</varname> va contenir + la taille du fichier <filename>review.html</filename>, etc... </simpara> <simpara> - <computeroutput>$userfile['name'][0]</computeroutput>, - <computeroutput>$userfile['tmp_name'][0]</computeroutput>, - <computeroutput>$userfile['size'][0]</computeroutput>, et - <computeroutput>$userfile['type'][0]</computeroutput> - sont aussi affectés. + <varname>$_FILES['userfile']['name'][0]</varname>, + <varname>$_FILES['userfile']['tmp_name'][0]</varname>, + <varname>$_FILES['userfile']['size'][0]</varname> et + <varname>$_FILES['userfile']['type'][0]</varname> sont aussi + créées. </simpara> </sect1> <sect1 id="features.file-upload.put-method"> @@ -320,19 +387,22 @@ </para> <simpara> Elle indique à Apache qu'il doit envoyer les requêtes - de chargement par méthode PUT au script put.php3. Bien entendu, + de chargement par méthode PUT au script + <filename>put.php3</filename>. Bien entendu, cela présuppose que vous avez activé PHP pour qu'il prenne en charge les fichiers de type .php3, et que PHP est actif. </simpara> <simpara> - Dans le fichier put.php3 file vous pouvez mettre ceci : + Dans le fichier <filename>put.php3</filename>, vous pouvez mettre ceci : </simpara> <para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -344,11 +414,11 @@ est que lorsque PHP reçoit un chargement par méthode PUT, il va enregistrer le fichier dans le dossier temporaire, tout comme avec la - <link linkend="features.file-upload.post-method">méthode POST-method</link>. + <link linkend="features.file-upload.post-method">méthode POST</link>. A la fin de la requête, le fichier sera effacé. Ce qui fait que ce script doit placer le fichier chargé quelque part. Le nom du fichier temporaire est placé dans la variable - globale $PHP_PUT_FILENAME, et la destination prévue est + globale <varname>$PHP_PUT_FILENAME</varname>, et la destination prévue est placée dans <varname>$REQUEST_URI</varname> (ces noms peuvent changer d'une configuration d'Apache à l'autre). Cette destination est celle qui est demandée par le client, et vous n'avez pas Index: phpdoc-fr/features/http-auth.xml diff -u phpdoc-fr/features/http-auth.xml:1.11 phpdoc-fr/features/http-auth.xml:1.12 --- phpdoc-fr/features/http-auth.xml:1.11 Tue Jan 29 18:18:15 2002 +++ phpdoc-fr/features/http-auth.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="features.http-auth"> <title>Authentification HTTP avec PHP</title> <simpara> @@ -18,26 +18,53 @@ simple ("Basic") est supportée. Reportez-vous à la fonction <function>header</function> pour plus d'informations. </simpara> + + <note> + <title>Note sur les versions de PHP</title> + <para> + Les <link linkend="language.variables.superglobals">auto-globales</link>, + telles que <link linkend="reserved.variables.server">$_SERVER</link>, ont été + ajoutée en &php; à partir de la version + <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. + <varname>$HTTP_SERVER_VARS</varname> est disponible depuis PHP 3. + </para> + </note> + <para> Voici un exemple de script qui force l'authentification du client pour accéder à une page : <example> <title>Exemple d'authentification HTTP</title> <programlisting role="php"> -<?php - if(!isset($PHP_AUTH_USER)) { - Header("WWW-Authenticate: Basic realm=\"My Realm\""); - Header("HTTP/1.0 401 Unauthorized"); - echo "Texte à envoyer si le client appuie sur le bouton d'annulation\n"; +<![CDATA[ +<?php + if (!isset($_SERVER['PHP_AUTH_USER'])) { + header('WWW-Authenticate: Basic realm="My Realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Texte utilisé si le visiteur utilise le bouton d\'annulation'; exit; } else { - echo "Bonjour $PHP_AUTH_USER.<P>" - echo "Vous avez entré le mot de passe $PHP_AUTH_PW.<P>" + echo "<p>Bonjour, {$_SERVER['PHP_AUTH_USER']}.</p>"; + echo "<p>Votre mot de passe est {$_SERVER['PHP_AUTH_PW']}.</p>"; } -?> +?> +]]> </programlisting> </example> </para> + + <note> + <title>Note de compatibilité</title> + <para> + Soyez bien prudent lorsque vous utilisez des entêtes HTTP avec &php;. Afin de + garantir un maximum de compatibilité entre les navigateurs, le mot clé + "Basic" doit être écrit avec un B majuscule, et le texte de présentation + doit être placé entre guillemets simples, et exactement un espace doit + précéder le code <emphasis>401</emphasis> dans l'entête + <emphasis>HTTP/1.0 401</emphasis>. + </para> + </note> + <para> Au lieu d'afficher simplement les variables globales <varname>$PHP_AUTH_USER</varname> et <varname>$PHP_AUTH_PW</varname>, vous préférerez sûrement @@ -58,9 +85,21 @@ quelle on a accédé par une authentification traditionnelle, les variables globales PHP_AUTH ne seront pas assignées si l'authentification externe a été activée pour - cette page. Dans ce cas, la variable <varname>$REMOTE_USER</varname> peut être + cette page. Dans ce cas, la variable <varname>REMOTE_USER</varname> peut être utilisée pour identifier l'utilisateur à l'extérieur. + De même que <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> + <note> + <title>Note de configuration</title> + <para> + &php; utilise la présence de la directive <literal>AuthType</literal> + pour déterminer si une authentification externe est activé. + vitez donc cette directive de contexte si vous voulez utiliser + l'authentification de &php; (sinon, les deux authentifications + se contrediront, et échoueront). + </para> + </note> + <simpara> Notez cependant que les manipulations ci-dessus n'empêchent pas quiconque possède une page non authentifiée @@ -79,26 +118,29 @@ Authentification HTTP avec nom d'utilisateur/mot de passe forcé </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php function authenticate() { - Header( "WWW-Authenticate: Basic realm=\"Test Authentication System\""); - Header( "HTTP/1.0 401 Unauthorized"); - echo "Vous devez entrer un nom d'utilisateur valide et un mot de passe correct pour accéder à cette ressource\n"; - exit; + header('WWW-Authenticate: Basic realm="Test Authentication System"'); + header('HTTP/1.0 401 Unauthorized'); + echo "You must enter a valid login ID and password to access this resource\n"; + exit; } - if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) { + + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); - } + } else { - echo "Bienvenue $PHP_AUTH_USER<BR>"; - echo "Old: $OldAuth"; - echo "<form action=\"$PHP_SELF\" method=post>\n"; - echo "<input type=hidden NAME=\"SeenBefore\" VALUE=\"1\">\n"; - echo "<input type=hidden NAME=\"OldAuth\" VALUE=\"$PHP_AUTH_USER\">\n"; - echo "<input type=submit value=\"Re Authenticate\">\n" - echo "</FORM>\n"; + echo "<p>Welcome: {$_SERVER['PHP_AUTH_USER']}<br>"; + echo "Old: {$_REQUEST['OldAuth']}"; + echo "<form action='{$_SERVER['PHP_SELF']}' METHOD='POST'>\n"; + echo "<input type='hidden' name='SeenBefore' value='1'>\n"; + echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}'>\n"; + echo "<input type='submit' value='Re Authenticate'>\n"; + echo "</form></p>\n"; } -?> +?> +]]> </programlisting> </example> <simpara> @@ -115,6 +157,14 @@ Notez aussi que tout ceci ne fonctionne pas sous Microsoft IIS et que les limitations de PHP en version CGI sont dues aux limitations de IIS. </simpara> + <note> + <para> + Si le &safemode; est activé, l'uid du script es ajouté automatiquement + dans l'entête <literal>realm</literal>, comme faisant partie de l'entête + <literal>WWW-Authenticate</literal>. + </para> + </note> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/features/images.xml diff -u phpdoc-fr/features/images.xml:1.6 phpdoc-fr/features/images.xml:1.7 --- phpdoc-fr/features/images.xml:1.6 Wed Dec 12 15:48:51 2001 +++ phpdoc-fr/features/images.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter id="features.images"> <title>Création d'images</title> <simpara> @@ -16,7 +16,8 @@ <example> <title>Création d'images GIF avec PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php header("Content-type: image/png"); $string=implode($argv," "); $im = imagecreatefrompng("images/button1.png"); @@ -25,7 +26,8 @@ imagestring($im,3,$px,9,$string,$orange); imagepng($im); imagedestroy($im); -?> +?> +]]> </programlisting> </example> Cet exemple sera appelé depuis une page HTML avec une balise Index: phpdoc-fr/features/remote-files.xml diff -u phpdoc-fr/features/remote-files.xml:1.8 phpdoc-fr/features/remote-files.xml:1.9 --- phpdoc-fr/features/remote-files.xml:1.8 Sun Jan 6 19:09:54 2002 +++ phpdoc-fr/features/remote-files.xml Thu Jan 30 08:44:04 2003 @@ -1,21 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="features.remote-files"> <title>Utilisation des fichiers à distance</title> <para> - Aussi longtemps que le support de la fonction d'ouverture - générique de fichiers ("URL fopen wrapper") - est actif lorsque vous configurez PHP (il est inutile de - passer explicitement l'option - <link linkend="install.configure.disable-url-fopen-wrapper">--disable-url-fopen-wrapper</link> - pour faire la configuration), vous pouvez utiliser des URLs + Aussi longtemps que le support des gestionnaires d'URL ("URL fopen wrapper") + sont activés dans le &php.ini;, vous pouvez utiliser des URLs (HTTP et FTP) avec la majorité des fonctions qui utilisent un - nom de fichier comme paramètre, ceci incluant les expressions - <function>require</function> et <function>include</function>. + nom de fichier comme paramètre. Cela inclut notamment + <function>include</function>, <function>include_once</function>, + <function>require</function> et <function>require_once</function>. + Reportez-vous à <xref linkend="wrappers"/> pour plus d'informations + sur les protocoles supportés par &php;. + </para> + <note> + <para> + En PHP 4.0.3 et plus récent, pour pouvoir utiliser les gestionnaires + d'URL, vous devez configurer &php; avec l'option + <option>--enable-url-fopen-wrapper</option>. + </para> + </note> + <para> <note> <para> - Vous ne pouvez pas utiliser les fichiers distants dans les expressions - <function>include</function> et <function>require</function> sous Windows. + Les versions de &php; pour Windows plus anciennes que 4.3 + de supportait pas les gestionnaires d'URL avec les fonctions suivantes : + <function>include</function>, <function>include_once</function>, + <function>require</function>, <function>require_once</function>, + et les fonctions de création d'images de l'extension <xref linkend="ref.image"/>. </para> </note> </para> @@ -30,22 +41,24 @@ <example> <title>Connaître le titre d'une page distante</title> <programlisting role="php"> -<?php - $file = fopen("http://www.php.net/", "r"); - if (!$file) { - echo "<p>Impossible d'ouvrir le fichier distant.\n"; +<![CDATA[ +<?php +$file = fopen ("http://www.example.com/", "r"); +if (!$file) { + echo "<p>Impossible de lire la page.\n"; exit; - } - while (!feof($file)) { - $line = fgets($file, 1024); - /* Cela ne fonctionne que si le titre est écrit sur une ligne.*/ - if (eregi("<title>(.*)</title>", $line, $out)) { - $title = $out[1]; - break; +} +while (!feof ($file)) { + $line = fgets ($file, 1024); + /* Cela ne fonctionne que si les balises Title sont correctement utilisées */ + if (eregi ("<title>(.*)</title>", $line, $out)) { + $title = $out[1]; + break; } - } - fclose($file); -?> +} +fclose($file); +?> +]]> </programlisting> </example> </para> @@ -53,7 +66,10 @@ Vous pouvez aussi écrire des fichiers sur un serveur FTP aussi longtemps que vous êtes connecté avec un utilisateur ayant les bons droits d'accès, alors que le - fichier n'existait pas encore. Pour vous connecter avec un + fichier n'existait pas encore. + </para> + <para> + Pour vous connecter avec un utilisateur autre qu'anonyme, vous devez spécifier un nom d'utilisateur (et certainement le mot de passe) dans l'URL, comme par exemple 'ftp://user:password@ftp.example.com/path/to/file'. @@ -65,16 +81,18 @@ <example> <title>Stocker des données sur un serveur distant</title> <programlisting role="php"> -<?php - $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); - if (!$file) { - echo "<p>Impossible d'ouvrir un fichier distant en écriture.\n"; +<![CDATA[ +<?php +$file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w"); +if (!$file) { + echo "<p>Unable to open remote file for writing.\n"; exit; - } +} /* Ecriture des données. */ - fputs($file, "$HTTP_USER_AGENT\n"); - fclose($file); -?> +fputs ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); +fclose ($file); +?> +]]> </programlisting> </example> <note> Index: phpdoc-fr/features/safe-mode.xml diff -u phpdoc-fr/features/safe-mode.xml:1.4 phpdoc-fr/features/safe-mode.xml:1.5 --- phpdoc-fr/features/safe-mode.xml:1.4 Wed Dec 12 15:48:52 2001 +++ phpdoc-fr/features/safe-mode.xml Thu Jan 30 08:44:04 2003 @@ -1,97 +1,348 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter id="features.safe-mode"> <title>Safe mode</title> + <para> - Le "Safe Mode" est le mode de sécurité de PHP : une solution au problème - de partage de PHP sur un serveur. Ce système pêche au niveau de l'architecture - car il n'est pas correct de tenter de résoudre ce problème au niveau - de PHP, mais les solutions alternatives basées sur le serveur web et l'OS - ne sont pas réalistes. De nombreux acteurs, notamment les fournisseurs - d'hébergement, utilise le "Safe Mode". - </para> - <para> - Les directives de configuration qui contrôlent le safe mode sont : - <informalexample> - <programlisting role="ini"> -safe_mode = Off -open_basedir = -safe_mode_exec_dir = -safe_mode_allowed_env_vars = PHP_ -safe_mode_protected_env_vars = LD_LIBRARY_PATH -disable_functions = - </programlisting> - </informalexample> + Le "Safe Mode" est le mode de sécurité de PHP : + une solution au problème de partage de PHP sur un serveur. + Ce système pêche au niveau de l'architecture + car il n'est pas correct de tenter de résoudre ce + problème au niveau de PHP, mais les solutions + alternatives basées sur le serveur web et l'OS + ne sont pas réalistes. De nombreux intervenants, + notamment les fournisseurs d'hébergement, utilisent + le "Safe Mode". </para> + + <sect1 id="ini.sect.safe-mode"> + <title>Securité et Safe Mode</title> + <para> + <table> + <title>Directives de sécurité et de Safe Mode</title> + <tgroup cols="3"> + <thead> + &ini.table.title; + </thead> + <tbody> + <row> + <entry>safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_gid</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_include_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_exec_dir</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_allowed_env_vars</entry> + <entry>PHP_</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_protected_env_vars</entry> + <entry>LD_LIBRARY_PATH</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>open_basedir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>disable_functions</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + </tbody> + </tgroup> + </table> + &ini.table.bottom; + + </para> + <para> + Voici des éclaircissements sur ces directives. + <variablelist> + <varlistentry id="ini.safe-mode"> + <term> + <parameter>safe_mode</parameter> + <type>&boolean;</type> + </term> + <listitem> + <para> + Active ou non le mode de sécurité de &php;. Lisez le chapitre + <link linkend="security">sécurité</link> pour plus d'informations. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-gid"> + <term> + <parameter>safe_mode_gid</parameter> + <type>&boolean;</type> + </term> + <listitem> + <para> + Par défaut, le safe mode fait une comparaison des + propriétaires, avant d'ouvrir un fichier. Si vous voulez + alléger un peu ce niveau de sécurité, vous pouvez + réaliser une comparaison de groupe, et activer cette + directive. + Si cette directive vaut &false; (sa valeur par défaut), + c'est une comparaison sur les <literal>UID</literal>, + et sinon, sur les <literal>GID</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-include-dir"> + <term> + <parameter>safe_mode_include_dir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Les vérifications basées sur le <literal>UID</literal> ou <literal>GID</literal> + sont ignorées lorsque les fichiers sont issus du dossier + et de ses sous-dossiers, indiqué dans cette directive. Les + dossiers peuvent être aussi dans l'<link linkend="ini.include-path">include_path</link> + ou bien il faut inclure le chemin complet. + </para> + <simpara> + Depuis &php; 4.2.0, cette directive utilise le point virgule + de la même façon que le fait + <link linkend="ini.include-path">include_path</link>, pour + permettre de configurer plusieurs dossiers. + </simpara> + <simpara> + La restriction spécifiée est en fait un préfixe, plus qu'un + nom de dossier. Cela signifie que "safe_mode_include_dir = /dir/incl" + autorise aussi bien "/dir/include" que "/dir/incls", si ils existent. + Lorsque vous souhaitez restreindre l'accès à un dossier spécifique, + il faut terminer cette directive avec un slash /. Par exemple + "safe_mode_include_dir = /dir/incl/" + </simpara> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-exec-dir"> + <term> + <parameter>safe_mode_exec_dir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Si &php; est utilisé en safe mode, les fonctions comme <function>system</function> + et toutes celles qui permettent l'exécution en + <link linkend="ref.exec">ligne de commande</link> refuseront d'exécuter des programmes + qui ne sont pas dans ce dossier. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-allowed-env-vars"> + <term> + <parameter>safe_mode_allowed_env_vars</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Modifier certaines variables d'environnement est un trou de + sécurité potentiel. Cette directive contient une liste de noms + variables d'environnement séparées par des virgules, ou de préfixes. + En Safe mode, l'utilisateur ne pourra modifier que les + variables d'environnement dont le nom commence par l'un des préfixes + fourni ici. Par défaut, les utilisateurs ne peuvent modifier que + les variables d'environnemt qui commencent par PHP_ (e.g. PHP_FOO=BAR). + </para> + <note> + <para> + Si cette directive est vide, &php; autorisera la modification + de TOUTES les variables d'environnement. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-protected-env-vars"> + <term> + <parameter>safe_mode_protected_env_vars</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Cette directive contient une liste de variables d'environnement + que le programmeur ne pourra pas modifier en utilisant la + fonction <function>putenv</function>. Ces variables seront protégées, + même is la directive safe_mode_allowed_env_vars autorise leur + modification. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.open-basedir"> + <term> + <parameter>open_basedir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Limite les fichiers accessibles par &php; dans l'arborescence. + Cette directive <emphasis>n'est pas</emphasis> affectée + par le safe mode. + </para> + <para> + Lorsqu'un script tente d'ouvrir un fichier, avec les fonctions + <function>fopen</function> ou <function>gzopen</function>, la situation + du fichier est vérifiée. Si le fichier se situe hors du dossier + spécifié dans cette directive,&php; refusera de l'ouvrir. + Les liens symboliques sont résolus, ce qui fait que cette + restriction ne peut être contournée par un lien symbolique. + </para> + <para> + La valeur spéciale <systemitem class="constant">.</systemitem> + indique que le dossier dans lequel le script est stocké, servira + de dossier de base. + </para> + <para> + Sous Windows, séparez les dossiers par des deux points. Sur les autres + systèmes, séparez les dossiers avec un point-virgule. Lorsque &php; est utilisé + comme module Apache, les chemins de la directive open_basedir des + dossiers parents sont automatiques transmis. + </para> + <para> + La restriction spécifiée par open_basedir est en fait un + préfixe, et non un dossier. Cela signifie que + "open_basedir = /dir/incl" donne accès au dossier "/dir/include" + et aussi au dossier "/dir/incls" si il existe. Lorsque vous souhaitez + restreindre l'accès à un dossier spécifique, ajoutez un slash final. + Par exemple "open_basedir = /dir/incl/". + </para> + <note> + <para> + Le support des dossiers multiples a été ajouté en &php; 3.0.7. + </para> + </note> + <para> + La valeur par défaut est de permettre l'ouverture de + tous les fichiers. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.disable-functions"> + <term> + <parameter>disable_functions</parameter> + <type>&string;</type> + </term> + <listitem> + <simpara> + Cette directive vous permet de désactiver certaines fonctions + pour des raisons de <link linkend="security">sécurité</link>. Elle + prend une liste de nom de fonctions, séparés par des + virgules. disable_functions n'est pas affectée par le + <link linkend="ini.safe-mode">Safe Mode</link>. + </simpara> + <simpara> + Cette directive doit être configurée dans le fichier &php.ini;. Par exemple, + vous ne pourrez pas la configurer dans le fichier + <filename>httpd.conf</filename>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Voir aussi + <link linkend="ini.register-globals">register_globals</link>, + <link linkend="ini.display-errors">display_errors</link> et + <link linkend="ini.log-errors">log_errors</link> + </para> + <para> Lorsque <link linkend="ini.safe-mode">safe_mode</link> est actif, PHP vérifie que le propriétaire du script courant est le même que le propriétaire des fichiers qui seront manipulés par ce script. Par exemple, dans a la situation suivante : - <informalexample> - <programlisting role="ls"> --rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php --rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd - </programlisting> - </informalexample> + <programlisting role="ls"> +<![CDATA[ +-rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php +-rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd +]]> + </programlisting> éxécuter le script <filename>script.php</filename> - <informalexample> - <programlisting role="php"> -<?php - readfile('/etc/passwd'); -?> - </programlisting> - </informalexample> - générera cette erreur, si le safe mode est activé : - <informalexample> - <programlisting> -Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not -allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 + <programlisting role="php"> +<![CDATA[ +<?php + readfile('/etc/passwd'); +?> +]]> </programlisting> - </informalexample> + générera cette erreur, si le &safemode; est activé : + <screen> +<![CDATA[ +Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not +allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 +]]> + </screen> </para> <para> + Cependant, il arrive que la vérification faite avec le nom du propriétaire + du fichier soit trop restrictive, et qu'une vérification sur le nom + du groupe soit suffisante. C'est une autre fonctionnalité supportée + par la directive <link linkend="ini.safe-mode-gid">safe_mode_gid</link>. + En lui donnant la valeur de <literal>On</literal>, les vérifications + seront faites sur le <literal>GID</literal>, alors qu'en lui laissant + sa valeur par défaut de <literal>Off</literal>, les vérifications seront + faites sur le <literal>UID</literal>. + </para> + <para> Si vou utilisez la directive open_basedir au lieu du <link linkend="ini.safe-mode">safe_mode</link>, alors les manipulations seront limitées aux fichiers situés dans les dossiers spécifiés. Par exemple : - <informalexample> - <programlisting role="ini"> -<Directory /docroot> -php_admin_value open_basedir /docroot -</Directory> + <programlisting role="ini"> +<![CDATA[ +<Directory /docroot> + php_admin_value open_basedir /docroot +</Directory> +]]> </programlisting> - </informalexample> Si vous exécutez le script <filename>script.php</filename> ci-dessus avec la configuration d'open_basedir le résultat sera l'affichage suivant : - <informalexample> - <programlisting role="php"> -Warning: open_basedir restriction in effect. File is in wrong directory in -/docroot/script.php on line 2 - </programlisting> - </informalexample> + <screen> +<![CDATA[ +Warning: open_basedir restriction in effect. File is in wrong directory in +/docroot/script.php on line 2 +]]> + </screen> </para> <para> Vous pouvez aussi désactiver individuellement les fonctions. Par exemple, - en ajoutant cette ligne dans le fichier <filename>php.ini</filename> : - <informalexample> - <programlisting role="ini"> -disable_functions readfile,system - </programlisting> - </informalexample> + en ajoutant cette ligne dans le fichier &php.ini; : + <programlisting role="ini"> +<![CDATA[ +disable_functions readfile,system +]]> + </programlisting> toute utilisation des fonctions <function>readfile</function> et <function>system</function> générera l'affichage suivant : - <informalexample> - <programlisting role="php"> -Warning: readfile() has been disabled for security reasons in -/docroot/script.php on line 2 - </programlisting> - </informalexample> + <screen> +<![CDATA[ +Warning: readfile() has been disabled for security reasons in +/docroot/script.php on line 2 +]]> + </screen> </para> + </sect1> <sect1 id="features.safe-mode.functions"> - <title>Functions désactivées par le Safe Mode</title> + <title>Fonctions désactivées par le Safe Mode</title> <para> Voici une liste non-exhaustive des fonctions désactivées par le <link linkend="features.safe-mode">Safe Mode</link>. @@ -174,12 +425,12 @@ <entry>&sm.disabled;</entry> </row> <row> - <entry><link linkend="language.operators.execution">backtick operator</link></entry> + <entry><link linkend="language.operators.execution">opérateur guillemets obliques</link></entry> <entry>&sm.disabled;</entry> </row> <row> - <entry><function>shell_exec</function> (équivalent fonctionnels - des guillemets oblique)</entry> + <entry><function>shell_exec</function> (équivalent fonctionnel + des guillemets obliques)</entry> <entry>&sm.disabled;</entry> </row> <row> @@ -281,9 +532,46 @@ </entry> </row> <row> + <entry><function>header</function></entry> + <entry>Avec le safe mode, le uid du script est ajouté à la partie + <literal>realm</literal> de l'entête + <literal>WWW-Authenticate</literal> si vous utilisez cet entête + pour l'authentification.</entry> + </row> + <row> + <entry><link linkend="features.http-auth">variables PHP_AUTH</link></entry> + <entry> + Avec le safe mode, les variables <varname>PHP_AUTH_USER</varname>, + <varname>PHP_AUTH_PW</varname> et <varname>PHP_AUTH_TYPE</varname> + ne sont pas disponibles dans la variable <varname>$_SERVER</varname>. + Indépendamment, vous pouvez utiliser la variable + <varname>REMOTE_USER</varname> pour connaître le USER. + (note : affectée uniquement depuis &php; 4.3.0) + </entry> + </row> + <row> + <entry> + <function>highlight_file</function>, + <function>show_source</function> + </entry> + <entry> + &sm.uidcheck; &sm.uidcheck.dir; + (note : affectée uniquement depuis &php; 4.2.1) + </entry> + </row> + <row> + <entry> + <function>parse_ini_file</function> + </entry> + <entry> + &sm.uidcheck; &sm.uidcheck.dir; + (note : affectée uniquement depuis &php; 4.2.1) + </entry> + </row> + <row> <entry> - Toutes les fonctions qui utilisent les - wrappers de fichiers. + Toutes les fonctions qui utilisent les wrappers de fichiers. + (<filename>php4/main/fopen_wrappers.c</filename>) </entry> <entry>??</entry> </row>
Index: phpdoc-fr/features/commandline.xml diff -u phpdoc-fr/features/commandline.xml:1.2 phpdoc-fr/features/commandline.xml:1.3 --- phpdoc-fr/features/commandline.xml:1.2 Mon Aug 19 21:30:16 2002 +++ phpdoc-fr/features/commandline.xml Thu Jan 30 08:44:04 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <chapter id="features.commandline"> <title>Utiliser PHP en ligne de commande</title> <!-- NEW DOCUMENTATION STARTS --> <para> - Depuis la version 4.3, <literal>PHP</literal> supporte un nouveau type + Depuis la version 4.3, &php; supporte un nouveau type de <literal>SAPI</literal> (Server Application Programming Interface, c'est à dire Interface de Programmation d'Applications Serveur) appelé <literal>CLI</literal>, ce qui signifie <emphasis>Command Line Interface</emphasis> @@ -135,7 +135,9 @@ Un descripteur de fichier déjà disponible vers <literal>stdin</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stdin = fopen('php://stdin', 'r'); +]]> </programlisting> </entry> </row> @@ -145,17 +147,21 @@ Un descripteur de fichier déjà disponible vers <literal>stdout</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stdout = fopen('php://stdout', 'w'); +]]> </programlisting> </entry> </row> <row> <entry><constant>STDERR</constant></entry> <entry> - Un descripteur de fichier déjà disponible vers <literal>stdout</literal>. - Cela évite de l'ouvrir avec + Un descripteur de fichier déjà disponible vers + <literal>stderr</literal>. Cela évite de l'ouvrir avec <programlisting role="php"> +<![CDATA[ $stderr = fopen('php://stderr', 'w'); +]]> </programlisting> </entry> </row> @@ -168,7 +174,9 @@ vers <literal>stderr</literal> par vous-même, mais vous pouvez utiliser cette constante directement, comme un descripteur de fichier : <programlisting role="php"> +<![CDATA[ php -r 'fwrite(STDERR, "stderr\n");' +]]> </programlisting> Vous n'avez pas non plus à fermer explicitement ces fichiers, PHP s'en chargera automatiquement. @@ -201,7 +209,7 @@ /tmp/autre_dossier ]]> </screen> - Cela monter clairement que <literal>PHP</literal> modifie le dossier + Cela monter clairement que &php; modifie le dossier courant, et utilise le dossier du script exécuté. </para> <para> @@ -216,7 +224,7 @@ ]]> </screen> Cela donne beaucoup plus de souplesse lorsque vous rédigez des - scripts shell avec <literal>PHP</literal>. + scripts shell avec &php;. </para> <note> <para> @@ -229,8 +237,8 @@ </itemizedlist> </para> <para> - La liste des options de ligne de commande fournies par <literal>PHP</literal> - est disponible en exécutant <literal>PHP</literal> avec l'option <literal>-h</literal> : + La liste des options de ligne de commande fournies par &php; + est disponible en exécutant &php; avec l'option <literal>-h</literal> : <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -262,7 +270,7 @@ <orderedlist> <listitem> <para> - Indiquer à <literal>PHP</literal> d"exécuter un fichier : + Indiquer à &php; d'exécuter un fichier : </para> <para> <screen> @@ -281,7 +289,7 @@ </listitem> <listitem> <para> - Donner du code <literal>PHP</literal> à exécuter directement en ligne de commande. + Donner du code &php; à exécuter directement en ligne de commande. </para> <para> <screen> @@ -303,12 +311,12 @@ </listitem> <listitem> <para> - Donner du code <literal>PHP</literal> dans l'entrée standard + Donner du code &php; dans l'entrée standard (<literal>stdin</literal>). </para> <para> Cela donne la possibilité de créer dynamiquement du code - <literal>PHP</literal>, puis de le fournir à PHP, et enfin, + &php;, puis de le fournir à PHP, et enfin, de le traiter à nouveau en shell. Voici un exemple fictif : <screen> <![CDATA[ @@ -321,7 +329,7 @@ Il n'est pas possible de combiner ces trois modes d'exécution. </para> <para> - Comme toute application shell, l'exécutable <literal>PHP</literal> accepte + Comme toute application shell, l'exécutable &php; accepte des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments n'est pas limité par PHP, mais par le shell, qui a une limite en terme de nombre de caractères qui peuvent être passés. Généralement, vous n'atteidrez @@ -338,7 +346,7 @@ Tant que les arguments que vous passez à votre script ne commencent pas par le caractère <literal>-</literal>, il n'y a rien de spécial à surveiller. Si vous passez des arguments à voter script qui commencent par - <literal>-</literal>, cela posera des problèmes car <literal>PHP</literal> + <literal>-</literal>, cela posera des problèmes car &php; va penser qu'il doit les interpréter. Pour éviter cela, utilisez le séparateur <literal>--</literal>. Après cet argument, tous les arguments suivants seront passés à votre script sans être modifié ou analysé par PHP. @@ -615,7 +623,7 @@ <entry>-i</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et - affiche le résultat. Si <literal>PHP</literal> ne fonctionne pas + affiche le résultat. Si &php; ne fonctionne pas correctement, il est recommandé d'utiliser la commande <literal>php -i</literal> et de voir si il n'y a pas d'erreurs affichées avant ou après la table d'information. N'oubliez pas que le résutltat de cette @@ -627,8 +635,8 @@ <entry>-r</entry> <entry> <para> - Cette option permet l'exécution de <literal>PHP</literal> directement - dans la ligne de commande. Les balises de <literal>PHP</literal> + Cette option permet l'exécution de &php; directement + dans la ligne de commande. Les balises de &php; (<literal><?php</literal> et <literal>?></literal>) <emphasis role="strong">ne sont pas</emphasis> demandées, et coauseront une erreur d'analyse. @@ -636,7 +644,7 @@ <note> <para> De l'attention doit être portée lors de l'utilisation de cette option - de <literal>PHP</literal>, pour qu'il n'y ait pas de collision avec + de &php;, pour qu'il n'y ait pas de collision avec les substitutions de variables en lignes de commande, réalisées par le shell. </para> Index: phpdoc-fr/features/connection-handling.xml diff -u phpdoc-fr/features/connection-handling.xml:1.10 phpdoc-fr/features/connection-handling.xml:1.11 --- phpdoc-fr/features/connection-handling.xml:1.10 Wed Dec 12 15:48:49 2001 +++ phpdoc-fr/features/connection-handling.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <chapter id="features.connection-handling"> <title>Gestion des connexions</title> <note> @@ -35,7 +35,7 @@ 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 <filename>php.ini</filename> ou bien avec la directive Apache + 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 @@ -56,11 +56,12 @@ &true; si la connexion a été annulée. </simpara> <simpara> - Votre script peut aussi expirer après un laps de temps. + Votre script peut aussi être automatiquement interrompu + après une certaine durée de temps. Par défaut, le délai est de 30 secondes. Cette valeur peut être changée en utilisant la directive PHP <parameter>max_execution_time</parameter> dans le fichier - <filename>php.ini</filename> ou avec la directive + &php.ini; ou avec la directive <parameter>php3_max_execution_time</parameter>, dans le fichier Apache <filename>.conf</filename> ou encore avec la fonction <function>set_time_limit</function>. Index: phpdoc-fr/features/error-handling.xml diff -u phpdoc-fr/features/error-handling.xml:1.9 phpdoc-fr/features/error-handling.xml:1.10 --- phpdoc-fr/features/error-handling.xml:1.9 Wed Dec 12 15:48:50 2001 +++ phpdoc-fr/features/error-handling.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <chapter id="features.error-handling"> <title>Gestion des erreurs</title> <para> @@ -36,7 +36,7 @@ </row> <row> <entry>8</entry> - <entry>E_NOTICE </entry> + <entry>E_NOTICE</entry> <entry> Notes d'exécution (moins critique que les alertes) </entry> @@ -103,7 +103,7 @@ <link linkend="language.operators.bitwise">opérateurs de bits</link> pour combiner ces valeurs et conserver uniquement celle qui vous intéresse. Notez que seuls, '|', '~', '!', et '&' seront - utilisables dans <filename>php.ini</filename>, et qu'aucun opérateur + utilisables dans &php.ini;, et qu'aucun opérateur ne sera utilisable dans <filename>php3.ini</filename>. </para> <para> @@ -120,7 +120,7 @@ doit être numérique, c'est-à-dire <literal>7</literal>. </para> <para> - La valeur initiale peut être modifiée dans le fichier <filename>php.ini</filename>, + La valeur initiale peut être modifiée dans le fichier &php.ini;, avec la directive <link linkend="ini.error-reporting">error_reporting</link>, dans le fichier de configuration d'Apache @@ -173,67 +173,69 @@ <example> <title>Utiliser le contrôle d'erreur dans un script</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Nous effectuons nous-même notre contrôle d'erreur. error_reporting(0); // Fonction de gestion des erreurs utilisateur function usererrorhandler($errno, $errmsg, $filename, $linenum, $vars) { // timestamp pour dater l'erreur - $dt = date("Y-m-d H:i:s (T)"); + $dt = date("Y-m-d H:i:s (T)"); // definit un tableau associatif avec les chaînes d'erreur // en réalité, les seules entrées que nous considérerons // seront 2,8,256,512 et 1024 $errortype = array( - 1 => "Erreur", - 2 => "Alerte", - 4 => "Erreur d'analyse", - 8 => "Note", - 16 => "Erreur interne", - 32 => "Alerte interne", - 64 => "Erreur de compilation", - 128 => "Alerte de compilation", - 256 => "Erreur utilisateur", - 512 => "Alerte utilisateur", - 1024=> "Note utilisateur" + 1 => "Erreur", + 2 => "Alerte", + 4 => "Erreur d'analyse", + 8 => "Note", + 16 => "Erreur interne", + 32 => "Alerte interne", + 64 => "Erreur de compilation", + 128 => "Alerte de compilation", + 256 => "Erreur utilisateur", + 512 => "Alerte utilisateur", + 1024=> "Note utilisateur" ); // ensemble d'erreur pour lesquelles une trace sera conservée $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); - $err = "<errorentry>\n"; - $err .= "\t<datetime>".$dt."</datetime>\n"; - $err .= "\t<errornum>".$errno."</errnumber>\n"; - $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n"; - $err .= "\t<errormsg>".$errmsg."</errormsg>\n"; - $err .= "\t<scriptname>".$filename."</scriptname>\n"; - $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n"; + $err = "<errorentry>\n"; + $err .= "\t<datetime>".$dt."</datetime>\n"; + $err .= "\t<errornum>".$errno."</errnumber>\n"; + $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n"; + $err .= "\t<errormsg>".$errmsg."</errormsg>\n"; + $err .= "\t<scriptname>".$filename."</scriptname>\n"; + $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n"; if (in_array($errno, $user_errors)) - $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n"; - $err .= "</errorentry>\n\n"; + $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n"; + $err .= "</errorentry>\n\n"; // pour test // echo $err; // sauve l'erreur dans le fichier, et emaile moi si l'erreur est critique - error_log($err, 3, "/usr/local/php4/error.log"); + error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) - mail("phpdev@mydomain.com","Critical User Error",$err); + mail("phpdev@mydomain.com","Critical User Error",$err); } + function distance($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { - trigger_error("Paramètres incorrects : arrays attendus", E_USER_ERROR); + trigger_error("Paramètres incorrects : arrays attendus", E_USER_ERROR); return NULL; } if (count($vect1) != count($vect2)) { - trigger_error("Les vecteurs doivent être de la même taille", E_USER_ERROR); + trigger_error("Les vecteurs doivent être de la même taille", E_USER_ERROR); return NULL; } for ($i=0; $i<count($vect1); $i++) { $c1 = $vect1[$i]; $c2 = $vect2[$i]; $d = 0.0; if (!is_numeric($c1)) { - trigger_error("La coordonnée $i du vecteur 1 n'est pas un nombre. Remplacée par zéro", + trigger_error("La coordonnée $i du vecteur 1 n'est pas un nombre. Remplacée par zéro", E_USER_WARNING); $c1 = 0.0; } if (!is_numeric($c2)) { - trigger_error("La coordonnée $i du vecteur 2 n'est pas un nombre. Remplacée par zéro", + trigger_error("La coordonnée $i du vecteur 2 n'est pas un nombre. Remplacée par zéro", E_USER_WARNING); $c2 = 0.0; } @@ -241,31 +243,34 @@ } return sqrt($d); } -$old_error_handler = set_error_handler("userErrorHandler"); + +$old_error_handler = set_error_handler("userErrorHandler"); // Constante indéfinie, génère une alerte $t = I_AM_NOT_DEFINED; -// definition de quelques "vecteurs" -$a = array(2,3,"bla"); +// definition de quelques "vecteurs" +$a = array(2,3,"bla"); $b = array(5.5, 4.3, -1.6); $c = array(1,-3); // génère une erreur utilisateur -$t1 = distance($c,$b)."\n"; +$t1 = distance($c,$b)."\n"; // génère une autre erreur utilisateur -$t2 = distance($b,"i am not an array")."\n"; +$t2 = distance($b,"Je ne suis pas un tableau")."\n"; // génère une alerte -$t3 = distance($a,$b)."\n"; -?> +$t3 = distance($a,$b)."\n"; +?> +]]> </programlisting> </example> Ceci est un exemple simple, qui montre comment utiliser les fonctions de <link linkend="ref.errorfunc">Gestions des erreurs</link>. </para> <para> - Voir aussi <function>error_reporting</function>, + Voir aussi + <function>error_reporting</function>, <function>error_log</function>, <function>set_error_handler</function>, <function>restore_error_handler</function>, - <function>trigger_error</function>, + <function>trigger_error</function> et <function>user_error</function> </para> </chapter> Index: phpdoc-fr/features/file-upload.xml diff -u phpdoc-fr/features/file-upload.xml:1.13 phpdoc-fr/features/file-upload.xml:1.14 --- phpdoc-fr/features/file-upload.xml:1.13 Tue Jan 29 18:18:14 2002 +++ phpdoc-fr/features/file-upload.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <chapter id="features.file-upload"> <title>Gestion des chargements de fichier</title> <sect1 id="features.file-upload.post-method"> @@ -14,6 +14,16 @@ de manipulation des fichiers, vous avez un contrôle total sur le chargement et la gestion des fichiers chargés. </simpara> + <note> + <title>Notes de configuration</title> + <para> + Voir aussi les directives + <link linkend="ini.file-uploads">file_uploads</link>, + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, + <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> et + <link linkend="ini.post-max-size">post_max_size</link>, dans &php.ini; + </para> + </note> <para> Notez bien que PHP supporte aussi le chargement par la méthode PUT comme dans le navigateur Netscape Composer @@ -22,180 +32,157 @@ méthode PUT</link>. </para> <para> - Un écran de chargement de fichiers peut être constitué - en créant un formulaire de la manière suivante : - <example> + Un écran de chargement de fichiers peut être constitué + en créant un formulaire de la manière suivante : + <example> <title>Formulaire de chargement de fichier</title> <programlisting role="html"> -<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD="POST"> -<INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000"> -Envoyez ce fichier : <INPUT NAME="userfile" TYPE="file"> -<INPUT TYPE="submit" VALUE="Send File"> -</FORM> + <![CDATA[ +<FORM ENCTYPE="multipart/form-data" ACTION="_URL_" METHOD="POST"> +<INPUT TYPE="hidden" name="MAX_FILE_SIZE" value="1000"> +Envoyez ce fichier : <INPUT NAME="userfile" TYPE="file"> +<INPUT TYPE="submit" VALUE="Send File"> +</FORM> +]]> </programlisting> - </example> + </example> Le paramètre _URL_ doit pointer sur un fichier PHP. L'option MAX_FILE_SIZE cachée doit précéder le nom du fichier à charger, et représente la taille maximale du fichier à charger. La valeur est donnée en octets. Dans ce script, les valeurs suivantes doivent être - définies pour assurer un chargement correct : + définies pour assurer un chargement correct. + </para> + <warning> + <para> + Le champs MAX_FILE_SIZE est là à titre de conseil au navigateur. + Il est très facile de contourner cette restriction. Ne comptez pas + sur le respect de cette configuration par le navigateur! La configuration + de &php; sur la taille maximale à respecter (<link linkend="ini.upload-max-filesize">upload_max_filesize</link>) + ne peut être contournée, elle. + </para> + </warning> + <para> + Les variables définies après un téléchargement de fichiers diffèrent + beaucoup de version en version. La variable + <link linkend="reserved.variables.files">$_FILES</link> + existe depuis PHP 4.1.0. Le tableau <varname>$HTTP_POST_FILES</varname> + existe depuis PHP 4.0.0. Ces tableaux contiennent toutes les données + sur les fichiers téléchargés. L'utilisation de la variable <varname>$_FILES</varname> + est recommandée. Si la directive &php; + <link linkend="ini.register-globals">register_globals</link> vaut + <emphasis>on</emphasis>, les variables reliées existeront aussi. + <link linkend="ini.register-globals">register_globals</link> + vaut par défaut <emphasis>off</emphasis> depuis &php; + <ulink url="&url.php.release4.2.0;">4.2.0</ulink>. </para> - <para> - En PHP 3, les variables suivantes seront définies dans - le script de destination, en cas de téléchargement réussi, et en - supposant que <link linkend="ini.register-globals">register_globals</link> - est activé dans le fichier <filename>php.ini</filename>. Si <link - linkend="ini.track-vars">track_vars</link> est activé, elles seront aussi - disponibles dans le dossier <varname>$HTTP_POST_VARS</varname>. - Notez que les noms des variables suivantes supposent que nom du - fichier téléchargé est 'userfile', comme - présenté dans l'exemple ci-dessus. - <itemizedlist> - <listitem> - <simpara> - <varname>$userfile</varname> - Le nom temporaire du fichier qui - sera chargé sur la machine serveur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_name</varname> - Le nom du fichier original - sur le système de l'envoyeur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_size</varname> - La taille du fichier envoyé - en octets. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_type</varname> - Le type MIME du fichier, si - le navigateur a fourni cette information. Par exemple, - <literal>"image/gif"</literal>. - </simpara> - </listitem> - </itemizedlist> - Notez que "$userfile" prend la valeur qui est passée dans - le champs INPUT de type TYPE=file. Dans l'exemple ci-dessus, - nous avons choisi de l'appeler "userfile". - </para> - <para> - En PHP 4, le comportement est légèrement différent, car c'est la - variable d'environnement <varname>$HTTP_POST_FILES</varname>, qui - contiendra les informations sur les fichiers téléchargés. - Ces informations sont disponibles dans si l'option - <link linkend="ini.track-vars">track_vars</link> est activée, mais - <link linkend="ini.track-vars">track_vars</link> est toujours - activée dans les versions de PHP supérieures à la version - 4.0.2. - </para> - <para> - Le contenu du tableau <varname>$HTTP_POST_FILES</varname> décrit - ci-dessous. Notez que l'on suppose ici que le nom du fichier - téléchargé est '<literal>userfile</literal>', - comme présenté dans l'exemple ci-dessus : + <para> + Le contenu du tableau <link linkend="reserved.variables.files">$_FILES</link> + est détaillé dans notre exmple ci-dessous. Notez que l'un suppose que le nom + de la variable du fichier téléchargé est <emphasis>userfile</emphasis>, tel que + défini dans le formulaire ci-dessus. <variablelist> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['name']</varname></term> + <term><varname>$_FILES['userfile']['name']</varname></term> <listitem> <para> - Le nom du fichier original sur la machine source. + Le nom original du fichier, tel que sur la machine du client web. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['type']</varname></term> + <term><varname>$_FILES['userfile']['type']</varname></term> <listitem> <para> - Le type MIME du fichier, si le navigateur a fourni cette information. - Par exemple, <literal>"image/gif"</literal>. + Le type MIME du fichier, si le navigateur a fourni cette information. + Par exemple, cela pourra être <literal>"image/gif"</literal>. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['size']</varname></term> + <term><varname>$_FILES['userfile']['size']</varname></term> <listitem> <para> - La taille du fichier envoyé, en octets. + La taille, en octets, du fichier téléchargé. </para> </listitem> </varlistentry> <varlistentry> - <term><varname>$HTTP_POST_FILES['userfile']['tmp_name']</varname></term> + <term><varname>$_FILES['userfile']['tmp_name']</varname></term> <listitem> <para> - Le nom temporaire du fichier qui sera chargé sur la machine serveur. + Le nom temporaire du fichier qui sera chargé sur la machine serveur. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>$_FILES['userfile']['error']</varname></term> + <listitem> + <para> + Le code d'erreur <link linkend="features.file-upload.errors">error code</link> + associaé au téléchargement de fichier. <emphasis>['error']</emphasis> + a été introduit en PHP 4.2.0 </para> </listitem> </varlistentry> </variablelist> </para> + <note> + <para> + Dans les versions de &php; antérieure à la version 4.1.0, la variable + <varname>$_FILES</varname> s'appelait <varname>$HTTP_POST_FILES</varname> et + ce n'était pas une variable + <link linkend="language.variables.superglobals">autoglobale</link> + comme l'est <varname>$_FILES</varname>. PHP 3 ne supporte pas + <varname>$HTTP_POST_FILES</varname>. + </para> + </note> <para> - Les fichiers seront enregistrés par défaut dans le dossier - des fichiers temporaires, à moins qu'un autre dossier - n'ait été fourni avec la directive de configuration - <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> du fichier - <filename>php.ini</filename>. Le dossier par défaut du serveur - peut être modifié grâce à la variable d'environnement - <envar>TMPDIR</envar>, de l'utilisateur qui exécute PHP. - Sa modification avec <function>putenv</function> depuis un script PHP - ne fonctionnera pas. Cette variable d'environnement peut aussi être - utilisée pour s'assurer que d'autres opérations fonctionnent avec - les fichiers téléchargés. + Lorsque <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>on</emphasis> dans le &php.ini;, des variables supplémentaires + sont rendues disponibles. Par exemple + <varname>$userfile_name</varname> vaut + <varname>$_FILES['userfile']['name']</varname>, + <varname>$userfile_type</varname> vaut + <varname>$_FILES['userfile']['type']</varname>, etc... Gardez à l'esprit + que depuis &php; 4.2.0, <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>off</emphasis> par défaut. Il n'est pas prudent de + supposer que cette directive vaut <emphasis>on</emphasis>. + </para> + <para> + Le fichier téléchargé sera stocké temporairement dans le dossier + temporaire du système, à moins qu'un autre dossier soit fourni avec + la directive <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> du + &php.ini;. Le dossier par défaut du serveur peut être changé + dans l'environnement via la variable <envar>TMPDIR</envar>. + Modifier la valeur de cette variable avec la fonction <function>putenv</function> + dans un script &php; sera sans effet. Cette variable d'environnement + peut aussi être utilisée pour s'assurer que d'autres opérations + fonctionnent aussi sur les fichiers téléchargés. <example> - <title>Validation de fichiers téléchargés</title> - <para> - Les exemples suivants fonctionnent sur les versions - de PHP 3 supérieures à la version 3.0.16, et supérieures - à la version 4.0.2 pour PHP 4. Reportez-vous à - la section des fonctions pour étudier - <function>is_uploaded_file</function> et <function>move_uploaded_file</function>. - </para> - <programlisting role="php"> -<?;php -if (is_uploaded_file($userfile)) { - copy($userfile, "/dossier/des/fichiers/telecharges/"); -} else { - echo "Attaque potentielle par fichier téléchargé : fichier '$userfile'."; -} -/* ...ou... */ -move_uploaded_file($userfile, "/dossier/des/fichiers/telecharges"); -?> - </programlisting> + <title>Validation de téléchargement de fichiers</title> <para> - Pour les versions plus anciennes de PHP, vous devrez faire quelque - chose comme ceci : + Les exemples ci-dessous sont valables avec les versions de &php; + plus récentes que la 4.0.2. Voyez les fonctions + <function>is_uploaded_file</function> et + <function>move_uploaded_file</function>. </para> <programlisting role="php"> -<?;php -/* Test du fichier téléchargé. */ -function is_uploaded_file($filename) { - if (!$tmp_file = get_cfg_var('upload_tmp_dir')) { - $tmp_file = dirname(tempnam('', '')); - } - $tmp_file .= '/' . basename($filename); - /* L'utilisateur peut avoir un slash final dans <filename>php.ini</filename>... */ - return (ereg_replace('/+', '/', $tmp_file) == $filename); -} -if (is_uploaded_file($userfile)) { - copy($userfile, "/place/to/put/uploaded/file"); +<![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"); } else { - echo "Attaque potentielle par fichier téléchargé : fichier '$userfile'."; + echo "Attaque par upload potentielle le fichier : " . $_FILES['userfile']['name']; } -?> +/* ...ou bien... */ +move_uploaded_file($_FILES['userfile']['tmp_name'], "/place/to/put/uploaded/file"); +?> +]]> </programlisting> </example> </para> - <note> - <para> - Cela ne fonctionnera <emphasis>PAS</emphasis> avec les versions de - PHP 4 supérieure à 4.0.2. Cela repose sur des fonctionnalités - internes à PHP qui ont évolué après cette version. - </para> - </note> <simpara> Le script PHP qui reçoit le fichier chargé doit pouvoir gérer le fichier de manière appropriée. Vous @@ -204,6 +191,11 @@ la variable <varname>$file_type</varname> pour recaler les fichiers qui n'ont pas le bon type. Quelques soient les actions, ce script doit pouvoir supprimer le fichier du dossier temporaire, ou le déplacer ailleurs. + Depuis &php; 4.2.0, vous pouvez utiliser l'information dans + <varname>$_FILES['userfile']['error']</varname> et adapter votre politique + en fonction des <link linkend="features.file-upload.errors">code d'erreur</link>. + Quelque soit votre politique, vous devriez soit effacer le fichier du + dossier temporaire, soit le déplacer. </simpara> <simpara> Le fichier sera automatiquement effacé du fichier temporaire @@ -211,6 +203,70 @@ déplacé ou renommé. </simpara> </sect1> + + <sect1 id="features.file-upload.errors"> + <title>Explication sur les messages d'erreurs de chargement de fichiers</title> + <simpara> + Depuis PHP 4.2.0, &php; retourne un code d'erreur approprié dans le + tableau de fichiers. Ce code d'erreur est accessible à l'index + <emphasis>error</emphasis> du tableau, qui est créé durant + le téléchargement, par &php;. En d'autres termes, le message d'erreur + est accessible dans la variable <varname>$_FILES['userfile']['error']</varname>. + </simpara> + <para> + <variablelist> + <varlistentry> + <term><varname>UPLOAD_ERR_OK</varname></term> + <listitem> + <para> + Valeur : 0. Aucune erreur, le téléchargement est correct. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_INI_SIZE</varname></term> + <listitem> + <para> + Valeur : 1. Le fichier téléchargé excède la taille de + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, + configuré dans le &php.ini;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_FORM_SIZE</varname></term> + <listitem> + <para> + Valeur : 2. Le fichier téléchargé excède la taille de + <emphasis>MAX_FILE_SIZE</emphasis>, qui a été spécifiée dans + le formulaire HTML. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_PARTIAL</varname></term> + <listitem> + <para> + Valeur : 3. Le fichier n'a été que partiellement téléchargé. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_NO_FILE</varname></term> + <listitem> + <para> + Valeur : 4. Aucun fichier n'a été téléchargé. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <note> + <para> + Ces constantes sont apparues en PHP 4.3.0. + </para> + </note> + </sect1> <sect1 id="features.file-upload.common-pitfalls"> <title>Erreurs classiques</title> <simpara> @@ -230,60 +286,71 @@ CERN httpd ne pourra pas effectuer de chargement. </simpara> </sect1> - <sect1 id="feature-fileupload.multiple"> - <title>Chargement multiples de fichiers</title> + <sect1 id="features.file-upload.multiple"> + <title>Télécharger plusieurs fichiers simultanément</title> + <simpara> + Le téléchargement de plusieurs fichiers est possible + en utilisant des noms différents dans l'attribut + <literal>name</literal> de la balise <literal>input</literal>. + </simpara> <simpara> - Il est possible de charger plusieurs fichiers en même temps, et de - recevoir les informations adéquates organisées sous - forme de tableau. Pour ce faire, il faut utiliser la même - syntaxe d'envoi dans le code HTML que pour les sélections ou - boîtes à cocher multiples. + Il est aussi possible de télécharger plusieurs fichiers simultanément + et d'obtenir les informations sous forme de tableau. Pour cela, vous + devez utiliser la syntaxe de tableau dans les noms de balises + HTML, comme vous l'avez fait avec les sélections multiples + et les boîtes à cocher. </simpara> <note> <para> - Le support du chargement multiple de fichier a été - ajouté dans la version 3.0.10. + Le support des téléchargement multiples a été ajouté + en &php; 3.0.10. </para> </note> <para> <example> - <title>Chargement multiple de fichier </title> + <title>Télécharger plusieurs fichiers simultanément</title> <programlisting role="html"> -<form action="file-upload.html" method="post" enctype="multipart/form-data"> - Send these files:<br> - <input name="userfile[]" type="file"><br> - <input name="userfile[]" type="file"><br> - <input type="submit" value="Send files"> -</form> +<![CDATA[ +<FORM ACTION="file-upload.php" METHOD="post" ENCTYPE="multipart/form-data"> + Envoyez plusieurs fichiers : <BR> + <INPUT NAME="userfile[]" TYPE="file"><BR> + <INPUT NAME="userfile[]" TYPE="file"><BR> + <INPUT TYPE="submit" VALUE="Send files"> +</FORM> +]]> </programlisting> </example> </para> <simpara> - Lorsque le formulaire ci-dessus a étéF envoyé, les tableaux - <computeroutput>$userfile</computeroutput>, - <computeroutput>$userfile_name</computeroutput>, et - <computeroutput>$userfile_size</computeroutput> seront initialisés - (ainsi que $HTTP_POST_VARS). Chaque tableau sera de type - numérique, et contiendra les valeurs appropriées - pour le chargement des fichiers. + Lorsque le formulaire ci-dessus a été envoyé, les + tableaux <varname>$_FILES['userfile']</varname>, + <varname>$_FILES['userfile']['name']</varname>, et + <varname>$_FILES['userfile']['size']</varname> seront initialisés + (tout comme <varname>$HTTP_POST_FILES</varname> pour les versions + de &php; antérieure à la 4.1.0). Lorsque + <literal>register_globals</literal> est activé, les variables + globales concernant les fichiers téléchargés sont aussi + initialisées. Chacune d'entre elle contiendra un tableau + numériquement indexé, avec les valeurs décrivant les fichiers + téléchargés. </simpara> <simpara> - Par exemple, supposons que les noms de fichier + Par exemple, supposons que les fichiers <filename>/home/test/review.html</filename> et - <filename>/home/test/xwp.out</filename> soient envoyés. - Dans ce cas, <computeroutput>$userfile_name[0]</computeroutput> - va contenir <computeroutput>review.html</computeroutput>, - et <computeroutput>$userfile_name[1]</computeroutput> contiendra - <computeroutput>xwp.out</computeroutput>. Similairement, - <computeroutput>$userfile_size[0]</computeroutput> contiendra - la taille de <filename>review.html</filename>, etc... + <filename>/home/test/xwp.out</filename> ont été téléchargé. Dans ce cas, + <varname>$_FILES['userfile']['name'][0]</varname> + contient <filename>review.html</filename> et + <varname>$_FILES['userfile']['name'][1]</varname> contient + <filename>xwp.out</filename>. Similairement, + <varname>$_FILES['userfile']['size'][0]</varname> va contenir + la taille du fichier <filename>review.html</filename>, etc... </simpara> <simpara> - <computeroutput>$userfile['name'][0]</computeroutput>, - <computeroutput>$userfile['tmp_name'][0]</computeroutput>, - <computeroutput>$userfile['size'][0]</computeroutput>, et - <computeroutput>$userfile['type'][0]</computeroutput> - sont aussi affectés. + <varname>$_FILES['userfile']['name'][0]</varname>, + <varname>$_FILES['userfile']['tmp_name'][0]</varname>, + <varname>$_FILES['userfile']['size'][0]</varname> et + <varname>$_FILES['userfile']['type'][0]</varname> sont aussi + créées. </simpara> </sect1> <sect1 id="features.file-upload.put-method"> @@ -320,19 +387,22 @@ </para> <simpara> Elle indique à Apache qu'il doit envoyer les requêtes - de chargement par méthode PUT au script put.php3. Bien entendu, + de chargement par méthode PUT au script + <filename>put.php3</filename>. Bien entendu, cela présuppose que vous avez activé PHP pour qu'il prenne en charge les fichiers de type .php3, et que PHP est actif. </simpara> <simpara> - Dans le fichier put.php3 file vous pouvez mettre ceci : + Dans le fichier <filename>put.php3</filename>, vous pouvez mettre ceci : </simpara> <para> <informalexample> <programlisting role="php"> -<?php + <![CDATA[ +<?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); -?> +?> +]]> </programlisting> </informalexample> </para> @@ -344,11 +414,11 @@ est que lorsque PHP reçoit un chargement par méthode PUT, il va enregistrer le fichier dans le dossier temporaire, tout comme avec la - <link linkend="features.file-upload.post-method">méthode POST-method</link>. + <link linkend="features.file-upload.post-method">méthode POST</link>. A la fin de la requête, le fichier sera effacé. Ce qui fait que ce script doit placer le fichier chargé quelque part. Le nom du fichier temporaire est placé dans la variable - globale $PHP_PUT_FILENAME, et la destination prévue est + globale <varname>$PHP_PUT_FILENAME</varname>, et la destination prévue est placée dans <varname>$REQUEST_URI</varname> (ces noms peuvent changer d'une configuration d'Apache à l'autre). Cette destination est celle qui est demandée par le client, et vous n'avez pas Index: phpdoc-fr/features/http-auth.xml diff -u phpdoc-fr/features/http-auth.xml:1.11 phpdoc-fr/features/http-auth.xml:1.12 --- phpdoc-fr/features/http-auth.xml:1.11 Tue Jan 29 18:18:15 2002 +++ phpdoc-fr/features/http-auth.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <chapter id="features.http-auth"> <title>Authentification HTTP avec PHP</title> <simpara> @@ -18,26 +18,53 @@ simple ("Basic") est supportée. Reportez-vous à la fonction <function>header</function> pour plus d'informations. </simpara> + + <note> + <title>Note sur les versions de PHP</title> + <para> + Les <link linkend="language.variables.superglobals">auto-globales</link>, + telles que <link linkend="reserved.variables.server">$_SERVER</link>, ont été + ajoutée en &php; à partir de la version + <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. + <varname>$HTTP_SERVER_VARS</varname> est disponible depuis PHP 3. + </para> + </note> + <para> Voici un exemple de script qui force l'authentification du client pour accéder à une page : <example> <title>Exemple d'authentification HTTP</title> <programlisting role="php"> -<?php - if(!isset($PHP_AUTH_USER)) { - Header("WWW-Authenticate: Basic realm=\"My Realm\""); - Header("HTTP/1.0 401 Unauthorized"); - echo "Texte à envoyer si le client appuie sur le bouton d'annulation\n"; +<![CDATA[ +<?php + if (!isset($_SERVER['PHP_AUTH_USER'])) { + header('WWW-Authenticate: Basic realm="My Realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Texte utilisé si le visiteur utilise le bouton d\'annulation'; exit; } else { - echo "Bonjour $PHP_AUTH_USER.<P>" - echo "Vous avez entré le mot de passe $PHP_AUTH_PW.<P>" + echo "<p>Bonjour, {$_SERVER['PHP_AUTH_USER']}.</p>"; + echo "<p>Votre mot de passe est {$_SERVER['PHP_AUTH_PW']}.</p>"; } -?> +?> +]]> </programlisting> </example> </para> + + <note> + <title>Note de compatibilité</title> + <para> + Soyez bien prudent lorsque vous utilisez des entêtes HTTP avec &php;. Afin de + garantir un maximum de compatibilité entre les navigateurs, le mot clé + "Basic" doit être écrit avec un B majuscule, et le texte de présentation + doit être placé entre guillemets simples, et exactement un espace doit + précéder le code <emphasis>401</emphasis> dans l'entête + <emphasis>HTTP/1.0 401</emphasis>. + </para> + </note> + <para> Au lieu d'afficher simplement les variables globales <varname>$PHP_AUTH_USER</varname> et <varname>$PHP_AUTH_PW</varname>, vous préférerez sûrement @@ -58,9 +85,21 @@ quelle on a accédé par une authentification traditionnelle, les variables globales PHP_AUTH ne seront pas assignées si l'authentification externe a été activée pour - cette page. Dans ce cas, la variable <varname>$REMOTE_USER</varname> peut être + cette page. Dans ce cas, la variable <varname>REMOTE_USER</varname> peut être utilisée pour identifier l'utilisateur à l'extérieur. + De même que <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> + <note> + <title>Note de configuration</title> + <para> + &php; utilise la présence de la directive <literal>AuthType</literal> + pour déterminer si une authentification externe est activé. + vitez donc cette directive de contexte si vous voulez utiliser + l'authentification de &php; (sinon, les deux authentifications + se contrediront, et échoueront). + </para> + </note> + <simpara> Notez cependant que les manipulations ci-dessus n'empêchent pas quiconque possède une page non authentifiée @@ -79,26 +118,29 @@ Authentification HTTP avec nom d'utilisateur/mot de passe forcé </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php function authenticate() { - Header( "WWW-Authenticate: Basic realm=\"Test Authentication System\""); - Header( "HTTP/1.0 401 Unauthorized"); - echo "Vous devez entrer un nom d'utilisateur valide et un mot de passe correct pour accéder à cette ressource\n"; - exit; + header('WWW-Authenticate: Basic realm="Test Authentication System"'); + header('HTTP/1.0 401 Unauthorized'); + echo "You must enter a valid login ID and password to access this resource\n"; + exit; } - if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) { + + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); - } + } else { - echo "Bienvenue $PHP_AUTH_USER<BR>"; - echo "Old: $OldAuth"; - echo "<form action=\"$PHP_SELF\" method=post>\n"; - echo "<input type=hidden NAME=\"SeenBefore\" VALUE=\"1\">\n"; - echo "<input type=hidden NAME=\"OldAuth\" VALUE=\"$PHP_AUTH_USER\">\n"; - echo "<input type=submit value=\"Re Authenticate\">\n" - echo "</FORM>\n"; + echo "<p>Welcome: {$_SERVER['PHP_AUTH_USER']}<br>"; + echo "Old: {$_REQUEST['OldAuth']}"; + echo "<form action='{$_SERVER['PHP_SELF']}' METHOD='POST'>\n"; + echo "<input type='hidden' name='SeenBefore' value='1'>\n"; + echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}'>\n"; + echo "<input type='submit' value='Re Authenticate'>\n"; + echo "</form></p>\n"; } -?> +?> +]]> </programlisting> </example> <simpara> @@ -115,6 +157,14 @@ Notez aussi que tout ceci ne fonctionne pas sous Microsoft IIS et que les limitations de PHP en version CGI sont dues aux limitations de IIS. </simpara> + <note> + <para> + Si le &safemode; est activé, l'uid du script es ajouté automatiquement + dans l'entête <literal>realm</literal>, comme faisant partie de l'entête + <literal>WWW-Authenticate</literal>. + </para> + </note> + </chapter> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/features/images.xml diff -u phpdoc-fr/features/images.xml:1.6 phpdoc-fr/features/images.xml:1.7 --- phpdoc-fr/features/images.xml:1.6 Wed Dec 12 15:48:51 2001 +++ phpdoc-fr/features/images.xml Thu Jan 30 08:44:04 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <chapter id="features.images"> <title>Création d'images</title> <simpara> @@ -16,7 +16,8 @@ <example> <title>Création d'images GIF avec PHP</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php header("Content-type: image/png"); $string=implode($argv," "); $im = imagecreatefrompng("images/button1.png"); @@ -25,7 +26,8 @@ imagestring($im,3,$px,9,$string,$orange); imagepng($im); imagedestroy($im); -?> +?> +]]> </programlisting> </example> Cet exemple sera appelé depuis une page HTML avec une balise Index: phpdoc-fr/features/remote-files.xml diff -u phpdoc-fr/features/remote-files.xml:1.8 phpdoc-fr/features/remote-files.xml:1.9 --- phpdoc-fr/features/remote-files.xml:1.8 Sun Jan 6 19:09:54 2002 +++ phpdoc-fr/features/remote-files.xml Thu Jan 30 08:44:04 2003 @@ -1,21 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <chapter id="features.remote-files"> <title>Utilisation des fichiers à distance</title> <para> - Aussi longtemps que le support de la fonction d'ouverture - générique de fichiers ("URL fopen wrapper") - est actif lorsque vous configurez PHP (il est inutile de - passer explicitement l'option - <link linkend="install.configure.disable-url-fopen-wrapper">--disable-url-fopen-wrapper</link> - pour faire la configuration), vous pouvez utiliser des URLs + Aussi longtemps que le support des gestionnaires d'URL ("URL fopen wrapper") + sont activés dans le &php.ini;, vous pouvez utiliser des URLs (HTTP et FTP) avec la majorité des fonctions qui utilisent un - nom de fichier comme paramètre, ceci incluant les expressions - <function>require</function> et <function>include</function>. + nom de fichier comme paramètre. Cela inclut notamment + <function>include</function>, <function>include_once</function>, + <function>require</function> et <function>require_once</function>. + Reportez-vous à <xref linkend="wrappers"/> pour plus d'informations + sur les protocoles supportés par &php;. + </para> + <note> + <para> + En PHP 4.0.3 et plus récent, pour pouvoir utiliser les gestionnaires + d'URL, vous devez configurer &php; avec l'option + <option>--enable-url-fopen-wrapper</option>. + </para> + </note> + <para> <note> <para> - Vous ne pouvez pas utiliser les fichiers distants dans les expressions - <function>include</function> et <function>require</function> sous Windows. + Les versions de &php; pour Windows plus anciennes que 4.3 + de supportait pas les gestionnaires d'URL avec les fonctions suivantes : + <function>include</function>, <function>include_once</function>, + <function>require</function>, <function>require_once</function>, + et les fonctions de création d'images de l'extension <xref linkend="ref.image"/>. </para> </note> </para> @@ -30,22 +41,24 @@ <example> <title>Connaître le titre d'une page distante</title> <programlisting role="php"> -<?php - $file = fopen("http://www.php.net/", "r"); - if (!$file) { - echo "<p>Impossible d'ouvrir le fichier distant.\n"; +<![CDATA[ +<?php +$file = fopen ("http://www.example.com/", "r"); +if (!$file) { + echo "<p>Impossible de lire la page.\n"; exit; - } - while (!feof($file)) { - $line = fgets($file, 1024); - /* Cela ne fonctionne que si le titre est écrit sur une ligne.*/ - if (eregi("<title>(.*)</title>", $line, $out)) { - $title = $out[1]; - break; +} +while (!feof ($file)) { + $line = fgets ($file, 1024); + /* Cela ne fonctionne que si les balises Title sont correctement utilisées */ + if (eregi ("<title>(.*)</title>", $line, $out)) { + $title = $out[1]; + break; } - } - fclose($file); -?> +} +fclose($file); +?> +]]> </programlisting> </example> </para> @@ -53,7 +66,10 @@ Vous pouvez aussi écrire des fichiers sur un serveur FTP aussi longtemps que vous êtes connecté avec un utilisateur ayant les bons droits d'accès, alors que le - fichier n'existait pas encore. Pour vous connecter avec un + fichier n'existait pas encore. + </para> + <para> + Pour vous connecter avec un utilisateur autre qu'anonyme, vous devez spécifier un nom d'utilisateur (et certainement le mot de passe) dans l'URL, comme par exemple 'ftp://user:password@ftp.example.com/path/to/file'. @@ -65,16 +81,18 @@ <example> <title>Stocker des données sur un serveur distant</title> <programlisting role="php"> -<?php - $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); - if (!$file) { - echo "<p>Impossible d'ouvrir un fichier distant en écriture.\n"; +<![CDATA[ +<?php +$file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w"); +if (!$file) { + echo "<p>Unable to open remote file for writing.\n"; exit; - } +} /* Ecriture des données. */ - fputs($file, "$HTTP_USER_AGENT\n"); - fclose($file); -?> +fputs ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); +fclose ($file); +?> +]]> </programlisting> </example> <note> Index: phpdoc-fr/features/safe-mode.xml diff -u phpdoc-fr/features/safe-mode.xml:1.4 phpdoc-fr/features/safe-mode.xml:1.5 --- phpdoc-fr/features/safe-mode.xml:1.4 Wed Dec 12 15:48:52 2001 +++ phpdoc-fr/features/safe-mode.xml Thu Jan 30 08:44:04 2003 @@ -1,97 +1,348 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <chapter id="features.safe-mode"> <title>Safe mode</title> + <para> - Le "Safe Mode" est le mode de sécurité de PHP : une solution au problème - de partage de PHP sur un serveur. Ce système pêche au niveau de l'architecture - car il n'est pas correct de tenter de résoudre ce problème au niveau - de PHP, mais les solutions alternatives basées sur le serveur web et l'OS - ne sont pas réalistes. De nombreux acteurs, notamment les fournisseurs - d'hébergement, utilise le "Safe Mode". - </para> - <para> - Les directives de configuration qui contrôlent le safe mode sont : - <informalexample> - <programlisting role="ini"> -safe_mode = Off -open_basedir = -safe_mode_exec_dir = -safe_mode_allowed_env_vars = PHP_ -safe_mode_protected_env_vars = LD_LIBRARY_PATH -disable_functions = - </programlisting> - </informalexample> + Le "Safe Mode" est le mode de sécurité de PHP : + une solution au problème de partage de PHP sur un serveur. + Ce système pêche au niveau de l'architecture + car il n'est pas correct de tenter de résoudre ce + problème au niveau de PHP, mais les solutions + alternatives basées sur le serveur web et l'OS + ne sont pas réalistes. De nombreux intervenants, + notamment les fournisseurs d'hébergement, utilisent + le "Safe Mode". </para> + + <sect1 id="ini.sect.safe-mode"> + <title>Securité et Safe Mode</title> + <para> + <table> + <title>Directives de sécurité et de Safe Mode</title> + <tgroup cols="3"> + <thead> + &ini.table.title; + </thead> + <tbody> + <row> + <entry>safe_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_gid</entry> + <entry>"0"</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_include_dir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_exec_dir</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_allowed_env_vars</entry> + <entry>PHP_</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>safe_mode_protected_env_vars</entry> + <entry>LD_LIBRARY_PATH</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>open_basedir</entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + <row> + <entry>disable_functions</entry> + <entry>""</entry> + <entry>PHP_INI_SYSTEM</entry> + </row> + </tbody> + </tgroup> + </table> + &ini.table.bottom; + + </para> + <para> + Voici des éclaircissements sur ces directives. + <variablelist> + <varlistentry id="ini.safe-mode"> + <term> + <parameter>safe_mode</parameter> + <type>&boolean;</type> + </term> + <listitem> + <para> + Active ou non le mode de sécurité de &php;. Lisez le chapitre + <link linkend="security">sécurité</link> pour plus d'informations. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-gid"> + <term> + <parameter>safe_mode_gid</parameter> + <type>&boolean;</type> + </term> + <listitem> + <para> + Par défaut, le safe mode fait une comparaison des + propriétaires, avant d'ouvrir un fichier. Si vous voulez + alléger un peu ce niveau de sécurité, vous pouvez + réaliser une comparaison de groupe, et activer cette + directive. + Si cette directive vaut &false; (sa valeur par défaut), + c'est une comparaison sur les <literal>UID</literal>, + et sinon, sur les <literal>GID</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-include-dir"> + <term> + <parameter>safe_mode_include_dir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Les vérifications basées sur le <literal>UID</literal> ou <literal>GID</literal> + sont ignorées lorsque les fichiers sont issus du dossier + et de ses sous-dossiers, indiqué dans cette directive. Les + dossiers peuvent être aussi dans l'<link linkend="ini.include-path">include_path</link> + ou bien il faut inclure le chemin complet. + </para> + <simpara> + Depuis &php; 4.2.0, cette directive utilise le point virgule + de la même façon que le fait + <link linkend="ini.include-path">include_path</link>, pour + permettre de configurer plusieurs dossiers. + </simpara> + <simpara> + La restriction spécifiée est en fait un préfixe, plus qu'un + nom de dossier. Cela signifie que "safe_mode_include_dir = /dir/incl" + autorise aussi bien "/dir/include" que "/dir/incls", si ils existent. + Lorsque vous souhaitez restreindre l'accès à un dossier spécifique, + il faut terminer cette directive avec un slash /. Par exemple + "safe_mode_include_dir = /dir/incl/" + </simpara> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-exec-dir"> + <term> + <parameter>safe_mode_exec_dir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Si &php; est utilisé en safe mode, les fonctions comme <function>system</function> + et toutes celles qui permettent l'exécution en + <link linkend="ref.exec">ligne de commande</link> refuseront d'exécuter des programmes + qui ne sont pas dans ce dossier. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-allowed-env-vars"> + <term> + <parameter>safe_mode_allowed_env_vars</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Modifier certaines variables d'environnement est un trou de + sécurité potentiel. Cette directive contient une liste de noms + variables d'environnement séparées par des virgules, ou de préfixes. + En Safe mode, l'utilisateur ne pourra modifier que les + variables d'environnement dont le nom commence par l'un des préfixes + fourni ici. Par défaut, les utilisateurs ne peuvent modifier que + les variables d'environnemt qui commencent par PHP_ (e.g. PHP_FOO=BAR). + </para> + <note> + <para> + Si cette directive est vide, &php; autorisera la modification + de TOUTES les variables d'environnement. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry id="ini.safe-mode-protected-env-vars"> + <term> + <parameter>safe_mode_protected_env_vars</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Cette directive contient une liste de variables d'environnement + que le programmeur ne pourra pas modifier en utilisant la + fonction <function>putenv</function>. Ces variables seront protégées, + même is la directive safe_mode_allowed_env_vars autorise leur + modification. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.open-basedir"> + <term> + <parameter>open_basedir</parameter> + <type>&string;</type> + </term> + <listitem> + <para> + Limite les fichiers accessibles par &php; dans l'arborescence. + Cette directive <emphasis>n'est pas</emphasis> affectée + par le safe mode. + </para> + <para> + Lorsqu'un script tente d'ouvrir un fichier, avec les fonctions + <function>fopen</function> ou <function>gzopen</function>, la situation + du fichier est vérifiée. Si le fichier se situe hors du dossier + spécifié dans cette directive,&php; refusera de l'ouvrir. + Les liens symboliques sont résolus, ce qui fait que cette + restriction ne peut être contournée par un lien symbolique. + </para> + <para> + La valeur spéciale <systemitem class="constant">.</systemitem> + indique que le dossier dans lequel le script est stocké, servira + de dossier de base. + </para> + <para> + Sous Windows, séparez les dossiers par des deux points. Sur les autres + systèmes, séparez les dossiers avec un point-virgule. Lorsque &php; est utilisé + comme module Apache, les chemins de la directive open_basedir des + dossiers parents sont automatiques transmis. + </para> + <para> + La restriction spécifiée par open_basedir est en fait un + préfixe, et non un dossier. Cela signifie que + "open_basedir = /dir/incl" donne accès au dossier "/dir/include" + et aussi au dossier "/dir/incls" si il existe. Lorsque vous souhaitez + restreindre l'accès à un dossier spécifique, ajoutez un slash final. + Par exemple "open_basedir = /dir/incl/". + </para> + <note> + <para> + Le support des dossiers multiples a été ajouté en &php; 3.0.7. + </para> + </note> + <para> + La valeur par défaut est de permettre l'ouverture de + tous les fichiers. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.disable-functions"> + <term> + <parameter>disable_functions</parameter> + <type>&string;</type> + </term> + <listitem> + <simpara> + Cette directive vous permet de désactiver certaines fonctions + pour des raisons de <link linkend="security">sécurité</link>. Elle + prend une liste de nom de fonctions, séparés par des + virgules. disable_functions n'est pas affectée par le + <link linkend="ini.safe-mode">Safe Mode</link>. + </simpara> + <simpara> + Cette directive doit être configurée dans le fichier &php.ini;. Par exemple, + vous ne pourrez pas la configurer dans le fichier + <filename>httpd.conf</filename>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Voir aussi + <link linkend="ini.register-globals">register_globals</link>, + <link linkend="ini.display-errors">display_errors</link> et + <link linkend="ini.log-errors">log_errors</link> + </para> + <para> Lorsque <link linkend="ini.safe-mode">safe_mode</link> est actif, PHP vérifie que le propriétaire du script courant est le même que le propriétaire des fichiers qui seront manipulés par ce script. Par exemple, dans a la situation suivante : - <informalexample> - <programlisting role="ls"> --rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php --rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd - </programlisting> - </informalexample> + <programlisting role="ls"> +<![CDATA[ +-rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php +-rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd +]]> + </programlisting> éxécuter le script <filename>script.php</filename> - <informalexample> - <programlisting role="php"> -<?php - readfile('/etc/passwd'); -?> - </programlisting> - </informalexample> - générera cette erreur, si le safe mode est activé : - <informalexample> - <programlisting> -Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not -allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 + <programlisting role="php"> +<![CDATA[ +<?php + readfile('/etc/passwd'); +?> +]]> </programlisting> - </informalexample> + générera cette erreur, si le &safemode; est activé : + <screen> +<![CDATA[ +Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not +allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 +]]> + </screen> </para> <para> + Cependant, il arrive que la vérification faite avec le nom du propriétaire + du fichier soit trop restrictive, et qu'une vérification sur le nom + du groupe soit suffisante. C'est une autre fonctionnalité supportée + par la directive <link linkend="ini.safe-mode-gid">safe_mode_gid</link>. + En lui donnant la valeur de <literal>On</literal>, les vérifications + seront faites sur le <literal>GID</literal>, alors qu'en lui laissant + sa valeur par défaut de <literal>Off</literal>, les vérifications seront + faites sur le <literal>UID</literal>. + </para> + <para> Si vou utilisez la directive open_basedir au lieu du <link linkend="ini.safe-mode">safe_mode</link>, alors les manipulations seront limitées aux fichiers situés dans les dossiers spécifiés. Par exemple : - <informalexample> - <programlisting role="ini"> -<Directory /docroot> -php_admin_value open_basedir /docroot -</Directory> + <programlisting role="ini"> +<![CDATA[ +<Directory /docroot> + php_admin_value open_basedir /docroot +</Directory> +]]> </programlisting> - </informalexample> Si vous exécutez le script <filename>script.php</filename> ci-dessus avec la configuration d'open_basedir le résultat sera l'affichage suivant : - <informalexample> - <programlisting role="php"> -Warning: open_basedir restriction in effect. File is in wrong directory in -/docroot/script.php on line 2 - </programlisting> - </informalexample> + <screen> +<![CDATA[ +Warning: open_basedir restriction in effect. File is in wrong directory in +/docroot/script.php on line 2 +]]> + </screen> </para> <para> Vous pouvez aussi désactiver individuellement les fonctions. Par exemple, - en ajoutant cette ligne dans le fichier <filename>php.ini</filename> : - <informalexample> - <programlisting role="ini"> -disable_functions readfile,system - </programlisting> - </informalexample> + en ajoutant cette ligne dans le fichier &php.ini; : + <programlisting role="ini"> +<![CDATA[ +disable_functions readfile,system +]]> + </programlisting> toute utilisation des fonctions <function>readfile</function> et <function>system</function> générera l'affichage suivant : - <informalexample> - <programlisting role="php"> -Warning: readfile() has been disabled for security reasons in -/docroot/script.php on line 2 - </programlisting> - </informalexample> + <screen> +<![CDATA[ +Warning: readfile() has been disabled for security reasons in +/docroot/script.php on line 2 +]]> + </screen> </para> + </sect1> <sect1 id="features.safe-mode.functions"> - <title>Functions désactivées par le Safe Mode</title> + <title>Fonctions désactivées par le Safe Mode</title> <para> Voici une liste non-exhaustive des fonctions désactivées par le <link linkend="features.safe-mode">Safe Mode</link>. @@ -174,12 +425,12 @@ <entry>&sm.disabled;</entry> </row> <row> - <entry><link linkend="language.operators.execution">backtick operator</link></entry> + <entry><link linkend="language.operators.execution">opérateur guillemets obliques</link></entry> <entry>&sm.disabled;</entry> </row> <row> - <entry><function>shell_exec</function> (équivalent fonctionnels - des guillemets oblique)</entry> + <entry><function>shell_exec</function> (équivalent fonctionnel + des guillemets obliques)</entry> <entry>&sm.disabled;</entry> </row> <row> @@ -281,9 +532,46 @@ </entry> </row> <row> + <entry><function>header</function></entry> + <entry>Avec le safe mode, le uid du script est ajouté à la partie + <literal>realm</literal> de l'entête + <literal>WWW-Authenticate</literal> si vous utilisez cet entête + pour l'authentification.</entry> + </row> + <row> + <entry><link linkend="features.http-auth">variables PHP_AUTH</link></entry> + <entry> + Avec le safe mode, les variables <varname>PHP_AUTH_USER</varname>, + <varname>PHP_AUTH_PW</varname> et <varname>PHP_AUTH_TYPE</varname> + ne sont pas disponibles dans la variable <varname>$_SERVER</varname>. + Indépendamment, vous pouvez utiliser la variable + <varname>REMOTE_USER</varname> pour connaître le USER. + (note : affectée uniquement depuis &php; 4.3.0) + </entry> + </row> + <row> + <entry> + <function>highlight_file</function>, + <function>show_source</function> + </entry> + <entry> + &sm.uidcheck; &sm.uidcheck.dir; + (note : affectée uniquement depuis &php; 4.2.1) + </entry> + </row> + <row> + <entry> + <function>parse_ini_file</function> + </entry> + <entry> + &sm.uidcheck; &sm.uidcheck.dir; + (note : affectée uniquement depuis &php; 4.2.1) + </entry> + </row> + <row> <entry> - Toutes les fonctions qui utilisent les - wrappers de fichiers. + Toutes les fonctions qui utilisent les wrappers de fichiers. + (<filename>php4/main/fopen_wrappers.c</filename>) </entry> <entry>??</entry> </row>