cvs: phpdoc /fr/features file-upload.xml

From: Date: Tue, 24 Jul 2001 13:46:58 +0000
Subject: cvs: phpdoc /fr/features file-upload.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969336477@lists.php.net to get a copy of this message
dams Tue Jul 24 09:46:58 2001 EDT Modified files: /phpdoc/fr/features file-upload.xml Log: Updated HTML specifications

Index: phpdoc/fr/features/file-upload.xml diff -u phpdoc/fr/features/file-upload.xml:1.9 phpdoc/fr/features/file-upload.xml:1.10 --- phpdoc/fr/features/file-upload.xml:1.9 Mon Feb 26 06:11:36 2001 +++ phpdoc/fr/features/file-upload.xml Tue Jul 24 09:46:57 2001 @@ -4,18 +4,18 @@ <title>Chargements de fichiers par m&eacute;thode POST </title> <simpara> PHP est capable de recevoir des fichiers &eacute;mis par - un navigateur conforme &agrave; la norme RFC-1867 (c'est - &agrave; dire Netscape Navigator 3 ou sup&eacute;rieur, Microsoft + un navigateur conforme &agrave; la norme RFC-1867 + (c'est-&agrave;-dire Netscape Navigator 3 ou sup&eacute;rieur, Microsoft Internet Explorer 3 avec un patch de Microsoft, ou sup&eacute;rieur sans le patch). Cette fonctionnalit&eacute; permet de charger des - fichiers texte binaire. Avec l'authentification et les fonctions + fichiers textes ou binaires. Avec l'authentification et les fonctions de manipulation des fichiers, vous avez un contr&ocirc;le total sur le chargement et la gestion des fichiers charg&eacute;s. </simpara> <para> Notez bien que PHP supporte aussi le chargement par la m&eacute;thode PUT comme dans le navigateur Netscape Composer - et les clients Amaya du W3C. Reportez vous au chapitre sur le + et les clients Amaya du W3C. Reportez-vous au chapitre sur le <link linkend="features.file-upload.put-method">support de la m&eacute;thode PUT</link>. </para> @@ -25,9 +25,9 @@ <example> <title>Formulaire de chargement de fichier</title> <programlisting role="html"> -&lt;FORM ENCTYPE=&quot;multipart/form-data&quot; ACTION=&quot;_URL_&quot; METHOD=POST&gt; +&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; -Send this file: &lt;INPUT NAME=&quot;userfile&quot; TYPE=&quot;file&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; </programlisting> @@ -47,7 +47,7 @@ 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 + fichier t&eacute;l&eacute;charg&eacute; est 'userfile', comme pr&eacute;sent&eacute; dans l'exemple ci-dessus. <itemizedlist> <listitem> @@ -77,22 +77,22 @@ </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, + le champs INPUT de type TYPE=file. Dans l'exemple ci-dessus, nous avons choisi de l'appeler &quot;userfile&quot;. </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 - <link linkend="ini.track-vars">track_vars</link> est activ&eacute;, mais + 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; dans les versions de PHP sup&eacute;rieure &agrave; la version + 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 + 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 : <variablelist> @@ -134,12 +134,12 @@ <para> Les fichiers seront enregistr&eacute;s par d&eacute;faut dans le dossier des fichiers temporaires, &agrave; moins qu'un autre dossier - n'ai &eacute;t&eacute; fourni avec la directive de configuration + 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 modificaion avec <function>putenv</function> depuis un script 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. @@ -153,7 +153,7 @@ <function>is_uploaded_file</function> et <function>move_uploaded_file</function>. </para> <programlisting role="php"> -&lt?php +&lt?;php if (is_uploaded_file($userfile)) { copy($userfile, "/dossier/des/fichiers/telecharges/"); } else { @@ -164,18 +164,11 @@ ?&gt; </programlisting> <para> - Pour les versions plus anciennes de PHP, vous devrez faire quelques - chose comme : - <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 on &eacute;volu&eacute;e apr&egrave;s cette version. - </para> - </note> + Pour les versions plus anciennes de PHP, vous devrez faire quelque + chose comme ceci : </para> <programlisting role="php"> -&lt?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')) { @@ -194,18 +187,25 @@ </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 recoit le fichier charg&eacute; doit pouvoir + 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 pouvez utiliser la variable <varname>$file_size</varname> pour recaler - tous les fichiers qui sont trop gros ou trop petit. Vous pouvez utiliser + tous les fichiers qui sont trop gros ou trop petits. Vous pouvez utiliser la variable <varname>$file_type</varname> pour recaler les fichiers qui - n'ont pas le bon type. Quelque soient les actions, ce script doit pouvoir + 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. </simpara> <simpara> Le fichier sera automatiquement effac&eacute; du fichier temporaire - &agrave; la fin du script, si il n'a pas &eacute;t&eacute; + &agrave; la fin du script, s'il n'a pas &eacute;t&eacute; d&eacute;plac&eacute; ou renomm&eacute;. </simpara> </sect1> @@ -224,18 +224,18 @@ </simpara> <simpara> Attention : il semble que CERN httpd supprime tout ce qui est apr&egrave;s - le premier caract&egrave;re dans l'ent&ecirc;te MIME. Tant que c'est le cas, + le premier caract&egrave;re dans l'en-t&ecirc;te MIME. Tant que c'est le cas, CERN httpd ne pourra pas effectuer de chargement. </simpara> </sect1> <sect1 id="feature-fileupload.multiple"> <title>Chargement multiples de fichiers</title> <simpara> - Il est possible de charger plusieurs fichiers en m&ecirc;me temps, et + 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;te &agrave; cocher multiples. + bo&icirc;tes &agrave; cocher multiples. </simpara> <note> <para> @@ -257,7 +257,7 @@ </example> </para> <simpara> - Lorsque le formulaire ci dessus est envoy&eacute;, les tableaux + 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 @@ -269,7 +269,7 @@ Par exemple, supposons que les noms de fichier <filename>/home/test/review.html</filename> et <filename>/home/test/xwp.out</filename> soient envoy&eacute;s. - Sans ce cas, <computeroutput>$userfile_name[0]</computeroutput> + 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, @@ -280,7 +280,7 @@ <computeroutput>$userfile['name'][0]</computeroutput>, <computeroutput>$userfile['tmp_name'][0]</computeroutput>, <computeroutput>$userfile['size'][0]</computeroutput>, et - <computeroutput>$userfile['type'][0]</computeroutput> + <computeroutput>$userfile['type'][0]</computeroutput> sont aussi affect&eacute;s. </simpara> </sect1> @@ -306,7 +306,7 @@ 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 - n'importe o&uacute; dans le fichier de configuration d'Apache. + n'importe o&ugrave; dans le fichier de configuration d'Apache. En g&eacute;n&eacute;ral, les webmestres la place dans le bloc &lt;Directory&gt;, ou peut &ecirc;tre dans le bloc &lt;Virtualhost&gt;. La ligne suivante fera tr&egrave;s bien l'affaire : @@ -339,7 +339,7 @@ &agrave; l'endroit d&eacute;sir&eacute;. Vous aurez probablement &agrave; effectuer quelques tests et des authentifications d'utilisateur, avant d'effectuer cette copie. Le seul pi&egrave;ge - est que lorsque PHP recoit un chargement par m&eacute;thode PUT, + 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>.
« previous php.doc (#969336477) next »