cvs: phpdoc /fr/features connection-handling.xml cookies.xml error-handling.xml file-upload.xml http-auth.xml images.xml persistent-connections.xml
remote-files.xml

From: Date: Fri, 12 Jan 2001 10:50:56 +0000
Subject: cvs: phpdoc /fr/features connection-handling.xml cookies.xml error-handling.xml file-upload.xml http-auth.xml images.xml persistent-connections.xml
remote-files.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333574@lists.php.net to get a copy of this message
dams Fri Jan 12 02:50:56 2001 EDT Modified files: /phpdoc/fr/features connection-handling.xml cookies.xml error-handling.xml file-upload.xml http-auth.xml images.xml persistent-connections.xml remote-files.xml Log: Typos fixed. TRUE/FALSE -> LITERAL

Index: phpdoc/fr/features/connection-handling.xml diff -u phpdoc/fr/features/connection-handling.xml:1.3 phpdoc/fr/features/connection-handling.xml:1.4 --- phpdoc/fr/features/connection-handling.xml:1.3 Mon Nov 20 10:28:59 2000 +++ phpdoc/fr/features/connection-handling.xml Fri Jan 12 02:50:56 2001 @@ -1,15 +1,13 @@ <chapter id="features.connection-handling"> <title>Gestion des connexions</title> - <note> <para> - Les informations suivantes ne sont valables qu'&agrave; + Les informations suivantes ne sont valables qu'&agrave; partir de la version 3.0.7. </para> </note> - <para> - Le statut des connexions est conserv&eacute; en interne par PHP. Il y a trois + Le statut des connexions est conserv&eacute; en interne par PHP. Il y a trois &eacute;tats possibles : <itemizedlist> <listitem><simpara>0 - NORMAL (normal)</simpara></listitem> @@ -17,83 +15,77 @@ <listitem><simpara>2 - TIMEOUT (p&eacute;rim&eacute;)</simpara></listitem> </itemizedlist> </para> - <simpara> - Lorsqu'un script PHP est en cours d'ex&eacute;cution, son - &eacute;tat est NORMAL. Si le client distant se d&eacute;connecte, - le statut devient ABORTED. En g&eacute;n&eacute;ral, une telle - d&eacute;connexion provient d'un arr&ecirc;t temporaire. Si la + Lorsqu'un script PHP est en cours d'ex&eacute;cution, son + &eacute;tat est NORMAL. Si le client distant se d&eacute;connecte, + le statut devient ABORTED. En g&eacute;n&eacute;ral, une telle + d&eacute;connexion provient d'un arr&ecirc;t temporaire. Si la dur&eacute;e maximale d'ex&eacute;cution de PHP est d&eacute;pass&eacute;e, - (voir <function>set_time_limit</function>), le script prend le + (voir <function>set_time_limit</function>), le script prend le statut TIMEOUT. </simpara> - <simpara> - Vous pouvez en outre, d&eacute;cider si vous voulez que la - d&eacute;connexion d'un client provoque l'arr&ecirc;t de votre - script. Il est parfois pratique de terminer le script, m&ecirc;me + Vous pouvez en outre, d&eacute;cider si vous voulez que la + d&eacute;connexion d'un client provoque l'arr&ecirc;t de votre + script. Il est parfois pratique de terminer le script, m&ecirc;me si le client n'est plus l&agrave; pour recevoir les informations. 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 - <parameter>ignore_user_abort</parameter> du fichier Apache .conf - ou avec la fonction <function>ignore_user_abort</function>. Si vous + 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 + <parameter>ignore_user_abort</parameter> du fichier Apache <filename>httpd.conf</filename> + ou avec la fonction <function>ignore_user_abort</function>. Si vous ne demandez pas &agrave; PHP d'ignorer la d&eacute;connexion, et que l'utilisateur se d&eacute;connecte, le script sera termin&eacute;. La - seule exception est si vous avez enregistr&eacute; une fonction + seule exception est si vous avez enregistr&eacute; une fonction de fermeture, avec <function>register_shutdown_function</function>. - Avec une telle fonction, lorsque l'utilisateur interromp sa - requ&ecirc;te, &agrave; la procha&icirc;ne ex&eacute;cution du script, - PHP va s'apercevoir que le dernier script n'a pas &eacute;t&eacute; - termin&eacute;, et il va d&eacute;clencher la fonction de fermeture. - Cette fonction sera aussi appel&eacute;e &agrave; la fin du script, - si celui-ci se termine normalement. Pour pouvoir avoir un comportement + Avec une telle fonction, lorsque l'utilisateur interromp sa + requ&ecirc;te, &agrave; la procha&icirc;ne ex&eacute;cution du script, + PHP va s'apercevoir que le dernier script n'a pas &eacute;t&eacute; + termin&eacute;, et il va d&eacute;clencher la fonction de fermeture. + Cette fonction sera aussi appel&eacute;e &agrave; la fin du script, + si celui-ci se termine normalement. Pour pouvoir avoir un comportement diff&eacute;rent suivant l'&eacute;tat du script lors de sa finalisation, - vous pouvez ex&eacute;cutez des commandes sp&eacute;cifiques &agrave; - la d&eacute;connexion gr&acirc;ce &agrave; la commande - <function>connection_aborted</function>. Cette fonction retournera - TRUE si la connexion a &eacute;t&eacute; annul&eacute;e. + vous pouvez ex&eacute;cutez des commandes sp&eacute;cifiques &agrave; + la d&eacute;connexion gr&acirc;ce &agrave; la commande + <function>connection_aborted</function>. Cette fonction retournera + <literal>TRUE</literal> si la connexion a &eacute;t&eacute; annul&eacute;e. </simpara> - <simpara> - Votre script peut aussi expirer apr&egrave;s un laps 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 - <parameter>php3_max_execution_time</parameter>, dans le fichier - Apache <filename>.conf</filename> ou encore avec la fonction - <function>set_time_limit</function>. - - Lorsque le d&eacute;lai expire, le script est termin&eacute;, + Votre script peut aussi &eacute;xpirer apr&egrave;s un laps 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 + <parameter>php3_max_execution_time</parameter>, dans le fichier + Apache <filename>.conf</filename> ou encore avec la fonction + <function>set_time_limit</function>. + Lorsque le d&eacute;lai &eacute;xpire, le script est termin&eacute;, et comme pour la d&eacute;connexion du client, une fonction de - finalisation sera appel&eacute;e. Dans cette fonction, vous - pouvez savoir si c'est le d&eacute;lai d'expiration qui a - caus&eacute; la fin du script, en appelant la fonction - <function>connection_timeout</function>. Cette fonction - retournera vrai si le d&eacute;lai d'expiration a + finalisation sera appel&eacute;e. Dans cette fonction, vous + pouvez savoir si c'est le d&eacute;lai d'&eacute;xpiration qui a + caus&eacute; la fin du script, en appelant la fonction + <function>connection_timeout</function>. Cette fonction + retournera vrai si le d&eacute;lai d'&eacute;xpiration a &eacute;t&eacute; d&eacute;pass&eacute;. </simpara> - <simpara> - Une chose &agrave; noter et que les deux cas ABORTED et TIMEOUT - peuvent &ecirc;tre appel&eacute;s en m&ecirc;me temps. Ceci est - possible si vous demandez &agrave; PHP d'ignorer les - d&eacute;connexions des utilisateurs. PHP va quand + Une chose &agrave; noter et que les deux cas ABORTED et TIMEOUT + peuvent &ecirc;tre appel&eacute;s en m&ecirc;me temps. Ceci est + possible si vous demandez &agrave; PHP d'ignorer les + d&eacute;connexions des utilisateurs. PHP va quand m&ecirc;me noter le fait que l'utilisateur s'est d&eacute;connect&eacute;, - mais le script va continuer. Puis, lorsqu'il atteint la limite de - temps, le script va expirer. A ce moment l&agrave;, les deux - fonctions <function>connection_timeout</function> et - <function>connection_aborted</function> vont retourner TRUE. - Vous pouvez aussi v&eacute;rifier les deux &eacute;tats en un + mais le script va continuer. Puis, lorsqu'il atteint la limite de + temps, le script va &eacute;xpirer. A ce moment l&agrave;, les deux + fonctions <function>connection_timeout</function> et + <function>connection_aborted</function> vont retourner <literal>TRUE</literal>. + Vous pouvez aussi v&eacute;rifier les deux &eacute;tats en un seul appel avec la fonction <function>connection_status</function>. Cette fonction va retourner un champs de bits, avec les &eacute;tats. Si les deux &eacute;tats sont actifs, l'&eacute;tat retourn&eacute; prendra la valeur 3. </simpara> </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/cookies.xml diff -u phpdoc/fr/features/cookies.xml:1.2 phpdoc/fr/features/cookies.xml:1.3 --- phpdoc/fr/features/cookies.xml:1.2 Thu Nov 2 02:39:06 2000 +++ phpdoc/fr/features/cookies.xml Fri Jan 12 02:50:56 2001 @@ -1,28 +1,24 @@ <chapter id="features.cookies"> <title>Cookies</title> - <para> PHP supporte les cookies de mani&egrave;re transparente. Les cookies sont un m&eacute;canisme d'enregistrement d'informations sur le client, et de lecture de ces informations. Ce syst&egrave;me permet d'authentifier et de suivre les visiteurs. Vous pouvez envoyer un cookie avec la commande <function>setcookie</function>. Les cookies font partie de l'ent&ecirc;te - HTTP, ce qui impose que <function>setcookie</function> soit appel&eacute; - avant tout affichage sur le client. Ce sont les m&ecirc;mes limitations + HTTP, ce qui impose que <function>setcookie</function> soit appel&eacute; + avant tout affichage sur le client. Ce sont les m&ecirc;mes limitations que pour <function>header</function>. </para> - <para> Tous les cookies qui sont envoy&eacute;s au client seront automatiquement retourn&eacute;s au script PHP, et transform&eacute;s en variable, exactement comme pour GET et POST. Si vous souhaitez affecter plusieurs valeurs &agrave; un seul cookie, ajoutez<emphasis>[]</emphasis> - au nom du cookie. Pour plus details, reportez vous &agrave; la fonction + au nom du cookie. Pour plus details, reportez vous &agrave; la fonction <function>setcookie</function>. </para> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/error-handling.xml diff -u phpdoc/fr/features/error-handling.xml:1.2 phpdoc/fr/features/error-handling.xml:1.3 --- phpdoc/fr/features/error-handling.xml:1.2 Thu Nov 2 02:39:13 2000 +++ phpdoc/fr/features/error-handling.xml Fri Jan 12 02:50:56 2001 @@ -1,9 +1,7 @@ <chapter id="features.error-handling"> <title>Gestion des erreurs</title> - <para> - Il y a plusieurs types d'erreur et d'alerte. - + Il y a plusieurs types d'erreur et d'alerte. <table> <title>Types d'erreur PHP</title> <tgroup cols="4"> @@ -53,7 +51,7 @@ <entry>E_CORE_WARNING</entry> <entry> Alertes qui surviennent lors de l'initialisation de PHP - </entry> + </entry> <entry>PHP 4 seulement</entry> </row> <row> @@ -96,91 +94,83 @@ </tgroup> </table> </para> - <para> - Les valeurs ci-dessus (num&eacute;riques ou symbolique) sont utilis&eacute;e - pour construire un champs de bit, qui sp&eacute;cifie quelles erreurs - rapporter. Vous pouvez utiliser les + Les valeurs ci-dessus (num&eacute;riques ou symbolique) sont utilis&eacute;e + pour construire un champs de bit, qui sp&eacute;cifie quelles erreurs + rapporter. Vous pouvez utiliser les <link linkend="language.operators.bitwise">op&eacute;rateurs de bits</link> pour combiner ces valeurs et masquer uniquement celle qui vous interesse - Notez que seuls, '|', '~', '!', et '&amp;' seront utilisables dans + Notez que seuls, '|', '~', '!', et '&amp;' seront utilisables dans <filename>php.ini</filename>, et qu'aucun op&eacute;rateur ne sera utilisable dans <filename>php3.ini</filename>. </para> <para> - En PHP 4, la valeur par d&eacute;faut de - <link linkend="ini.error-reporting">error_reporting</link> est &agrave; + En PHP 4, la valeur par d&eacute;faut de + <link linkend="ini.error-reporting">error_reporting</link> est &agrave; <literal>E_ALL &amp; ~E_NOTICE</literal>, ce qui signifie que toutes les erreurs et alertes seront affich&eacute;es, mais pas les notes. En PHP 3, la valeur par d&eacute;faut est <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, - c'est &agrave; dire la m&ecirc;me chose. Notez bien que ces constantes ne sont pas - support&eacute;es dans le fichier <filename>php3.ini</filename> de PHP 3, - la valeur de <link linkend="ini.error-reporting">error_reporting</link> + c'est &agrave; dire la m&ecirc;me chose. Notez bien que ces constantes ne sont pas + support&eacute;es dans le fichier <filename>php3.ini</filename> de PHP 3, + la valeur de <link linkend="ini.error-reporting">error_reporting</link> doit &ecirc;tre num&eacute;riques, c'est &agrave; dire <literal>7</literal>. </para> - <para> - La valeur initiale peut &ecirc;tre modifi&eacute;e dans le fichier .ini, + La valeur initiale peut &ecirc;tre modifi&eacute;e dans le fichier .ini, avec la directive <link linkend="ini.error-reporting">error_reporting</link>, - dans le fichier de configuration d'Apache - <filename>httpd.conf</filename>, avec la directive - php_error_reporting (php3_error_reporting pour PHP 3), + dans le fichier de configuration d'Apache + <filename>httpd.conf</filename>, avec la directive + php_error_reporting (php3_error_reporting pour PHP 3), et enfin, dans le script m&ecirc;me, en utilisant la fonction <function>error_reporting</function>. </para> - <warning> <para> Lorsque vous portez votre code ou vos serveurs de PHP 3 en PHP 4 - vous devez v&eacute;rifier les options et les appels &agrave; + vous devez v&eacute;rifier les options et les appels &agrave; <function>error_reporting</function>. Sinon, vous courrez le risque d'inactiver certains types d'erreurs et notamment E_COMPILE_ERROR. Cela peut conduire &agrave; des documents vides, sans aucun retour d'erreur. </para> </warning> - <para> Toutes les <link linkend="language.expressions">expressions PHP</link> peuvent &ecirc;tre appel&eacute;e avec le pr&eacute;fixe "@", qui annule le rapport d'erreur pour cette expression en particulier. Si une erreur survient durant une - telle expression, et que l'option de + telle expression, et que l'option de <link linkend="ini.track-errors">suivi des erreurs </link> est activ&eacute;e, vous pourrez trouver le message d'erreur dans la variable globale, $php_errormsg. </para> - <warning> <para> Actuellement, le pr&eacute;fixe <link linkend="language.operators.errorcontrol">@ - , op&eacute;rateur de rapport d'erreur</link> d&eacute;sactive tous les rapports, + , op&eacute;rateur de rapport d'erreur</link> d&eacute;sactive tous les rapports, y compris les erreurs critiques qui interrompent le script. Entre autre, cela signifique que si vous utilisez <link - linkend="language.operators.errorcontrol">@</link> pour supprimer + linkend="language.operators.errorcontrol">@</link> pour supprimer des erreurs dans une fonction qui n'existe pas, ou qui a &eacute;t&eacute; mal orthographi&eacute;e, le script sera termin&eacute; sans aucune indication. </para> </warning> - <para> Ci dessous, voici un exemple de gestion des erreurs avec PHP. On d&eacute;finit une fonction de gestion des erreurs qui enregistre les informations dans un fichier (au format XML), et email le d&eacute;veloppeur - en cas d'erreur critique. + en cas d'erreur critique. <example> <title>Utiliser le contr&ocirc;le d'erreur dans un script</title> <programlisting role="php"> &lt;?php // Nous effectuons nous m&ecirc;me notre contr&ocirc;le d'erreur. error_reporting(0); - -// Fonction de gestion des erreurs utilisateur +// 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;); - // definit un tableau associatif avec les cha&icirc;nes d'erreur - // en realit&eacute;, les seules entr&eacute;es que nous consid&eacute;rerons + // en realit&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;, @@ -197,7 +187,6 @@ ); // 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;; @@ -205,42 +194,35 @@ $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;; - 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;; - // 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;); if ($errno == E_USER_ERROR) mail(&quot;phpdev@mydomain.com&quot;,&quot;Critical User Error&quot;,$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); 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); 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(&quot;La coordonn&eacute;e $i du vecteur 1 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro&quot;, 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(&quot;La coordonn&eacute;e $i du vecteur 2 n'est pas un nombre. Remplac&eacute;e par z&eacute;ro&quot;, E_USER_WARNING); $c2 = 0.0; } @@ -248,44 +230,34 @@ } return sqrt($d); } - $old_error_handler = set_error_handler(&quot;userErrorHandler&quot;); - // Constante ind&eacute;finie, g&eacute;n&eacute;re une alerte $t = I_AM_NOT_DEFINED; - // definition de quelques &quot;vecteurs&quot; $a = array(2,3,&quot;bla&quot;); $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;; - // g&eacute;n&egrave;re une autre erreur utilisateur $t2 = distance($b,&quot;i am not an array&quot;).&quot;\n&quot;; - // g&eacute;n&egrave;re une alerte $t3 = distance($a,$b).&quot;\n&quot;; - ?&gt; </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>, <function>error_log</function>, <function>set_error_handler</function>, - <function>restore_error_handler</function>, + <function>restore_error_handler</function>, <function>trigger_error</function>, <function>user_error</function> </para> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/file-upload.xml diff -u phpdoc/fr/features/file-upload.xml:1.5 phpdoc/fr/features/file-upload.xml:1.6 --- phpdoc/fr/features/file-upload.xml:1.5 Wed Dec 13 06:02:11 2000 +++ phpdoc/fr/features/file-upload.xml Fri Jan 12 02:50:56 2001 @@ -24,7 +24,7 @@ de la mani&egrave;re suivante : <example> <title>Formulaire de chargement de fichier</title> - <programlisting> + <programlisting role="html"> &lt;FORM ENCTYPE=&quot;multipart/form-data&quot; ACTION=&quot;_URL_&quot; METHOD=POST&gt; &lt;INPUT TYPE=&quot;hidden&quot; name=&quot;MAX_FILE_SIZE&quot; value=&quot;1000&quot;&gt; Send this file: &lt;INPUT NAME=&quot;userfile&quot; TYPE=&quot;file&quot;&gt; @@ -156,11 +156,11 @@ if (is_uploaded_file($userfile)) { copy($userfile, "/dossier/des/fichiers/telecharges/"); } else { - echo "Attaque potentielle par fichier t&eacute;l&eacute;charg&eacute;s : fichier '$userfile'."; + echo "Attaque potentielle par fichier t&eacute;l&eacute;charg&eacute; : fichier '$userfile'."; } /* ...ou... */ move_uploaded_file($userfile, "/dossier/des/fichiers/telecharges"); -?> +?&gt; </programlisting> <para> Pour les versions plus anciennes de PHP, vous devrez faire quelques @@ -181,24 +181,24 @@ $tmp_file = dirname(tempnam('', '')); } $tmp_file .= '/' . basename($filename); - /* L'utilisateur peut avoir un slash final dans php.ini... */ + /* 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"); } else { - echo "Attaque potentielle par fichier t&eacute;l&eacute;charg&eacute;s : fichier '$userfile'."; + echo "Attaque potentielle par fichier t&eacute;l&eacute;charg&eacute; : fichier '$userfile'."; } -?> +?&gt; </programlisting> </example> </para> <simpara> Le script PHP qui recoit le fichier charg&eacute; doit pouvoir g&eacute;rer le fichier de mani&egrave;re appropri&eacute;e. Vous - pouvez utiliser la variable $file_size pour recaler tous les fichiers + pouvez utiliser la variable <varname>$file_size</varname> pour recaler tous les fichiers qui sont trop gros ou trop petit. Vous pouvez utiliser la variable - $file_type pour recaler les fichiers qui n'ont pas le bon type. + <varname>$file_type</varname> pour recaler les fichiers qui n'ont pas le bon type. Quelque soit les actions, ce script doit pouvoir supprimer le fichier du dossier temporaire, ou le d&eacute;placer ailleurs. </simpara> @@ -213,7 +213,7 @@ <simpara> La variable MAX_FILE_SIZE ne peut pas sp&eacute;cifier une taille de fichier plus grande que la taille qui a &eacute;t&eacute; - fix&eacute;e par upload_max_filesize, dans le fichier PHP3.ini, ou + fix&eacute;e par upload_max_filesize, dans le fichier <filename>php3.ini</filename>, ou par php3_upload_max_filesize dans les directives Apache. La valeur par d&eacute;faut est 2 Megaoctets. </simpara> @@ -245,7 +245,7 @@ <para> <example> <title>Chargement multiple de fichier </title> - <programlisting> + <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; @@ -290,17 +290,17 @@ requ&ecirc;tes de type PUT sont beaucoup plus simples que les chargements de fichiers, et elles ressemblent &agrave; : <informalexample> - <programlisting> + <programlisting role="HTTP"> PUT /path/filename.html HTTP/1.1 </programlisting> </informalexample> </para> <para> Normalement, cela signifie que le client distant va sauver - les donn&eacute;es qui suivent dans le fichier: /path/filename.html + les donn&eacute;es qui suivent dans le fichier: <filename>/path/filename.html</filename> de votre disque. Ce n'est &eacute;videmment pas tr&egrave;s s&eacute;curis&eacute; de laisser Apache ou PHP &eacute;craser n'importe - quel fichier de l arborescence. Pour &eacute;viter ceci, il faut d abord + quel fichier de l'arborescence. Pour &eacute;viter ceci, il faut d'abord dire au serveur que vous voulez qu'un script PHP donn&eacute; g&egrave;re la requ&ecirc;te. Avec Apache, il y a une directive pour cela : <emphasis>Script</emphasis>. Elle peut &ecirc;tre plac&eacute;e @@ -325,8 +325,10 @@ </simpara> <para> <informalexample> - <programlisting> -&lt;?php copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); ?&gt; + <programlisting role="php"> +&lt;?php + copy($PHP_UPLOADED_FILE_NAME,$DOCUMENT_ROOT.$REQUEST_URI); +?&gt; </programlisting> </informalexample> </para> @@ -343,7 +345,7 @@ 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 - plac&eacute;e dans $REQUEST_URI (ces noms peuvent changer d'une + 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 &agrave; ob&eacute;ir aveugl&eacute;ment au client. Vous pourriez Index: phpdoc/fr/features/http-auth.xml diff -u phpdoc/fr/features/http-auth.xml:1.2 phpdoc/fr/features/http-auth.xml:1.3 --- phpdoc/fr/features/http-auth.xml:1.2 Fri Nov 3 03:48:00 2000 +++ phpdoc/fr/features/http-auth.xml Fri Jan 12 02:50:56 2001 @@ -1,25 +1,23 @@ <chapter id="features.http-auth"> <title>Authentification HTTP avec PHP</title> - <simpara> - Les fonctions d'authentification HTTP de PHP ne sont disponibles - que si PHP est ex&eacute;cut&eacute; comme module Apache, et non - pas sous la forme d'un CGI. Sous cette forme, il est possible - d'utiliser la fonction <function>Header</function> pour demander - une authentification ("Authentication Required" ) au client, - g&eacute;n&eacute;rant ainsi l'apparition d'une fen&ecirc;tre - de demande d'utilisateur et de mot de passe. Une fois que les - champs ont &eacute;t&eacute; remplis, l'URL sera de nouveau - appel&eacute;e, avec les variables $PHP_AUTH_USER, $PHP_AUTH_PW - et $PHP_AUTH_TYPE contenant respectivement le nom d'utilisateur, - le mot de passe et le type d'authentification. - Actuellement, seule l'authentification simple ("Basic") est - support&eacute;e. Reportez vous &agrave; la fonction - <function>Header</function> pour plus d'informations. + Les fonctions d'authentification HTTP de PHP ne sont disponibles + que si PHP est ex&eacute;cut&eacute; comme module Apache, et non + pas sous la forme d'un CGI. Sous cette forme, il est possible + d'utiliser la fonction <function>header</function> pour demander + une authentification ("Authentication Required" ) au client, + g&eacute;n&eacute;rant ainsi l'apparition d'une fen&ecirc;tre + de demande d'utilisateur et de mot de passe. Une fois que les + champs ont &eacute;t&eacute; remplis, l'URL sera de nouveau + appel&eacute;e, avec les variables <varname>$PHP_AUTH_USER</varname>, + <varname>$PHP_AUTH_PW</varname> et <varname>$PHP_AUTH_TYPE</varname> + contenant respectivement le nom d'utilisateur, le mot de passe et + le type d'authentification. Actuellement, seule l'authentification + simple ("Basic") est support&eacute;e. Reportez vous &agrave; la fonction + <function>header</function> pour plus d'informations. </simpara> - <para> - Voici un exemple de script qui force l'authentification du client + Voici un exemple de script qui force l'authentification du client pour acc&eacute;der &agrave; une page : <example> <title>Exemple d'authentication HTTP</title> @@ -31,97 +29,89 @@ echo &quot;Texte &agrave; envoyer si le client appuie sur le bouton d'annulation\n&quot;; 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 &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; } -?> +?&gt; </programlisting> - </example></para> - + </example> + </para> <para> - Au lieu d'afficher simplement les variables globales $PHP_AUTH_USER et - $PHP_AUTH_PW, vous pr&eacute;f&eacute;rerez s&ucirc;rement v&eacute;rifier - la validit&eacute; du nom d'utilisateur et du mot de passe. Par exemple, - en envoyant ces informations &agrave; une base de donn&eacute;es, + 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 + v&eacute;rifier la validit&eacute; du nom d'utilisateur et du mot de passe. + Par exemple, en envoyant ces informations &agrave; une base de donn&eacute;es, ou en recherchant dans un fichier dbm. </para> - <para> - M&eacute;fiez vous des navigateurs bugg&eacute;s, tels que Internet Explorer. - Ils semblent tr&egrave;s suceptibles concernant l'ordre des ent&ecirc;tes. + M&eacute;fiez vous des navigateurs bugg&eacute;s, tels que Internet Explorer. + Ils semblent tr&egrave;s suceptibles concernant l'ordre des ent&ecirc;tes. Envoyer l'ent&ecirc;te d'authentification (<emphasis>WWW-Authenticate</emphasis>) - avant le code de <errorcode>HTTP/1.0 401</errorcode> semble lui convenir + avant le code de <errorcode>HTTP/1.0 401</errorcode> semble lui convenir jusqu'&agrave; pr&eacute;sent. </para> - <simpara> - Pour &eacute;viter que quelqu'un &eacute;crive un script qui + Pour &eacute;viter que quelqu'un &eacute;crive un script qui r&eacute;v&egrave;le les mots de passe d'une page, &agrave; la quelle on a acc&eacute;d&eacute; par une authentification traditionnelle, - les variables globales PHP_AUTH ne seront pas assign&eacute;es si + 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 $REMOTE_USER 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. </simpara> - <simpara> - Notez cependant que les manipulations ci-dessus n'emp&ecirc;chent - pas quiconque qui poss&egrave;de une page non authentifi&eacute;e - de voler les mots de passes des pages prot&eacute;g&eacute;es, + Notez cependant que les manipulations ci-dessus n'emp&ecirc;chent + pas quiconque qui poss&egrave;de une page non authentifi&eacute;e + de voler les mots de passes des pages prot&eacute;g&eacute;es, sur le m&ecirc;me serveur. </simpara> - <simpara> - Netscape et Internet Explorer effaceront le cache d'authentification client - si ils recoivent une r&eacute;ponse 401. Cela permet de d&eacute;connecter - un utilisateur, pour le forcer &agrave; r&eacute;-entrer son nom de compte - et son mot de passe. Certains programmeurs l'utilisent pour donner un - d&eacute;lai d'expiration, ou alors, fournissent un bouton de d&eacute;connexion. - </simpara> - <example> - <title> - Authentification HTTP avec nom d'utilisateur/mot de passe forc&eacute; - </title> - <programlisting role="php"> + Netscape et Internet Explorer effaceront le cache d'authentification client + si ils recoivent une r&eacute;ponse 401. Cela permet de d&eacute;connecter + un utilisateur, pour le forcer &agrave; r&eacute;-entrer son nom de compte + et son mot de passe. Certains programmeurs l'utilisent pour donner un + d&eacute;lai d'&eacute;xpiration, ou alors, fournissent un bouton de d&eacute;connexion. + </simpara> + <example> + <title> + Authentification HTTP avec nom d'utilisateur/mot de passe forc&eacute; + </title> + <programlisting role="php"> &lt;?php - function authenticate() { + function authenticate() { Header( &quot;WWW-authenticate: basic realm='Test Authentication System'&quot;); Header( &quot;HTTP/1.0 401 Unauthorized&quot;); - echo &quot;You must enter a valid login ID and password to access this resource\n&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; } - if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) { authenticate(); - } + } else { - echo &quot;Welcome: $PHP_AUTH_USER&lt;BR&gt;&quot;; + 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;INPUT TYPE=Submit VALUE=\&quot;Re Authenticate\&quot;&gt;\n&quot; echo &quot;&lt;/FORM&gt;\n&quot;; - } -?> +?&gt; </programlisting> </example> <simpara> - Ce comportement n'est pas n&eacute;cessaire par le standard - d'authentification HTTP Basic. Les tests avec Lynx ont montr&eacute; - qu'il n'affectait pas les informations de session lors de la - r&eacute;ception d'un message de type 401, ce qui fait que passer ces - informations entre le serveur et le client, et donnera l'acc&egrave;s + Ce comportement n'est pas n&eacute;cessaire par le standard + d'authentification HTTP Basic. Les tests avec Lynx ont montr&eacute; + qu'il n'affectait pas les informations de session lors de la + r&eacute;ception d'un message de type 401, ce qui fait que passer ces + informations entre le serveur et le client, et donnera l'acc&egrave;s &agrave; la ressource. </simpara> <simpara> - Notez aussi que tout ceci ne fonctionne pas sous Microsoft's IIS et que les + 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> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/images.xml diff -u phpdoc/fr/features/images.xml:1.2 phpdoc/fr/features/images.xml:1.3 --- phpdoc/fr/features/images.xml:1.2 Fri Nov 3 03:48:11 2000 +++ phpdoc/fr/features/images.xml Fri Jan 12 02:50:56 2001 @@ -1,46 +1,41 @@ <chapter id="features.images"> <title>Cr&eacute;ation d'images</title> - <simpara> PHP n'est pas limit&eacute; &agrave; la cr&eacute;ation de - fichier HTML. Il peut aussi servir &agrave; cr&eacute;er + fichier HTML. Il peut aussi servir &agrave; cr&eacute;er des images GIF, PNG, JPG, wbmp et xpm, &agrave; la vol&eacute;e, - aussi bien pour les &eacute;mettre que pour les sauver. - Il faut alors compiler PHP avec la librairie GD. GD et PHP + aussi bien pour les &eacute;mettre que pour les sauver. + Il faut alors compiler PHP avec la librairie GD. GD et PHP requi&egrave;rent aussi d'autres librairies, suivant le format d'images que vous voulez supporter. GD a cess&eacute; de supporter le format GIF depuis la version 1.6. </simpara> - <para> <example> <title>Cr&eacute;ation d'images GIF avec PHP</title> <programlisting role="php"> &lt;?php - Header("Content-type: image/png"); + header("Content-type: image/png"); $string=implode($argv," "); - $im = imageCreateFromPng("images/button1.png"); - $orange = ImageColorAllocate($im, 220, 210, 60); + $im = imagecreatefrompng("images/button1.png"); + $orange = imagecolorallocate($im, 220, 210, 60); $px = (imagesx($im)-7.5*strlen($string))/2; - ImageString($im,3,$px,9,$string,$orange); - ImagePng($im); - ImageDestroy($im); -?> + 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 - telle que: &lt;img src=&quot;button.php3?text&quot;&gt;. + telle que: &lt;img src=&quot;button.php3?text&quot;&gt;. Le script ci-dessus r&eacute;cup&egrave;re le texte de la cha&icirc;ne $string et l'ajoute sur l'image de fond&quot;images/button1.gif&quot;. - Le r&eacute;sultat est alors envoy&eacute; au client. C'est un moyen - tr&egrave;s pratique d'&eacute;viter d'avoir &agrave; redessiner des - boutons &agrave; chaque fois que le texte du bouton change. Avec ce + Le r&eacute;sultat est alors envoy&eacute; au client. C'est un moyen + tr&egrave;s pratique d'&eacute;viter d'avoir &agrave; redessiner des + boutons &agrave; chaque fois que le texte du bouton change. Avec ce script, il est g&eacute;n&eacute;r&eacute; dynamiquement. </para> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/persistent-connections.xml diff -u phpdoc/fr/features/persistent-connections.xml:1.2 phpdoc/fr/features/persistent-connections.xml:1.3 --- phpdoc/fr/features/persistent-connections.xml:1.2 Fri Nov 3 03:48:14 2000 +++ phpdoc/fr/features/persistent-connections.xml Fri Jan 12 02:50:56 2001 @@ -1,89 +1,84 @@ <chapter id="features.persistent-connections"> <title>Connexions persistantes aux bases de donn&eacute;es</title> - <simpara> Les connexions persistantes aux bases de donn&eacute;es SQL sont des connexions qui ne se referment pas &agrave; la fin du script. Lorsqu'une connexion persistante est demand&eacute;e, PHP s'assure qu'il n'y a pas une autre connexion identique (qui serait ouverte - pr&eacute;c&eacute;demment, avec le m&ecirc;me nom d'h&ocirc;te, - d'utilisateur et de mot de passe), et si une telle connexion existe, - elle est utilis&eacute;e. Sinon, elle est cr&eacute;&eacute;e. Une - connexion identique est une connexion qui a ouvert le m&ecirc;me + pr&eacute;c&eacute;demment, avec le m&ecirc;me nom d'h&ocirc;te, + d'utilisateur et le m&ecirc;me mot de passe), et si une telle connexion + existe, elle est utilis&eacute;e. Sinon, elle est cr&eacute;&eacute;e. + Une connexion identique est une connexion qui a ouvert le m&ecirc;me h&ocirc;te, avec le m&ecirc;me nom et m&ecirc;me mot de passe (si ils sont n&eacute;cessaires). </simpara> <simpara> - Ceux qui ne sont pas habitu&eacute;s aux techniques des serveurs - web et leur distribution de la charge de travail, se font parfois - une fausse id&eacute;e de ces connexions persistantes. En particulier, - cela ne permet par l'ouverture de plusieurs sessions avec le m&ecirc;me - lien, cela ne permet pas la r&eacute;alisation de transactions efficaces, - et cela ne fait pas le caf&eacute;. En fait, pour &ecirc;tre - extr&ecirc;mement clair sur le sujet, les connexions persistantes - ne vous donnent aucune fonctionnalit&eacute; de plus que les - connexions non persistantes. + Ceux qui ne sont pas rompus aux techniques des serveurs web et leur + distribution de la charge de travail, se font parfois une fausse + id&eacute;e de ces connexions persistantes. En particulier, + les connexions persistantes ne permettent pas l'ouverture de plusieurs + sessions avec le m&ecirc;me lien, ne permettent pas la r&eacute;alisation + de transactions efficaces et ne font pas le caf&eacute;. En fait, + pour &ecirc;tre extr&ecirc;mement clair sur le sujet, les + connexions persistantes ne vous donnent aucune fonctionnalit&eacute; + de plus que les connexions non persistantes. </simpara> <simpara> Alors pourquoi? - </simpara> + </simpara> <simpara> Cela s'explique par la mani&egrave;re avec laquelle les serveurs web - fonctionnent. Il y a trois mani&egrave;res d'utiliser PHP pour + fonctionnent. Il y a trois mani&egrave;res d'utiliser PHP pour g&eacute;n&eacute;rer des pages. </simpara> <simpara> - La premi&egrave;re est d'utiliser PHP comme un CGI (Common Interface Gateway). - Lorsque PHP fonctionne de cette mani&egrave;re, une instance de + La premi&egrave;re est d'utiliser PHP comme un CGI (Common Interface Gateway). + Lorsque PHP fonctionne de cette mani&egrave;re, une instance de l'interpr&eacute;teur PHP est cr&eacute;&eacute;e puis d&eacute;truit - pour chaque page demand&eacute;e. Etant donn&eacute; qu'il est - d&eacute;truit apr&egrave;s chaque requ&ecirc;te, toutes les - ressources acquises (comme une connexion &agrave; une base SQL), + pour chaque page demand&eacute;e. Etant donn&eacute; qu'il est + d&eacute;truit apr&egrave;s chaque requ&ecirc;te, toutes les + ressources acquises (comme une connexion &agrave; une base SQL), sont purement et simplement d&eacute;truites. </simpara> - <simpara> La deuxi&egrave;me m&eacute;thode, et de loin, la plus pris&eacute;e, - est d'ex&eacute;cuter PHP sous la forme d'un module sur un serveur + est d'ex&eacute;cuter PHP sous la forme d'un module sur un serveur multi-process, ce qui revient &agrave; dire : Apache. Un tel serveur a typiquement un processus parent qui coordonne un ensemble de processus fils, - qui servent les fichiers. Lorsque les requ&ecirc;tes parviennent depuis + qui servent les fichiers. Lorsque les requ&ecirc;tes parviennent depuis un client, elles sont transmises &agrave; un fils disponible. Cela signifie - que si un client fait une deuxi&egrave;me requ&ecirc;te, il peut + que si un client fait une deuxi&egrave;me requ&ecirc;te, il peut &ecirc;tre servi par un processus client diff&eacute;rent du premier. Les connexions persistantes vous permettent alors de ne vous connecter &agrave; une base SQL que la premi&egrave;re fois. Lors des connexions - ult&eacute;rieures, les processus fils pourront r&eacute;utiliser la + ult&eacute;rieures, les processus fils pourront r&eacute;utiliser la connexion ouverte pr&eacute;c&eacute;demment. </simpara> - <simpara> La derni&egrave;re m&eacute;thode est d'utiliser PHP sous la forme d'un - module. Pour un serveur multi-thread, actuellement, c'est purement + module. Pour un serveur multi-thread, actuellement, c'est purement th&eacute;orique, car PHP ne fonctionne par encore sous cette forme. Le d&eacute;veloppement est en cours pour supporter ISAPI, WSAPI, et - NSAPI (sous Windows), qui permettront d'utiliser PHP comme un module pour + NSAPI (sous Windows), qui permettront d'utiliser PHP comme un module pour des serveurs tels que Netscape FastTrack, Microsoft's Internet Information - Server (IIS), et O'Reilly's WebSite Pro. Lorsque cela sera fait, le + Server (IIS), et O'Reilly's WebSite Pro. Lorsque cela sera fait, le comportement sera le m&ecirc;me que pour les serveur multi-process. </simpara> - <simpara> - Si les connexions persistantes n'ont aucune fonctionnalit&eacute; de plus, + Si les connexions persistantes n'ont aucune fonctionnalit&eacute; de plus, &agrave; quoi servent-elles? </simpara> - <simpara> - La r&eacute;ponse est extr&ecirc;mement simple : efficacit&eacute;. Les + La r&eacute;ponse est extr&ecirc;mement simple : efficacit&eacute;. Les connexions persistantes sont un bon moyen d'acc&eacute;l&eacute;rer les acc&egrave;s &agrave; une base SQL si le traitement de connexion &agrave; - la base est long. Ce temps d&eacute;pend de nombreux facteurs : le type + la base est long. Ce temps d&eacute;pend de nombreux facteurs : le type de base de donn&eacute;es, cette base est-elle sur le m&ecirc;me serveur ou pas, quelle est la charge du serveur de base de donn&eacute;es, etc... - Si le temps de connexion est long, les connexions persistantes seront - bien utiles, car une fois ouverte par un processus fils, la connexion est - r&eacute;utilisable sans avoir &agrave; se reconnecter. Si vous avez 20 - processus fils, il suffit d'avoir 20 connexions persistantes ouvertes, + Si le temps de connexion est long, les connexions persistantes seront + bien utiles, car une fois ouverte par un processus fils, la connexion est + r&eacute;utilisable sans avoir &agrave; se reconnecter. Si vous avez 20 + processus fils, il suffit d'avoir 20 connexions persistantes ouvertes, une par fils. </simpara> <simpara> @@ -95,19 +90,17 @@ sur la touche. Si il y a des erreurs dans les scripts qui ne permettent pas de fermer la connexion (par exemple, une boucle infinie), votre serveur sera rapidement engorg&eacute;. V&eacute;rifier la documentation de votre - base de donn&eacute;es pour savoir comment elle traite les connexions + base de donn&eacute;es pour savoir comment elle traite les connexions inactives ou abandonn&eacute;es. </simpara> <simpara> R&eacute;sumons nous : les connexions persistantes ont &eacute;t&eacute; - d&eacute;finies pour avoir les m&ecirc;mes fonctionnalit&eacute;s que - les connexions non persistantes. Les deux types de connexions - sont parfaitement interchangeables, et n'affecteront pas le + d&eacute;finies pour avoir les m&ecirc;mes fonctionnalit&eacute;s que + les connexions non persistantes. Les deux types de connexions + sont parfaitement interchangeables, et n'affecteront pas le comportement de votre script : uniquement son efficacit&eacute;. </simpara> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml Index: phpdoc/fr/features/remote-files.xml diff -u phpdoc/fr/features/remote-files.xml:1.2 phpdoc/fr/features/remote-files.xml:1.3 --- phpdoc/fr/features/remote-files.xml:1.2 Fri Nov 3 03:48:18 2000 +++ phpdoc/fr/features/remote-files.xml Fri Jan 12 02:50:56 2001 @@ -1,33 +1,32 @@ <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 <option>--disable-url-fopen-wrapper</option> - pour faire la configuration), vous pouvez utiliser des URLs - (HTTP et FTP) avec la plupart des fonctions qui utilisent un - nom de fichier comme param&egrave;tre, ceci incluant les expressions - <function>require</function> et <function>include</function>. + 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 <option>--disable-url-fopen-wrapper</option> + pour faire la configuration), vous pouvez utiliser des URLs + (HTTP et FTP) avec la plupart des fonctions qui utilisent un + nom de fichier comme param&egrave;tre, ceci incluant les expressions + <function>require</function> et <function>include</function>. <note> <para> - Vous ne pouvez pas utiliser les fichiers distants dans les expressions + Vous ne pouvez pas utiliser les fichiers distants dans les expressions <function>include</function> et <function>require</function> avec Windows. </para> </note> </para> <para> - Par exemple, vous pouvez suivre l'exemple suivant pour ouvrir un - fichier sur un serveur web distant, analyser les r&eacute;sultats - pour extraire les informations dont vous avez besoin, et ensuite - l'utiliser dans une requ&ecirc;te de base de donn&eacute;es, ou - simplement &eacute;diter les informations dans le style de votre site. + Par exemple, vous pouvez suivre l'exemple suivant pour ouvrir un + fichier sur un serveur web distant, analyser les r&eacute;sultats + pour extraire les informations dont vous avez besoin, et ensuite + l'utiliser dans une requ&ecirc;te de base de donn&eacute;es, ou + simplement &eacute;diter les informations dans le style de votre site. </para> <para> <example> - <title>Conna&icirc;tre le titre du page distante</title> - <programlisting> + <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) { @@ -48,21 +47,21 @@ </example> </para> <para> - 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 - 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@ftp.example.com/path/to/file'. - (Vous pouvez utiliser le m&ecirc;me type de syntaxe pour acc&eacute;der - aux fichiers via HTTP lorsqu'ils n&eacute;cessitent une - authentification basique.) + 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 + 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@ftp.example.com/path/to/file'. + (Vous pouvez utiliser le m&ecirc;me type de syntaxe pour acc&eacute;der + aux fichiers via HTTP lorsqu'ils n&eacute;cessitent une + authentification basique.) </para> <para> <example> <title>Stocker des donn&eacute;es sur un serveur distant</title> - <programlisting> + <programlisting role="php"> &lt?;php $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); if (!$file) { @@ -77,19 +76,17 @@ </example> <note> <para> - Remarque: Vous pouvez avoir l'id&eacute;e,&agrave; partir de - l'exemple ci-dessus, d'utiliser la m&ecirc;me technique pour - &eacute;crire sur un log distant, mais comme mentionn&eacute; ci-dessus - vous ne pouvez qu'&eacute;crire sur un nouveau fichier en utilisant - les fonctions <function>fopen</function> avec une URL. Pour faire des log - distribu&eacute;s, nous vous conseillons de regarder la partie - <function>syslog</function>. + Remarque: Vous pouvez avoir l'id&eacute;e,&agrave; partir de + l'exemple ci-dessus, d'utiliser la m&ecirc;me technique pour + &eacute;crire sur un log distant, mais comme mentionn&eacute; ci-dessus + vous ne pouvez qu'&eacute;crire sur un nouveau fichier en utilisant + les fonctions <function>fopen</function> avec une URL. Pour faire des log + distribu&eacute;s, nous vous conseillons de regarder la partie + <function>syslog</function>. </para> </note> </para> - </chapter> - <!-- Keep this comment at the end of the file Local variables: mode: sgml
« previous php.doc (#969333574) next »