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éthode POST </title>
<simpara>
PHP est capable de recevoir des fichiers émis par
- un navigateur conforme à la norme RFC-1867 (c'est
- à dire Netscape Navigator 3 ou supérieur, Microsoft
+ un navigateur conforme à la norme RFC-1867
+ (c'est-à-dire Netscape Navigator 3 ou supérieur, Microsoft
Internet Explorer 3 avec un patch de Microsoft, ou supérieur
sans le patch). Cette fonctionnalité 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ôle total
sur le chargement et la gestion des fichiers chargés.
</simpara>
<para>
Notez bien que PHP supporte aussi le chargement par la
mé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éthode PUT</link>.
</para>
@@ -25,9 +25,9 @@
<example>
<title>Formulaire de chargement de fichier</title>
<programlisting role="html">
-<FORM ENCTYPE="multipart/form-data" ACTION="_URL_"
METHOD=POST>
+<FORM ENCTYPE="multipart/form-data" ACTION="_URL_"
+METHOD="POST">
<INPUT TYPE="hidden" name="MAX_FILE_SIZE"
value="1000">
-Send this file: <INPUT NAME="userfile" TYPE="file">
+Envoyez ce fichier : <INPUT NAME="userfile" TYPE="file">
<INPUT TYPE="submit" VALUE="Send File">
</FORM>
</programlisting>
@@ -47,7 +47,7 @@
linkend="ini.track-vars">track_vars</link> est activé, elles seront aussi
disponibles dans le dossier <varname>$HTTP_POST_VARS</varname>.
Notez que les noms des variables suivantes supposent que nom du
- fichier téléchargé est 'userfile', comme
+ fichier téléchargé est 'userfile', comme
présenté dans l'exemple ci-dessus.
<itemizedlist>
<listitem>
@@ -77,22 +77,22 @@
</listitem>
</itemizedlist>
Notez que "$userfile" prend la valeur qui est passée dans
- le champs INPUT de type TYPE=file. Dans l'exemple ci dessus,
+ le champs INPUT de type TYPE=file. Dans l'exemple ci-dessus,
nous avons choisi de l'appeler "userfile".
</para>
<para>
En PHP 4, le comportement est légèrement différent, car
c'est la
variable d'environnement <varname>$HTTP_POST_FILES</varname>, qui
contiendra les informations sur les fichiers téléchargés.
- Ces informations sont disponibles dans si
- <link linkend="ini.track-vars">track_vars</link> est activé, mais
+ Ces informations sont disponibles dans si l'option
+ <link linkend="ini.track-vars">track_vars</link> est activée, mais
<link linkend="ini.track-vars">track_vars</link> est toujours
- activé dans les versions de PHP supérieure à la version
+ activée dans les versions de PHP supérieures à la version
4.0.2.
</para>
<para>
Le contenu du tableau <varname>$HTTP_POST_FILES</varname> décrit
- ci dessous. Notez que l'on suppose ici que le nom du fichier
+ ci-dessous. Notez que l'on suppose ici que le nom du fichier
téléchargé est '<literal>userfile</literal>',
comme présenté dans l'exemple ci-dessus :
<variablelist>
@@ -134,12 +134,12 @@
<para>
Les fichiers seront enregistrés par défaut dans le dossier
des fichiers temporaires, à moins qu'un autre dossier
- n'ai été fourni avec la directive de configuration
+ n'ait été fourni avec la directive de configuration
<link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> du fichier
<filename>php.ini</filename>. Le dossier par défaut du serveur
peut être modifié grâce à la variable d'environnement
<envar>TMPDIR</envar>, de l'utilisateur qui exécute PHP.
- Sa 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 être
utilisée pour s'assurer que d'autres opérations fonctionnent avec
les fichiers téléchargés.
@@ -153,7 +153,7 @@
<function>is_uploaded_file</function> et
<function>move_uploaded_file</function>.
</para>
<programlisting role="php">
-<?php
+<?;php
if (is_uploaded_file($userfile)) {
copy($userfile, "/dossier/des/fichiers/telecharges/");
} else {
@@ -164,18 +164,11 @@
?>
</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érieure à 4.0.2. Cela repose sur des
fonctionnalités
- internes à PHP qui on évoluée après cette version.
- </para>
- </note>
+ Pour les versions plus anciennes de PHP, vous devrez faire quelque
+ chose comme ceci :
</para>
<programlisting role="php">
-<?php
+<?;php
/* Test du fichier téléchargé. */
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érieure à 4.0.2. Cela repose sur des
+fonctionnalités
+ internes à PHP qui ont évolué après cette version.
+ </para>
+ </note>
<simpara>
- Le script PHP qui recoit le fichier chargé doit pouvoir
+ Le script PHP qui reçoit le fichier chargé doit pouvoir
gérer le fichier de manière approprié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éplacer ailleurs.
</simpara>
<simpara>
Le fichier sera automatiquement effacé du fichier temporaire
- à la fin du script, si il n'a pas été
+ à la fin du script, s'il n'a pas été
déplacé ou renommé.
</simpara>
</sect1>
@@ -224,18 +224,18 @@
</simpara>
<simpara>
Attention : il semble que CERN httpd supprime tout ce qui est après
- le premier caractère dans l'entête MIME. Tant que c'est le cas,
+ le premier caractère dans l'en-tê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ême temps, et
+ Il est possible de charger plusieurs fichiers en même temps, et de
recevoir les informations adéquates organisées sous
forme de tableau. Pour ce faire, il faut utiliser la même
syntaxe d'envoi dans le code HTML que pour les sélections ou
- boîte à cocher multiples.
+ boîtes à cocher multiples.
</simpara>
<note>
<para>
@@ -257,7 +257,7 @@
</example>
</para>
<simpara>
- Lorsque le formulaire ci dessus est envoyé, les tableaux
+ Lorsque le formulaire ci-dessus a étéF envoyé, les tableaux
<computeroutput>$userfile</computeroutput>,
<computeroutput>$userfile_name</computeroutput>, et
<computeroutput>$userfile_size</computeroutput> seront initialisés
@@ -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é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és.
</simpara>
</sect1>
@@ -306,7 +306,7 @@
dire au serveur que vous voulez qu'un script PHP donné gère
la requête. Avec Apache, il y a une directive pour cela :
<emphasis>Script</emphasis>. Elle peut être placée
- n'importe oú dans le fichier de configuration d'Apache.
+ n'importe où dans le fichier de configuration d'Apache.
En général, les webmestres la place dans le bloc
<Directory>, ou peut être dans le bloc <Virtualhost>.
La ligne suivante fera très bien l'affaire :
@@ -339,7 +339,7 @@
à l'endroit désiré. Vous aurez probablement
à effectuer quelques tests et des authentifications
d'utilisateur, avant d'effectuer cette copie. Le seul piège
- est que lorsque PHP recoit un chargement par méthode PUT,
+ est que lorsque PHP reçoit un chargement par méthode PUT,
il va enregistrer le fichier dans le dossier temporaire, tout comme
avec la
<link linkend="features.file-upload.post-method">méthode
POST-method</link>.
