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: 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 &agrave; dire Interface de Programmation d'Applications Serveur) appel&eacute; <literal>CLI</literal>, ce qui signifie <emphasis>Command Line Interface</emphasis> @@ -135,7 +135,9 @@ Un descripteur de fichier d&eacute;j&agrave; disponible vers <literal>stdin</literal>. Cela &eacute;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&eacute;j&agrave; disponible vers <literal>stdout</literal>. Cela &eacute;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&eacute;j&agrave; disponible vers <literal>stdout</literal>. - Cela &eacute;vite de l'ouvrir avec + Un descripteur de fichier d&eacute;j&agrave; disponible vers + <literal>stderr</literal>. Cela &eacute;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&ecirc;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 &agrave; 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&eacute;cut&eacute;. </para> <para> @@ -216,7 +224,7 @@ ]]> </screen> Cela donne beaucoup plus de souplesse lorsque vous r&eacute;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&eacute;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&eacute;cutant &php; avec l'option <literal>-h</literal> : <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -262,7 +270,7 @@ <orderedlist> <listitem> <para> - Indiquer &agrave; <literal>PHP</literal> d"ex&eacute;cuter un fichier : + Indiquer &agrave; &php; d'ex&eacute;cuter un fichier : </para> <para> <screen> @@ -281,7 +289,7 @@ </listitem> <listitem> <para> - Donner du code <literal>PHP</literal> &agrave; ex&eacute;cuter directement en ligne de commande. + Donner du code &php; &agrave; ex&eacute;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&eacute;e standard + Donner du code &php; dans l'entr&eacute;e standard (<literal>stdin</literal>). </para> <para> Cela donne la possibilit&eacute; de cr&eacute;er dynamiquement du code - <literal>PHP</literal>, puis de le fournir &agrave; PHP, et enfin, + &php;, puis de le fournir &agrave; PHP, et enfin, de le traiter &agrave; 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&eacute;cution. </para> <para> - Comme toute application shell, l'ex&eacute;cutable <literal>PHP</literal> accepte + Comme toute application shell, l'ex&eacute;cutable &php; accepte des arguments, et votre script peut aussi les recevoirs. Le nombre d'arguments n'est pas limit&eacute; par PHP, mais par le shell, qui a une limite en terme de nombre de caract&egrave;res qui peuvent &ecirc;tre pass&eacute;s. G&eacute;n&eacute;ralement, vous n'atteidrez @@ -338,7 +346,7 @@ Tant que les arguments que vous passez &agrave; votre script ne commencent pas par le caract&egrave;re <literal>-</literal>, il n'y a rien de sp&eacute;cial &agrave; surveiller. Si vous passez des arguments &agrave; voter script qui commencent par - <literal>-</literal>, cela posera des probl&egrave;mes car <literal>PHP</literal> + <literal>-</literal>, cela posera des probl&egrave;mes car &php; va penser qu'il doit les interpr&eacute;ter. Pour &eacute;viter cela, utilisez le s&eacute;parateur <literal>--</literal>. Apr&egrave;s cet argument, tous les arguments suivants seront pass&eacute;s &agrave; votre script sans &ecirc;tre modifi&eacute; ou analys&eacute; par PHP. @@ -615,7 +623,7 @@ <entry>-i</entry> <entry> Cette option appelle la fonction <function>phpinfo</function>, et - affiche le r&eacute;sultat. Si <literal>PHP</literal> ne fonctionne pas + affiche le r&eacute;sultat. Si &php; ne fonctionne pas correctement, il est recommand&eacute; d'utiliser la commande <literal>php -i</literal> et de voir si il n'y a pas d'erreurs affich&eacute;es avant ou apr&egrave;s la table d'information. N'oubliez pas que le r&eacute;sutltat de cette @@ -627,8 +635,8 @@ <entry>-r</entry> <entry> <para> - Cette option permet l'ex&eacute;cution de <literal>PHP</literal> directement - dans la ligne de commande. Les balises de <literal>PHP</literal> + Cette option permet l'ex&eacute;cution de &php; directement + dans la ligne de commande. Les balises de &php; (<literal>&lt;?php</literal> et <literal>?&gt;</literal>) <emphasis role="strong">ne sont pas</emphasis> demand&eacute;es, et coauseront une erreur d'analyse. @@ -636,7 +644,7 @@ <note> <para> De l'attention doit &ecirc;tre port&eacute;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&eacute;alis&eacute;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&eacute;faut, le script sera interrompu, et termin&eacute; d&egrave;s que le client se d&eacute;connecte. Ce comportement peut &ecirc;tre modifi&eacute; 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 &eacute;t&eacute; annul&eacute;e. </simpara> <simpara> - Votre script peut aussi expirer apr&egrave;s un laps de temps. + Votre script peut aussi &ecirc;tre automatiquement interrompu + apr&egrave;s une certaine dur&eacute;e de temps. Par d&eacute;faut, le d&eacute;lai est de 30 secondes. Cette valeur peut &ecirc;tre chang&eacute;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&eacute;cution (moins critique que les alertes) </entry> @@ -103,7 +103,7 @@ <link linkend="language.operators.bitwise">op&eacute;rateurs de bits</link> pour combiner ces valeurs et conserver uniquement celle qui vous int&eacute;resse. Notez que seuls, '|', '~', '!', et '&amp;' seront - utilisables dans <filename>php.ini</filename>, et qu'aucun op&eacute;rateur + utilisables dans &php.ini;, et qu'aucun op&eacute;rateur ne sera utilisable dans <filename>php3.ini</filename>. </para> <para> @@ -120,7 +120,7 @@ doit &ecirc;tre num&eacute;rique, c'est-&agrave;-dire <literal>7</literal>. </para> <para> - La valeur initiale peut &ecirc;tre modifi&eacute;e dans le fichier <filename>php.ini</filename>, + La valeur initiale peut &ecirc;tre modifi&eacute;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&ocirc;le d'erreur dans un script</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // Nous effectuons nous-m&ecirc;me notre contr&ocirc;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(&quot;Y-m-d H:i:s (T)&quot;); + $dt = date("Y-m-d H:i:s (T)"); // definit un tableau associatif avec les cha&icirc;nes d'erreur // en r&eacute;alit&eacute;, les seules entr&eacute;es que nous consid&eacute;rerons // seront 2,8,256,512 et 1024 $errortype = array( - 1 =&gt; &quot;Erreur&quot;, - 2 =&gt; &quot;Alerte&quot;, - 4 =&gt; &quot;Erreur d'analyse&quot;, - 8 =&gt; &quot;Note&quot;, - 16 =&gt; &quot;Erreur interne&quot;, - 32 =&gt; &quot;Alerte interne&quot;, - 64 =&gt; &quot;Erreur de compilation&quot;, - 128 =&gt; &quot;Alerte de compilation&quot;, - 256 =&gt; &quot;Erreur utilisateur&quot;, - 512 =&gt; &quot;Alerte utilisateur&quot;, - 1024=&gt; &quot;Note utilisateur&quot; + 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&eacute;e $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); - $err = &quot;&lt;errorentry&gt;\n&quot;; - $err .= &quot;\t&lt;datetime&gt;&quot;.$dt.&quot;&lt;/datetime&gt;\n&quot;; - $err .= &quot;\t&lt;errornum&gt;&quot;.$errno.&quot;&lt;/errnumber&gt;\n&quot;; - $err .= &quot;\t&lt;errortype&gt;&quot;.$errortype[$errno].&quot;&lt;/errortype&gt;\n&quot;; - $err .= &quot;\t&lt;errormsg&gt;&quot;.$errmsg.&quot;&lt;/errormsg&gt;\n&quot;; - $err .= &quot;\t&lt;scriptname&gt;&quot;.$filename.&quot;&lt;/scriptname&gt;\n&quot;; - $err .= &quot;\t&lt;scriptlinenum&gt;&quot;.$linenum.&quot;&lt;/scriptlinenum&gt;\n&quot;; + $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 .= &quot;\t&lt;vartrace&gt;&quot;.wddx_serialize_value($vars,&quot;Variables&quot;).&quot;&lt;/vartrace&gt;\n&quot;; - $err .= &quot;&lt;/errorentry&gt;\n\n&quot;; + $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, &quot;/usr/local/php4/error.log&quot;); + error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) - mail(&quot;phpdev@mydomain.com&quot;,&quot;Critical User Error&quot;,$err); + mail("phpdev@mydomain.com","Critical User Error",$err); } + function distance($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { - trigger_error(&quot;Param&egrave;tres incorrects : arrays attendus&quot;, E_USER_ERROR); + trigger_error("Param&egrave;tres incorrects : arrays attendus", E_USER_ERROR); return NULL; } if (count($vect1) != count($vect2)) { - trigger_error(&quot;Les vecteurs doivent &ecirc;tre de la m&ecirc;me taille&quot;, E_USER_ERROR); + trigger_error("Les vecteurs doivent &ecirc;tre de la m&ecirc;me taille", E_USER_ERROR); return NULL; } for ($i=0; $i&lt;count($vect1); $i++) { $c1 = $vect1[$i]; $c2 = $vect2[$i]; $d = 0.0; if (!is_numeric($c1)) { - trigger_error(&quot;La coordonn&eacute;e $i du vecteur 1 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro&quot;, + trigger_error("La coordonn&eacute;e $i du vecteur 1 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro", E_USER_WARNING); $c1 = 0.0; } if (!is_numeric($c2)) { - trigger_error(&quot;La coordonn&eacute;e $i du vecteur 2 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro&quot;, + trigger_error("La coordonn&eacute;e $i du vecteur 2 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro", E_USER_WARNING); $c2 = 0.0; } @@ -241,31 +243,34 @@ } return sqrt($d); } -$old_error_handler = set_error_handler(&quot;userErrorHandler&quot;); + +$old_error_handler = set_error_handler("userErrorHandler"); // Constante ind&eacute;finie, g&eacute;n&egrave;re une alerte $t = I_AM_NOT_DEFINED; -// definition de quelques &quot;vecteurs&quot; -$a = array(2,3,&quot;bla&quot;); +// definition de quelques "vecteurs" +$a = array(2,3,"bla"); $b = array(5.5, 4.3, -1.6); $c = array(1,-3); // g&eacute;n&egrave;re une erreur utilisateur -$t1 = distance($c,$b).&quot;\n&quot;; +$t1 = distance($c,$b)."\n"; // g&eacute;n&egrave;re une autre erreur utilisateur -$t2 = distance($b,&quot;i am not an array&quot;).&quot;\n&quot;; +$t2 = distance($b,"Je ne suis pas un tableau")."\n"; // g&eacute;n&egrave;re une alerte -$t3 = distance($a,$b).&quot;\n&quot;; -?&gt; +$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&ocirc;le total sur le chargement et la gestion des fichiers charg&eacute;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&eacute;thode PUT comme dans le navigateur Netscape Composer @@ -22,180 +32,157 @@ m&eacute;thode PUT</link>. </para> <para> - Un &eacute;cran de chargement de fichiers peut &ecirc;tre constitu&eacute; - en cr&eacute;ant un formulaire de la mani&egrave;re suivante : - <example> + Un &eacute;cran de chargement de fichiers peut &ecirc;tre constitu&eacute; + en cr&eacute;ant un formulaire de la mani&egrave;re suivante : + <example> <title>Formulaire de chargement de fichier</title> <programlisting role="html"> -&lt;FORM ENCTYPE=&quot;multipart/form-data&quot; ACTION=&quot;_URL_&quot; METHOD=&quot;POST&quot;&gt; -&lt;INPUT TYPE=&quot;hidden&quot; name=&quot;MAX_FILE_SIZE&quot; value=&quot;1000&quot;&gt; -Envoyez ce fichier : &lt;INPUT NAME=&quot;userfile&quot; TYPE=&quot;file&quot;&gt; -&lt;INPUT TYPE=&quot;submit&quot; VALUE=&quot;Send File&quot;&gt; -&lt;/FORM&gt; + <![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&egrave;tre _URL_ doit pointer sur un fichier PHP. L'option MAX_FILE_SIZE cach&eacute;e doit pr&eacute;c&eacute;der le nom du fichier &agrave; charger, et repr&eacute;sente la taille maximale du fichier &agrave; charger. La valeur est donn&eacute;e en octets. Dans ce script, les valeurs suivantes doivent &ecirc;tre - d&eacute;finies pour assurer un chargement correct : + d&eacute;finies pour assurer un chargement correct. + </para> + <warning> + <para> + Le champs MAX_FILE_SIZE est l&agrave; &agrave; titre de conseil au navigateur. + Il est tr&egrave;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 &agrave; respecter (<link linkend="ini.upload-max-filesize">upload_max_filesize</link>) + ne peut &ecirc;tre contourn&eacute;e, elle. + </para> + </warning> + <para> + Les variables d&eacute;finies apr&egrave;s un t&eacute;l&eacute;chargement de fichiers diff&egrave;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&eacute;es + sur les fichiers t&eacute;l&eacute;charg&eacute;s. L'utilisation de la variable <varname>$_FILES</varname> + est recommand&eacute;e. Si la directive &php; + <link linkend="ini.register-globals">register_globals</link> vaut + <emphasis>on</emphasis>, les variables reli&eacute;es existeront aussi. + <link linkend="ini.register-globals">register_globals</link> + vaut par d&eacute;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&eacute;finies dans - le script de destination, en cas de t&eacute;l&eacute;chargement r&eacute;ussi, et en - supposant que <link linkend="ini.register-globals">register_globals</link> - est activ&eacute; dans le fichier <filename>php.ini</filename>. Si <link - linkend="ini.track-vars">track_vars</link> est activ&eacute;, 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&eacute;l&eacute;charg&eacute; est 'userfile', comme - pr&eacute;sent&eacute; dans l'exemple ci-dessus. - <itemizedlist> - <listitem> - <simpara> - <varname>$userfile</varname> - Le nom temporaire du fichier qui - sera charg&eacute; sur la machine serveur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_name</varname> - Le nom du fichier original - sur le syst&egrave;me de l'envoyeur. - </simpara> - </listitem> - <listitem> - <simpara> - <varname>$userfile_size</varname> - La taille du fichier envoy&eacute; - 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 &quot;$userfile&quot; prend la valeur qui est pass&eacute;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&eacute;g&egrave;rement diff&eacute;rent, car c'est la - variable d'environnement <varname>$HTTP_POST_FILES</varname>, qui - contiendra les informations sur les fichiers t&eacute;l&eacute;charg&eacute;s. - Ces informations sont disponibles dans si l'option - <link linkend="ini.track-vars">track_vars</link> est activ&eacute;e, mais - <link linkend="ini.track-vars">track_vars</link> est toujours - activ&eacute;e dans les versions de PHP sup&eacute;rieures &agrave; la version - 4.0.2. - </para> - <para> - Le contenu du tableau <varname>$HTTP_POST_FILES</varname> d&eacute;crit - ci-dessous. Notez que l'on suppose ici que le nom du fichier - t&eacute;l&eacute;charg&eacute; est '<literal>userfile</literal>', - comme pr&eacute;sent&eacute; dans l'exemple ci-dessus : + <para> + Le contenu du tableau <link linkend="reserved.variables.files">$_FILES</link> + est d&eacute;taill&eacute; dans notre exmple ci-dessous. Notez que l'un suppose que le nom + de la variable du fichier t&eacute;l&eacute;charg&eacute; est <emphasis>userfile</emphasis>, tel que + d&eacute;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 &ecirc;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&eacute;, en octets. + La taille, en octets, du fichier t&eacute;l&eacute;charg&eacute;. </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&eacute; sur la machine serveur. + Le nom temporaire du fichier qui sera charg&eacute; 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&eacute; au t&eacute;l&eacute;chargement de fichier. <emphasis>['error']</emphasis> + a &eacute;t&eacute; introduit en PHP 4.2.0 </para> </listitem> </varlistentry> </variablelist> </para> + <note> + <para> + Dans les versions de &php; ant&eacute;rieure &agrave; la version 4.1.0, la variable + <varname>$_FILES</varname> s'appelait <varname>$HTTP_POST_FILES</varname> et + ce n'&eacute;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&eacute;s par d&eacute;faut dans le dossier - des fichiers temporaires, &agrave; moins qu'un autre dossier - n'ait &eacute;t&eacute; 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&eacute;faut du serveur - peut &ecirc;tre modifi&eacute; gr&acirc;ce &agrave; la variable d'environnement - <envar>TMPDIR</envar>, de l'utilisateur qui ex&eacute;cute PHP. - Sa modification avec <function>putenv</function> depuis un script PHP - ne fonctionnera pas. Cette variable d'environnement peut aussi &ecirc;tre - utilis&eacute;e pour s'assurer que d'autres op&eacute;rations fonctionnent avec - les fichiers t&eacute;l&eacute;charg&eacute;s. + Lorsque <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>on</emphasis> dans le &php.ini;, des variables suppl&eacute;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 &agrave; l'esprit + que depuis &php; 4.2.0, <link linkend="ini.register-globals">register_globals</link> + vaut <emphasis>off</emphasis> par d&eacute;faut. Il n'est pas prudent de + supposer que cette directive vaut <emphasis>on</emphasis>. + </para> + <para> + Le fichier t&eacute;l&eacute;charg&eacute; sera stock&eacute; temporairement dans le dossier + temporaire du syst&egrave;me, &agrave; 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&eacute;faut du serveur peut &ecirc;tre chang&eacute; + 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 &ecirc;tre utilis&eacute;e pour s'assurer que d'autres op&eacute;rations + fonctionnent aussi sur les fichiers t&eacute;l&eacute;charg&eacute;s. <example> - <title>Validation de fichiers t&eacute;l&eacute;charg&eacute;s</title> - <para> - Les exemples suivants fonctionnent sur les versions - de PHP 3 sup&eacute;rieures &agrave; la version 3.0.16, et sup&eacute;rieures - &agrave; la version 4.0.2 pour PHP 4. Reportez-vous &agrave; - la section des fonctions pour &eacute;tudier - <function>is_uploaded_file</function> et <function>move_uploaded_file</function>. - </para> - <programlisting role="php"> -&lt;?;php -if (is_uploaded_file($userfile)) { - copy($userfile, "/dossier/des/fichiers/telecharges/"); -} else { - echo "Attaque potentielle par fichier t&eacute;l&eacute;charg&eacute; : fichier '$userfile'."; -} -/* ...ou... */ -move_uploaded_file($userfile, "/dossier/des/fichiers/telecharges"); -?&gt; - </programlisting> + <title>Validation de t&eacute;l&eacute;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&eacute;centes que la 4.0.2. Voyez les fonctions + <function>is_uploaded_file</function> et + <function>move_uploaded_file</function>. </para> <programlisting role="php"> -&lt;?;php -/* Test du fichier t&eacute;l&eacute;charg&eacute;. */ -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 &ecirc;tre utilis&eacute; &agrave; 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&eacute;l&eacute;charg&eacute; : fichier '$userfile'."; + echo "Attaque par upload potentielle le fichier : " . $_FILES['userfile']['name']; } -?&gt; +/* ...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&eacute;rieure &agrave; 4.0.2. Cela repose sur des fonctionnalit&eacute;s - internes &agrave; PHP qui ont &eacute;volu&eacute; apr&egrave;s cette version. - </para> - </note> <simpara> Le script PHP qui re&ccedil;oit le fichier charg&eacute; doit pouvoir g&eacute;rer le fichier de mani&egrave;re appropri&eacute;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&eacute;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&eacute;placer. </simpara> <simpara> Le fichier sera automatiquement effac&eacute; du fichier temporaire @@ -211,6 +203,70 @@ d&eacute;plac&eacute; ou renomm&eacute;. </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&eacute; dans le + tableau de fichiers. Ce code d'erreur est accessible &agrave; l'index + <emphasis>error</emphasis> du tableau, qui est cr&eacute;&eacute; durant + le t&eacute;l&eacute;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&eacute;l&eacute;chargement est correct. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_INI_SIZE</varname></term> + <listitem> + <para> + Valeur : 1. Le fichier t&eacute;l&eacute;charg&eacute; exc&egrave;de la taille de + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, + configur&eacute; dans le &php.ini;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_FORM_SIZE</varname></term> + <listitem> + <para> + Valeur : 2. Le fichier t&eacute;l&eacute;charg&eacute; exc&egrave;de la taille de + <emphasis>MAX_FILE_SIZE</emphasis>, qui a &eacute;t&eacute; sp&eacute;cifi&eacute;e dans + le formulaire HTML. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_PARTIAL</varname></term> + <listitem> + <para> + Valeur : 3. Le fichier n'a &eacute;t&eacute; que partiellement t&eacute;l&eacute;charg&eacute;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><varname>UPLOAD_ERR_NO_FILE</varname></term> + <listitem> + <para> + Valeur : 4. Aucun fichier n'a &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;. + </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&eacute;l&eacute;charger plusieurs fichiers simultan&eacute;ment</title> + <simpara> + Le t&eacute;l&eacute;chargement de plusieurs fichiers est possible + en utilisant des noms diff&eacute;rents dans l'attribut + <literal>name</literal> de la balise <literal>input</literal>. + </simpara> <simpara> - Il est possible de charger plusieurs fichiers en m&ecirc;me temps, et de - recevoir les informations ad&eacute;quates organis&eacute;es sous - forme de tableau. Pour ce faire, il faut utiliser la m&ecirc;me - syntaxe d'envoi dans le code HTML que pour les s&eacute;lections ou - bo&icirc;tes &agrave; cocher multiples. + Il est aussi possible de t&eacute;l&eacute;charger plusieurs fichiers simultan&eacute;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&eacute;lections multiples + et les bo&icirc;tes &agrave; cocher. </simpara> <note> <para> - Le support du chargement multiple de fichier a &eacute;t&eacute; - ajout&eacute; dans la version 3.0.10. + Le support des t&eacute;l&eacute;chargement multiples a &eacute;t&eacute; ajout&eacute; + en &php; 3.0.10. </para> </note> <para> <example> - <title>Chargement multiple de fichier </title> + <title>T&eacute;l&eacute;charger plusieurs fichiers simultan&eacute;ment</title> <programlisting role="html"> -&lt;form action=&quot;file-upload.html&quot; method=&quot;post&quot; enctype=&quot;multipart/form-data&quot;&gt; - Send these files:&lt;br&gt; - &lt;input name=&quot;userfile[]&quot; type=&quot;file&quot;&gt;&lt;br&gt; - &lt;input name=&quot;userfile[]&quot; type=&quot;file&quot;&gt;&lt;br&gt; - &lt;input type=&quot;submit&quot; value=&quot;Send files&quot;&gt; -&lt;/form&gt; +<![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 &eacute;t&eacute;F envoy&eacute;, les tableaux - <computeroutput>$userfile</computeroutput>, - <computeroutput>$userfile_name</computeroutput>, et - <computeroutput>$userfile_size</computeroutput> seront initialis&eacute;s - (ainsi que $HTTP_POST_VARS). Chaque tableau sera de type - num&eacute;rique, et contiendra les valeurs appropri&eacute;es - pour le chargement des fichiers. + Lorsque le formulaire ci-dessus a &eacute;t&eacute; envoy&eacute;, les + tableaux <varname>$_FILES['userfile']</varname>, + <varname>$_FILES['userfile']['name']</varname>, et + <varname>$_FILES['userfile']['size']</varname> seront initialis&eacute;s + (tout comme <varname>$HTTP_POST_FILES</varname> pour les versions + de &php; ant&eacute;rieure &agrave; la 4.1.0). Lorsque + <literal>register_globals</literal> est activ&eacute;, les variables + globales concernant les fichiers t&eacute;l&eacute;charg&eacute;s sont aussi + initialis&eacute;es. Chacune d'entre elle contiendra un tableau + num&eacute;riquement index&eacute;, avec les valeurs d&eacute;crivant les fichiers + t&eacute;l&eacute;charg&eacute;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&eacute;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 &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;. 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&eacute;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&eacute;&eacute;es. </simpara> </sect1> <sect1 id="features.file-upload.put-method"> @@ -320,19 +387,22 @@ </para> <simpara> Elle indique &agrave; Apache qu'il doit envoyer les requ&ecirc;tes - de chargement par m&eacute;thode PUT au script put.php3. Bien entendu, + de chargement par m&eacute;thode PUT au script + <filename>put.php3</filename>. Bien entendu, cela pr&eacute;suppose que vous avez activ&eacute; 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"> -&lt;?php + <![CDATA[ +<?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); -?&gt; +?> +]]> </programlisting> </informalexample> </para> @@ -344,11 +414,11 @@ est que lorsque PHP re&ccedil;oit un chargement par m&eacute;thode PUT, il va enregistrer le fichier dans le dossier temporaire, tout comme avec la - <link linkend="features.file-upload.post-method">m&eacute;thode POST-method</link>. + <link linkend="features.file-upload.post-method">m&eacute;thode POST</link>. A la fin de la requ&ecirc;te, le fichier sera effac&eacute;. Ce qui fait que ce script doit placer le fichier charg&eacute; quelque part. Le nom du fichier temporaire est plac&eacute; dans la variable - globale $PHP_PUT_FILENAME, et la destination pr&eacute;vue est + globale <varname>$PHP_PUT_FILENAME</varname>, et la destination pr&eacute;vue est plac&eacute;e dans <varname>$REQUEST_URI</varname> (ces noms peuvent changer d'une configuration d'Apache &agrave; l'autre). Cette destination est celle qui est demand&eacute;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&eacute;e. Reportez-vous &agrave; 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 &eacute;t&eacute; + ajout&eacute;e en &php; &agrave; 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&eacute;der &agrave; une page : <example> <title>Exemple d'authentification HTTP</title> <programlisting role="php"> -&lt;?php - if(!isset($PHP_AUTH_USER)) { - Header(&quot;WWW-Authenticate: Basic realm=\&quot;My Realm\&quot;&quot;); - Header(&quot;HTTP/1.0 401 Unauthorized&quot;); - echo &quot;Texte &agrave; envoyer si le client appuie sur le bouton d'annulation\n&quot;; +<![CDATA[ +<?php + if (!isset($_SERVER['PHP_AUTH_USER'])) { + header('WWW-Authenticate: Basic realm="My Realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Texte utilis&eacute; si le visiteur utilise le bouton d\'annulation'; exit; } else { - echo &quot;Bonjour $PHP_AUTH_USER.&lt;P&gt;&quot; - echo &quot;Vous avez entr&eacute; le mot de passe $PHP_AUTH_PW.&lt;P&gt;&quot; + echo "<p>Bonjour, {$_SERVER['PHP_AUTH_USER']}.</p>"; + echo "<p>Votre mot de passe est {$_SERVER['PHP_AUTH_PW']}.</p>"; } -?&gt; +?> +]]> </programlisting> </example> </para> + + <note> + <title>Note de compatibilit&eacute;</title> + <para> + Soyez bien prudent lorsque vous utilisez des ent&ecirc;tes HTTP avec &php;. Afin de + garantir un maximum de compatibilit&eacute; entre les navigateurs, le mot cl&eacute; + "Basic" doit &ecirc;tre &eacute;crit avec un B majuscule, et le texte de pr&eacute;sentation + doit &ecirc;tre plac&eacute; entre guillemets simples, et exactement un espace doit + pr&eacute;c&eacute;der le code <emphasis>401</emphasis> dans l'ent&ecirc;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&eacute;f&eacute;rerez s&ucirc;rement @@ -58,9 +85,21 @@ quelle on a acc&eacute;d&eacute; par une authentification traditionnelle, les variables globales PHP_AUTH ne seront pas assign&eacute;es si l'authentification externe a &eacute;t&eacute; activ&eacute;e pour - cette page. Dans ce cas, la variable <varname>$REMOTE_USER</varname> peut &ecirc;tre + cette page. Dans ce cas, la variable <varname>REMOTE_USER</varname> peut &ecirc;tre utilis&eacute;e pour identifier l'utilisateur &agrave; l'ext&eacute;rieur. + De m&ecirc;me que <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> + <note> + <title>Note de configuration</title> + <para> + &php; utilise la pr&eacute;sence de la directive <literal>AuthType</literal> + pour d&eacute;terminer si une authentification externe est activ&eacute;. + ƒvitez donc cette directive de contexte si vous voulez utiliser + l'authentification de &php; (sinon, les deux authentifications + se contrediront, et &eacute;choueront). + </para> + </note> + <simpara> Notez cependant que les manipulations ci-dessus n'emp&ecirc;chent pas quiconque poss&egrave;de une page non authentifi&eacute;e @@ -79,26 +118,29 @@ Authentification HTTP avec nom d'utilisateur/mot de passe forc&eacute; </title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php function authenticate() { - Header( &quot;WWW-Authenticate: Basic realm=\&quot;Test Authentication System\&quot;&quot;); - Header( &quot;HTTP/1.0 401 Unauthorized&quot;); - echo &quot;Vous devez entrer un nom d'utilisateur valide et un mot de passe correct pour acc&eacute;der &agrave; cette ressource\n&quot;; - 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 &amp;&amp; !strcmp($OldAuth, $PHP_AUTH_USER)) ) { + + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); - } + } else { - echo &quot;Bienvenue $PHP_AUTH_USER&lt;BR&gt;&quot;; - echo &quot;Old: $OldAuth&quot;; - echo &quot;&lt;form action=\&quot;$PHP_SELF\&quot; method=post&gt;\n&quot;; - echo &quot;&lt;input type=hidden NAME=\&quot;SeenBefore\&quot; VALUE=\&quot;1\&quot;&gt;\n&quot;; - echo &quot;&lt;input type=hidden NAME=\&quot;OldAuth\&quot; VALUE=\&quot;$PHP_AUTH_USER\&quot;&gt;\n&quot;; - echo &quot;&lt;input type=submit value=\&quot;Re Authenticate\&quot;&gt;\n&quot; - echo &quot;&lt;/FORM&gt;\n&quot;; + 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"; } -?&gt; +?> +]]> </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&eacute;, l'uid du script es ajout&eacute; automatiquement + dans l'ent&ecirc;te <literal>realm</literal>, comme faisant partie de l'ent&ecirc;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&eacute;ation d'images</title> <simpara> @@ -16,7 +16,8 @@ <example> <title>Cr&eacute;ation d'images GIF avec PHP</title> <programlisting role="php"> -&lt;?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); -?&gt; +?> +]]> </programlisting> </example> Cet exemple sera appel&eacute; 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 &agrave; distance</title> <para> - Aussi longtemps que le support de la fonction d'ouverture - g&eacute;n&eacute;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&eacute;s dans le &php.ini;, vous pouvez utiliser des URLs (HTTP et FTP) avec la majorit&eacute; des fonctions qui utilisent un - nom de fichier comme param&egrave;tre, ceci incluant les expressions - <function>require</function> et <function>include</function>. + nom de fichier comme param&egrave;tre. Cela inclut notamment + <function>include</function>, <function>include_once</function>, + <function>require</function> et <function>require_once</function>. + Reportez-vous &agrave; <xref linkend="wrappers"/> pour plus d'informations + sur les protocoles support&eacute;s par &php;. + </para> + <note> + <para> + En PHP 4.0.3 et plus r&eacute;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&eacute;ation d'images de l'extension <xref linkend="ref.image"/>. </para> </note> </para> @@ -30,22 +41,24 @@ <example> <title>Conna&icirc;tre le titre d'une page distante</title> <programlisting role="php"> -&lt;?php - $file = fopen("http://www.php.net/", "r"); - if (!$file) { - echo "&lt;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 &eacute;crit sur une ligne.*/ - if (eregi("&lt;title>(.*)&lt;/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&eacute;es */ + if (eregi ("<title>(.*)</title>", $line, $out)) { + $title = $out[1]; + break; } - } - fclose($file); -?&gt; +} +fclose($file); +?> +]]> </programlisting> </example> </para> @@ -53,7 +66,10 @@ Vous pouvez aussi &eacute;crire des fichiers sur un serveur FTP aussi longtemps que vous &ecirc;tes connect&eacute; avec un utilisateur ayant les bons droits d'acc&egrave;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&eacute;cifier un nom d'utilisateur (et certainement le mot de passe) dans l'URL, comme par exemple 'ftp://user:password&#64;ftp.example.com/path/to/file'. @@ -65,16 +81,18 @@ <example> <title>Stocker des donn&eacute;es sur un serveur distant</title> <programlisting role="php"> -&lt;?php - $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); - if (!$file) { - echo "&lt;p>Impossible d'ouvrir un fichier distant en &eacute;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&eacute;es. */ - fputs($file, "$HTTP_USER_AGENT\n"); - fclose($file); -?&gt; +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&eacute;curit&eacute; de PHP : une solution au probl&egrave;me - de partage de PHP sur un serveur. Ce syst&egrave;me p&ecirc;che au niveau de l'architecture - car il n'est pas correct de tenter de r&eacute;soudre ce probl&egrave;me au niveau - de PHP, mais les solutions alternatives bas&eacute;es sur le serveur web et l'OS - ne sont pas r&eacute;alistes. De nombreux acteurs, notamment les fournisseurs - d'h&eacute;bergement, utilise le "Safe Mode". - </para> - <para> - Les directives de configuration qui contr&ocirc;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&eacute;curit&eacute; de PHP : + une solution au probl&egrave;me de partage de PHP sur un serveur. + Ce syst&egrave;me p&ecirc;che au niveau de l'architecture + car il n'est pas correct de tenter de r&eacute;soudre ce + probl&egrave;me au niveau de PHP, mais les solutions + alternatives bas&eacute;es sur le serveur web et l'OS + ne sont pas r&eacute;alistes. De nombreux intervenants, + notamment les fournisseurs d'h&eacute;bergement, utilisent + le "Safe Mode". </para> + + <sect1 id="ini.sect.safe-mode"> + <title>Securit&eacute; et Safe Mode</title> + <para> + <table> + <title>Directives de s&eacute;curit&eacute; 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 &eacute;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&eacute;curit&eacute; de &php;. Lisez le chapitre + <link linkend="security">s&eacute;curit&eacute;</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&eacute;faut, le safe mode fait une comparaison des + propri&eacute;taires, avant d'ouvrir un fichier. Si vous voulez + all&eacute;ger un peu ce niveau de s&eacute;curit&eacute;, vous pouvez + r&eacute;aliser une comparaison de groupe, et activer cette + directive. + Si cette directive vaut &false; (sa valeur par d&eacute;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&eacute;rifications bas&eacute;es sur le <literal>UID</literal> ou <literal>GID</literal> + sont ignor&eacute;es lorsque les fichiers sont issus du dossier + et de ses sous-dossiers, indiqu&eacute; dans cette directive. Les + dossiers peuvent &ecirc;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&ecirc;me fa&ccedil;on que le fait + <link linkend="ini.include-path">include_path</link>, pour + permettre de configurer plusieurs dossiers. + </simpara> + <simpara> + La restriction sp&eacute;cifi&eacute;e est en fait un pr&eacute;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&egrave;s &agrave; un dossier sp&eacute;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&eacute; en safe mode, les fonctions comme <function>system</function> + et toutes celles qui permettent l'ex&eacute;cution en + <link linkend="ref.exec">ligne de commande</link> refuseront d'ex&eacute;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&eacute;curit&eacute; potentiel. Cette directive contient une liste de noms + variables d'environnement s&eacute;par&eacute;es par des virgules, ou de pr&eacute;fixes. + En Safe mode, l'utilisateur ne pourra modifier que les + variables d'environnement dont le nom commence par l'un des pr&eacute;fixes + fourni ici. Par d&eacute;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&eacute;g&eacute;es, + m&ecirc;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&eacute;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&eacute;rifi&eacute;e. Si le fichier se situe hors du dossier + sp&eacute;cifi&eacute; dans cette directive,&php; refusera de l'ouvrir. + Les liens symboliques sont r&eacute;solus, ce qui fait que cette + restriction ne peut &ecirc;tre contourn&eacute;e par un lien symbolique. + </para> + <para> + La valeur sp&eacute;ciale <systemitem class="constant">.</systemitem> + indique que le dossier dans lequel le script est stock&eacute;, servira + de dossier de base. + </para> + <para> + Sous Windows, s&eacute;parez les dossiers par des deux points. Sur les autres + syst&egrave;mes, s&eacute;parez les dossiers avec un point-virgule. Lorsque &php; est utilis&eacute; + comme module Apache, les chemins de la directive open_basedir des + dossiers parents sont automatiques transmis. + </para> + <para> + La restriction sp&eacute;cifi&eacute;e par open_basedir est en fait un + pr&eacute;fixe, et non un dossier. Cela signifie que + "open_basedir = /dir/incl" donne acc&egrave;s au dossier "/dir/include" + et aussi au dossier "/dir/incls" si il existe. Lorsque vous souhaitez + restreindre l'acc&egrave;s &agrave; un dossier sp&eacute;cifique, ajoutez un slash final. + Par exemple "open_basedir = /dir/incl/". + </para> + <note> + <para> + Le support des dossiers multiples a &eacute;t&eacute; ajout&eacute; en &php; 3.0.7. + </para> + </note> + <para> + La valeur par d&eacute;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&eacute;sactiver certaines fonctions + pour des raisons de <link linkend="security">s&eacute;curit&eacute;</link>. Elle + prend une liste de nom de fonctions, s&eacute;par&eacute;s par des + virgules. disable_functions n'est pas affect&eacute;e par le + <link linkend="ini.safe-mode">Safe Mode</link>. + </simpara> + <simpara> + Cette directive doit &ecirc;tre configur&eacute;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&eacute;rifie que le propri&eacute;taire du script courant est le m&ecirc;me que le propri&eacute;taire des fichiers qui seront manipul&eacute;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> &eacute;x&eacute;cuter le script <filename>script.php</filename> - <informalexample> - <programlisting role="php"> -&lt;?php - readfile('/etc/passwd'); -?&gt; - </programlisting> - </informalexample> - g&eacute;n&eacute;rera cette erreur, si le safe mode est activ&eacute; : - <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&eacute;n&eacute;rera cette erreur, si le &safemode; est activ&eacute; : + <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&eacute;rification faite avec le nom du propri&eacute;taire + du fichier soit trop restrictive, et qu'une v&eacute;rification sur le nom + du groupe soit suffisante. C'est une autre fonctionnalit&eacute; support&eacute;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&eacute;rifications + seront faites sur le <literal>GID</literal>, alors qu'en lui laissant + sa valeur par d&eacute;faut de <literal>Off</literal>, les v&eacute;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&eacute;es aux fichiers situ&eacute;s dans les dossiers sp&eacute;cifi&eacute;s. Par exemple : - <informalexample> - <programlisting role="ini"> -&lt;Directory /docroot&gt; -php_admin_value open_basedir /docroot -&lt;/Directory&gt; + <programlisting role="ini"> +<![CDATA[ +<Directory /docroot> + php_admin_value open_basedir /docroot +</Directory> +]]> </programlisting> - </informalexample> Si vous ex&eacute;cutez le script <filename>script.php</filename> ci-dessus avec la configuration d'open_basedir le r&eacute;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&eacute;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&eacute;n&eacute;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&eacute;sactiv&eacute;es par le Safe Mode</title> + <title>Fonctions d&eacute;sactiv&eacute;es par le Safe Mode</title> <para> Voici une liste non-exhaustive des fonctions d&eacute;sactiv&eacute;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&eacute;rateur guillemets obliques</link></entry> <entry>&sm.disabled;</entry> </row> <row> - <entry><function>shell_exec</function> (&eacute;quivalent fonctionnels - des guillemets oblique)</entry> + <entry><function>shell_exec</function> (&eacute;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&eacute; &agrave; la partie + <literal>realm</literal> de l'ent&ecirc;te + <literal>WWW-Authenticate</literal> si vous utilisez cet ent&ecirc;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&eacute;pendamment, vous pouvez utiliser la variable + <varname>REMOTE_USER</varname> pour conna&icirc;tre le USER. + (note : affect&eacute;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&eacute;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&eacute;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>
« previous php.doc.fr (#175) next »