dams Mon Jul 2 06:24:28 2001 EDT
Modified files:
/phpdoc/fr/functions filesystem.xml
Log:
Updating the move_uploaded_file() cross reference (was itself!).
Index: phpdoc/fr/functions/filesystem.xml
diff -u phpdoc/fr/functions/filesystem.xml:1.22 phpdoc/fr/functions/filesystem.xml:1.23
--- phpdoc/fr/functions/filesystem.xml:1.22 Mon May 7 09:08:58 2001
+++ phpdoc/fr/functions/filesystem.xml Mon Jul 2 06:24:25 2001
@@ -22,7 +22,7 @@
</para>
<para>
Sous Windows, les caractères (<literal>/</literal>) et antislash
- (<literal>\</literal>) sont utilisés comme séparateur de
+ (<literal>\</literal>) sont utilisés comme séparateurs de
dossier. Sous les autres OS, seul le caractère slash
(<literal>/</literal>) est utilisé.
</para>
@@ -38,7 +38,8 @@
</example>
</para>
<para>
- Voir aussi: <function>dirname</function>.
+ Voir aussi
+ <function>dirname</function>.
</para>
</refsect1>
</refentry>
@@ -58,8 +59,9 @@
</funcsynopsis>
<para>
<function>chgrp</function> essaie de changer le groupe propriétaire
- du fichier. Seul le superuser (root) peut changer le groupe propriétaire
- d'un fichier arbitrairement. Les utilisateurs classiques ne peuvent changer
+ du fichier. Seul le super-utilisateur (root) peut changer le groupe
+ propriétaire d'un fichier arbitrairement. Les utilisateurs
+ classiques ne peuvent changer
le groupe propriétaire d'un fichier que si l'utilisateur
propriétaire du fichier est membre du groupe.
</para>
@@ -68,7 +70,9 @@
cas de succès, sinon renvoie <literal>FALSE</literal>.
</para>
<para>
- Voir aussi <function>chown</function> et <function>chmod</function>.
+ Voir aussi
+ <function>chown</function> et
+ <function>chmod</function>.
</para>
<note>
<simpara>
@@ -116,7 +120,9 @@
en cas de succès, <literal>FALSE</literal> sinon.
</para>
<para>
- Voir aussi <function>chown</function> et <function>chgrp</function>.
+ Voir aussi
+ <function>chown</function> et
+ <function>chgrp</function>.
</para>
<note>
<simpara>
@@ -141,14 +147,15 @@
</funcsynopsis>
<para>
<function>chown</function> change le groupe propriétaire du fichier.
- Seul le superutilisateur (root) peut changer le propriétaire d'un fichier.
+ Seul le super-utilisateur (root) peut changer le propriétaire
+ arbitrairement d'un fichier.
</para>
<para>
<function>chown</function> renvoie <literal>TRUE</literal>
en cas de succès, "<literal>FALSE</literal>" sinon.
<note>
<simpara>
- Sous Windows, <function>chown</function> ne fait rien et
+ Sous Windows, <function>chown</function> ne fait rien et
retourne <literal>TRUE</literal>.
</simpara>
</note>
@@ -173,8 +180,10 @@
<refsect1>
<title>Description</title>
<funcsynopsis>
- <funcdef>void <function>clearstatcache</function></funcdef>
- <paramdef>void</paramdef>
+ <funcprototype>
+ <funcdef>void <function>clearstatcache</function></funcdef>
+ <paramdef>void</paramdef>
+ </funcprototype>
</funcsynopsis>
<para>
L'appel à la fonction <systemitem>stat</systemitem> ou
@@ -182,7 +191,7 @@
temps d'exécution. Pour cela, le résultat du dernier
appel à l'une des fonctions de statut, (voir la liste ci-dessous), est
sauvegardé pour ré-utilisation ultérieure. Si vous voulez
- forcer la vérification du statut d'un fichier, dans le cas
ooúugrave; le
+ forcer la vérification du statut d'un fichier, dans le cas où le
fichier aurait pu être modifié ou aurait disparu, vous
devez utiliser la fonction <function>clearstatcache</function>
afin d'effacer de la mémoire les résultats du dernier
@@ -234,13 +243,14 @@
<title>Exemple avec <function>copy</function></title>
<programlisting role="php">
if ( !copy($file, $file.'.bak') ) {
- print("La copie du fichier $file n'a pas réussi...<br>\n");
+ print("La copie du fichier $file n'a pas réussi...<br>\n");
}
</programlisting>
</example>
</para>
<para>
- Voir aussi: <function>rename</function>.
+ Voir aussi
+ <function>rename</function>.
</para>
</refsect1>
</refentry>
@@ -262,7 +272,8 @@
en fait la fonction <function>unlink</function> ou <function>unset</function>.
</para>
<para>
- Voir aussi: <function>unlink</function> pour effacer des fichiers,
+ Voir aussi
+ <function>unlink</function> pour effacer des fichiers et
<function>unset</function> pour effacer des variables.
</para>
</refsect1>
@@ -302,7 +313,8 @@
</example>
</para>
<para>
- Voir aussi: <function>basename</function>.
+ Voir aussi
+ <function>basename</function>.
</para>
</refsect1>
</refentry>
@@ -322,7 +334,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>diskfreespace</function> retournera le nombre d'octets disponible sur
+ <function>diskfreespace</function> retournera le nombre d'octets disponibles sur
le disque correspondant contenant le dossier <parameter>directory</parameter>.
</para>
<para>
@@ -337,6 +349,38 @@
</para>
</refsect1>
</refentry>
+ <refentry id="function.disk-total-space">
+ <refnamediv>
+ <refname>disk_total_space</refname>
+ <refpurpose>Retourne la taille d'un dossier</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>disk_total_space</function></funcdef>
+ <paramdef>string <parameter>directory</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>disk_total_space</function> lit récursivement toutes les tailles
+ du dossier <parameter>directory</parameter> et retourne la
+ somme. <parameter>directory</parameter> peut être aussi une partition
+ de disque.
+ </para>
+ <para>
+ <example>
+ <title>Exemple avec <function>disk_total_space</function></title>
+ <programlisting role="php">
+<?php
+$df = disk_total_space("/"); // $df contient le nombre d'octets libres
+ // dans le dossier "/"
+?>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
<refentry id="function.fclose">
<refnamediv>
<refname>fclose</refname>
@@ -346,7 +390,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>fclose</function></funcdef>
+ <funcdef>bool <function>fclose</function></funcdef>
<paramdef>resource <parameter>fp</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -405,7 +449,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>fflush</function> forces l'écriture de toutes les
+ <function>fflush</function> force l'écriture de toutes les
données bufferisées dans le fichier désigné
par <parameter>fp</parameter>. <function>fflush</function> retourne
<literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal>
@@ -459,8 +503,7 @@
<refnamediv>
<refname>fgetcsv</refname>
<refpurpose>
- Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier et
- cherche dans le résultat les champs CSV
+ Renvoie la ligne courante et cherche les champs CSV
</refpurpose>
</refnamediv>
<refsect1>
@@ -495,8 +538,8 @@
caractères de fin de ligne).
</simpara>
<simpara>
- <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas d'erreur,
ou en cas
- de fin du fichier.
+ <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas
+ d'erreur, ou en cas de fin du fichier.
</simpara>
<simpara>
Note : une ligne vide dans un fichier CSV sera retournée dans le
@@ -505,9 +548,7 @@
</simpara>
<example>
<title>
- Exemple avec <function>fgetcsv</function> une ligne vide dans un fichier
- CSV sera retournée dans le tableau comme une chaîne vide, et
- ne sera pas traitée comme une erreur.
+ Exemple avec <function>fgetcsv</function>
</title>
<programlisting role="php">
<?php
@@ -515,10 +556,10 @@
$fp = fopen ("test.csv","r");
while ($data = fgetcsv ($fp, 1000, ",")) {
$num = count ($data);
- print "<p> $num champs dans la ligne $row: <br>";
+ print "<p> $num champs dans la ligne $row: <br>";
$row++;
for ($c=0; $c<$num; $c++) {
- print $data[$c] . "<br>";
+ print $data[$c] . "<br>";
}
}
fclose ($fp);
@@ -545,7 +586,7 @@
</funcsynopsis>
<para>
<function>fgets</function> retourne la chaîne lue jusqu'à
- la longueur <parameter>length</parameter> - 1 octets, ou bien la fin du
+ la longueur <parameter>length</parameter> - 1 octet, ou bien la fin du
fichier, ou encore un retour chariot (le premier des trois qui sera
rencontré).
</para>
@@ -596,7 +637,7 @@
<refnamediv>
<refname>fgetss</refname>
<refpurpose>
- Renvoie la ligne courant sur laquelle se trouve le pointeur du fichier et
+ Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier et
élimine les balises HTML
</refpurpose>
</refnamediv>
@@ -629,8 +670,11 @@
</note>
</para>
<para>
- Voir aussi <function>fgets</function>, <function>fopen</function>,
- <function>fsockopen</function>, <function>popen</function>, et
+ Voir aussi
+ <function>fgets</function>,
+ <function>fopen</function>,
+ <function>fsockopen</function>,
+ <function>popen</function> et
<function>strip_tags</function>.
</para>
</refsect1>
@@ -657,11 +701,12 @@
Identique à <function>readfile</function>, hormis le fait que
<function>file</function> retourne le fichier dans un tableau. Chaque
élément du tableau correspond à une ligne du fichier,
- et les retour chariots sont placés en fin de ligne.
+ et les retour-chariots sont placés en fin de ligne.
</para>
<para>
- Vous pouvez utiliser l'option et en la mettant à "1", si vous voulez
- rechercher aussi dans le dossier <link
linkend="ini.include-path">include_path</link>.
+ Vous pouvez utiliser l'option <parameter>use_include_path</parameter> :
+ en la mettant à "1", vous rechercherez aussi dans le dossier
+ <link linkend="ini.include-path">include_path</link>.
</para>
<para>
<informalexample>
@@ -679,8 +724,11 @@
</informalexample>
</para>
<para>
- Voir aussi <function>readfile</function>, <function>fopen</function>,
- <function>fsockopen</function>, et <function>popen</function>.
+ Voir aussi
+ <function>readfile</function>,
+ <function>fopen</function>,
+ <function>fsockopen</function> et
+ <function>popen</function>.
</para>
</refsect1>
</refentry>
@@ -743,7 +791,7 @@
</simpara>
<simpara>
Le résultat de <function>fileatime</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</simpara>
</refsect1>
@@ -776,23 +824,23 @@
du serveur.
</simpara>
<para>
- Note: Sur la plus part des serveurs UNIX, un fichier est considéré
- comme modifié si les données de sont inode sont modifiées.
C'est à
- dire lorsque les permissions (utilisateur, group ou autre) ont
+ Note: Sur la plupart des serveurs UNIX, un fichier est considéré
+ comme modifié si les données de son inode sont modifiées.
+ C'est-à-dire lorsque les permissions (utilisateur, groupe ou autre) ont
été modifiées. Voyez aussi <function>filemtime</function>
(que vous pourrez utiliser lorsque vous créerez des indications
telles que "Dernière modification : " sur les pages web) et
<function>fileatime</function>.
</para>
<para>
- Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier
+ Notez aussi que sur certains systèmes UNIX, le ctime d'un fichier
texte est considéré comme sa date de création. Cela est faux!
- Il n'y a pas de date de création de fichier sous la plus part
+ Il n'y a pas de date de création de fichier sous la plupart
des systèmes UNIX.
</para>
<para>
Le résultat de <function>filectime</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
</refsect1>
@@ -812,7 +860,7 @@
</funcsynopsis>
<para>
<function>filegroup</function> renvoie le groupe qui possède le fichier
- <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur.
+ <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur.
L'identifiant de groupe est retourné au format numérique, utilisez
<function>posix_getgrgid</function> pour retrouver le nom du groupe.
</para>
@@ -824,7 +872,7 @@
</simpara>
<para>
Le résultat de <function>filegroup</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
<note>
@@ -853,7 +901,7 @@
</para>
<para>
Le résultat de <function>fileinode</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
<simpara>
@@ -891,7 +939,7 @@
</para>
<para>
Le résultat de <function>filemtime</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
<simpara>
@@ -901,10 +949,12 @@
du serveur.
</simpara>
<para>
- Note: <function>filemtime</function> retourne l'heure d'écriture
+ <note>
+ <function>filemtime</function> retourne l'heure d'écriture
des blocs données d'un fichier. Utilisez <function>date</function>
sur ce résultat pour obtenir une date de modification humainement
lisible.
+ </note>
</para>
</refsect1>
</refentry>
@@ -935,7 +985,7 @@
</simpara>
<para>
Le résultat de <function>fileowner</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
<note>
@@ -973,7 +1023,7 @@
</simpara>
<para>
Le résultat de <function>fileperms</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
</refsect1>
@@ -1003,7 +1053,7 @@
</simpara>
<para>
Le résultat de <function>filesize</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus
+ Reportez-vous à <function>clearstatcache</function> pour plus
de détails.
</para>
</refsect1>
@@ -1037,7 +1087,7 @@
</simpara>
<para>
Le résultat de <function>filetype</function> est mis en cache.
- Reportez vous à <function>clearstatcache</function> pour plus de
+ Reportez-vous à <function>clearstatcache</function> pour plus de
détails.
</para>
</refsect1>
@@ -1051,7 +1101,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>flock</function></funcdef>
+ <funcdef>boolean <function>flock</function></funcdef>
<paramdef>int <parameter>fp</parameter></paramdef>
<paramdef>int <parameter>operation</parameter></paramdef>
</funcprototype>
@@ -1105,10 +1155,10 @@
</simpara>
<warning>
<para>
- Sur la plus part des OS, <function>flock</function> est implémenté
+ Sur la plupart des OS, <function>flock</function> est implémenté
au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread,
comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function>
- pour protéger vos fichiers contre des accès concurents du
+ pour protéger vos fichiers contre des accès concurrents du
même serveur.
</para>
</warning>
@@ -1215,7 +1265,7 @@
n'est utile que sur les systèmes qui font la différence entre
les fichiers binaires et les fichiers textes (en bref, c'est une
fonctionnalité Windows, totalement inutile sous Unix).
- Si il n'est pas nécessaire, il sera ignoré.
+ S'il n'est pas nécessaire, il sera ignoré.
</para>
<para>
Vous pouvez utiliser le troisième paramètre optionnel
@@ -1326,7 +1376,7 @@
<function>fputs</function> est un alias de <function>fwrite</function>,
et lui est identique en tous points. Notez que
<parameter>length</parameter> est un paramètre optionnel,
- et si il n'est pas spécifié, toute la chaîne
+ et s'il n'est pas spécifié, toute la chaîne
est écrite.
</para>
</refsect1>
@@ -1367,7 +1417,7 @@
</para>
<note>
<para>
- Sur les systèmes qui différentient les fichiers
+ Sur les systèmes qui différencient les fichiers
textes et binaires (i.e. Windows) le fichier doit être
ouvert avec la lettre 'b' ajoutée au paramètre
de mode de la fonction <function>fopen</function>.
@@ -1413,7 +1463,7 @@
<paramdef>int <parameter>handle</parameter></paramdef>
<paramdef>string <parameter>format</parameter></paramdef>
<paramdef>string
- <parameter><optional>var1</optional></parameter>...
+ <parameter><optional>var1</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -1424,7 +1474,7 @@
<parameter>handle</parameter> et l'interprète en
fonction du format <parameter>format</parameter>. Si
seulement deux paramètres sont passés
- à la fonction, les valeurs parsées seront
+ à la fonction, les valeurs analysées seront
retournées sous forme de tableau. Si des arguments
optionnels sont passés, la fonction retournera le
nombre de valeurs assignées. Les options doivent
@@ -1447,8 +1497,8 @@
<programlisting role="txt">
janus argonaute gr
rodin sculpteur fr
-som oncle us
-leonard inventeur it
+sam oncle us
+leonard inventeur it
</programlisting>
</example>
</para>
@@ -1508,12 +1558,13 @@
delà de la fin du fichier n'est pas une erreur.
</para>
<para>
- Ne peut pas être utilisé sur les pointeurs
- retournés par <function>fopen</function> s'ils sont
- au format HTTP ou FTP.
+ <function>fseek</function> ne peut pas être utilisé sur les pointeurs
+ retournés par <function>fopen</function> s'ils sont au format HTTP ou FTP.
</para>
<para>
- Voir aussi <function>ftell</function> et <function>rewind</function>.
+ Voir aussi
+ <function>ftell</function> et
+ <function>rewind</function>.
</para>
</refsect1>
</refentry>
@@ -1547,7 +1598,7 @@
<listitem><simpara>4 : nombre de liens </simpara></listitem>
<listitem><simpara>5 : id de l'utilisateur propriétaire
</simpara></listitem>
<listitem><simpara>6 : id du groupe propriétaire</simpara></listitem>
- <listitem><simpara>7 : type du volume de l' inode * </simpara></listitem>
+ <listitem><simpara>7 : type du volume de l'inode * </simpara></listitem>
<listitem><simpara>8 : taille en octets </simpara></listitem>
<listitem><simpara>9 : date du dernier accès </simpara></listitem>
<listitem><simpara>10 : date de la dernière modification
</simpara></listitem>
@@ -1555,8 +1606,8 @@
<listitem><simpara>12 : taille de bloc du système pour les
entrées/sorties(*)</simpara></listitem>
<listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem>
</itemizedlist>
- * - uniquement sur les systèmes qui supporte le type st_blksize
- type les autres systèmes (i.e. Windows) retourne -1.
+ * - uniquement sur les systèmes qui supportent le type st_blksize.
+ Les autres systèmes (i.e. Windows) retournent -1.
</para>
<para>
Les résultats de <function>fstat</function> sont mis en cache.
@@ -1591,8 +1642,11 @@
correctement ouvert par <function>fopen</function> ou <function>popen</function>.
</para>
<para>
- Voir aussi <function>fopen</function>, <function>popen</function>,
- <function>fseek</function> et <function>rewind</function>.
+ Voir aussi
+ <function>fopen</function>,
+ <function>popen</function>,
+ <function>fseek</function> et
+ <function>rewind</function>.
</para>
</refsect1>
</refentry>
@@ -1657,7 +1711,7 @@
n'est utile que sur les systèmes qui font la différence entre
les fichiers binaires et les fichiers textes (en bref, c'est une
fonctionnalité Windows, totalement inutile sous Unix).
- Si il n'est pas nécessaire, il sera ignoré.
+ S'il n'est pas nécessaire, il sera ignoré.
</para>
</note>
<simpara>
@@ -1688,15 +1742,14 @@
</funcsynopsis>
<simpara>
L'écriture de fichier avec <function>fwrite</function> utilise normalement
- un buffer de 8K. Cela signifie que si deux processus essaie d'écrire
+ un buffer de 8K. Cela signifie que si deux processus essaient d'écrire
dans le même fichier, ils font une pause tous les 8ko pour laisser le temps
à l'autre d'écrire à son tour.
<function>set_file_buffer</function> permet de modifier la taille du buffer de
sortie pour le pointeur de fichier <parameter>fp</parameter> à
<parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0,
- l'écriture se fera sans buffer. Cela force l'écriture de toutes
- les données par un processus avant que les autres puisse accéder
- au fichier.
+ l'écriture se fera sans buffer. Cela force un processus à
+écrire
+ toutes ses données dans un fichier avant que les autres puissent y
+accéder.
</simpara>
<simpara>
<function>set_file_buffer</function> retourne 0 en cas de succès, ou
@@ -1722,7 +1775,7 @@
</para>
<simpara>
Voir aussi
- <function>fopen</function>
+ <function>fopen</function> et
<function>fwrite</function>.
</simpara>
</refsect1>
@@ -1736,7 +1789,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_dir</function></funcdef>
+ <funcdef>boolean <function>is_dir</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1770,7 +1823,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_executable</function></funcdef>
+ <funcdef>boolean <function>is_executable</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1807,7 +1860,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_file</function></funcdef>
+ <funcdef>boolean <function>is_file</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1845,7 +1898,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_link</function></funcdef>
+ <funcdef>boolean <function>is_link</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1885,7 +1938,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_readable</function></funcdef>
+ <funcdef>boolean <function>is_readable</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1924,7 +1977,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_writable</function></funcdef>
+ <funcdef>boolean <function>is_writable</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1963,7 +2016,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_writeable</function></funcdef>
+ <funcdef>boolean <function>is_writeable</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -1984,7 +2037,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>is_uploaded_file</function></funcdef>
+ <funcdef>boolean <function>is_uploaded_file</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -2000,13 +2053,15 @@
un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>).
</para>
<para>
- Ce type de vérification est spécialement important si il est
+ Ce type de vérification est spécialement important s'il est
possible que les fichiers téléchargés
révélent leur contenu à l'utilisateur, ou
même aux utilisateurs du même système.
</para>
<para>
- Voir aussi <function>move_uploaded_file</function>, et la section
+ Voir aussi
+ <function>move_uploaded_file</function>, et
+ la section
<link linkend="features.file-upload">Chargement de fichier</link>
pour un exemple simple.
</para>
@@ -2030,8 +2085,10 @@
<function>link</function> crée un lien.
</para>
<para>
- Voir aussi <function>symlink</function> pour créer des liens
- symboliques et <function>readlink</function> avec <function>linkinfo</function>.
+ Voir aussi
+ <function>symlink</function> pour créer des liens
+ symboliques et
+ <function>readlink</function> avec <function>linkinfo</function>.
</para>
<note>
<simpara>
@@ -2055,7 +2112,7 @@
</funcsynopsis>
<para>
<function>linkinfo</function> renvoie les informations à propos
- d'un lien le champs st_dev de la structure d'information d' UNIX
+ d'un lien, c'est-à-dire le champs st_dev de la structure d'information UNIX
(comme en langage C). <function>linkinfo</function> sert à vérifier
si un lien (repéré par <parameter>path</parameter>)
existe (en utilisant la même méthode que la macro
@@ -2063,8 +2120,10 @@
<literal>FALSE</literal> en cas d'erreur.
</para>
<para>
- Voir aussi <function>symlink</function>, <function>link</function>,
- et <function>readlink</function>.
+ Voir aussi
+ <function>symlink</function>,
+ <function>link</function> et
+ <function>readlink</function>.
</para>
<note>
<simpara>
@@ -2107,7 +2166,8 @@
succès, et <literal>FALSE</literal> en cas d'échec.
</para>
<para>
- Voir aussi <function>rmdir</function>.
+ Voir aussi
+ <function>rmdir</function>.
</para>
</refsect1>
</refentry>
@@ -2120,7 +2180,7 @@
<title>Description</title>
<funcsynopsis>
<funcprototype>
- <funcdef>bool <function>move_uploaded_file</function></funcdef>
+ <funcdef>boolean <function>move_uploaded_file</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
<paramdef>string <parameter>destination</parameter></paramdef>
</funcprototype>
@@ -2149,12 +2209,13 @@
<para>
Ce type de vérification est spécialement important s'il
est possible que les fichiers téléchargés
- révélent leur contenu à l'utilisateur,
+ révèlent leur contenu à l'utilisateur,
ou même aux utilisateurs du même système.
</para>
<para>
- Voir aussi <function>move_uploaded_file</function>, et la section
- <link linkend="features.file-upload">Chargement de fichier</link>
+ Voir aussi
+ <function>move_uploaded_file</function> et
+ la section <link linkend="features.file-upload">Chargement de fichier</link>
pour un exemple simple.
</para>
</refsect1>
@@ -2236,7 +2297,8 @@
exécuté.
</para>
<para>
- Voir aussi <function>popen</function>.
+ Voir aussi
+ <function>popen</function>.
</para>
</refsect1>
</refentry>
@@ -2261,7 +2323,7 @@
<para>
<function>popen</function> retourne un pointeur de fichier
identique à celui retourné par <function>fopen</function>,
- hormis le fait qu'il sera unidirectionel (lecture seule, ou
+ hormis le fait qu'il sera unidirectionnel (lecture seule, ou
écriture seule), et doit être terminé par
<function>pclose</function>. Ce pointeur peut être utilisé
avec <function>fgets</function>, <function>fgetss</function> et
@@ -2280,7 +2342,8 @@
</informalexample>
</para>
<para>
- Voir aussi <function>pclose</function>.
+ Voir aussi
+ <function>pclose</function>.
</para>
</refsect1>
</refentry>
@@ -2304,7 +2367,7 @@
</funcsynopsis>
<para>
<function>readfile</function> lit le fichier <parameter>filename</parameter> et
- l'envoi à la sortie standard.
+ l'envoit à la sortie standard.
</para>
<para>
<function>readfile</function> retourne le nombre d'octets lus depuis le fichier.
@@ -2338,10 +2401,13 @@
en passant la valeur de 1.
</para>
<para>
- Voir aussi <function>fpassthru</function>,
- <function>file</function>, <function>fopen</function>,
+ Voir aussi
+ <function>fpassthru</function>,
+ <function>file</function>,
+ <function>fopen</function>,
<function>include</function>,
- <function>require</function>, et <function>virtual</function>.
+ <function>require</function> et
+ <function>virtual</function>.
</para>
</refsect1>
</refentry>
@@ -2367,7 +2433,9 @@
ou <literal>FALSE</literal> en cas d'erreur.
</para>
<para>
- Voir aussi <function>symlink</function>, <function>readlink</function> et
+ Voir aussi
+ <function>symlink</function>,
+ <function>readlink</function> et
<function>linkinfo</function>.
</para>
<note>
@@ -2426,7 +2494,8 @@
correctement ouvert par <function>fopen</function>.
</para>
<para>
- Voir aussi <function>fseek</function> et
+ Voir aussi
+ <function>fseek</function> et
<function>ftell</function>.
</para>
</refsect1>
@@ -2453,7 +2522,8 @@
Si une erreur survient, <function>rmdir</function> retourne
<literal>FALSE</literal>.
</para>
<para>
- Voir aussi <function>mkdir</function>.
+ Voir aussi
+ <function>mkdir</function>.
</para>
</refsect1>
</refentry>
@@ -2488,7 +2558,7 @@
<listitem><simpara>3 : nombre de liens </simpara></listitem>
<listitem><simpara>4 : id de l'utilisateur propriétaire
</simpara></listitem>
<listitem><simpara>5 : id du groupe propriétaire</simpara></listitem>
- <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem>
+ <listitem><simpara>6 : type du volume de l'inode * </simpara></listitem>
<listitem><simpara>7 : taille en octets </simpara></listitem>
<listitem><simpara>8 : date du dernier accès </simpara></listitem>
<listitem><simpara>9 : date de la dernière modification
</simpara></listitem>
@@ -2496,8 +2566,15 @@
<listitem><simpara>11 : taille de bloc du système pour les
entrées/sorties * </simpara></listitem>
<listitem><simpara>12 : nombre de blocs alloués</simpara></listitem>
</itemizedlist>
- * - uniquement sur les systèmes qui supporte le type st_blksize type
- les autres systèmes (i.e. Windows) retourne -1.
+ * - uniquement sur les systèmes qui supportent le type st_blksize.
+ Les autres systèmes (i.e. Windows) retournent -1.
+ </para>
+ <para>
+ <function>stat</function> retourne <literal>FALSE</literal> en cas d'erreur.
+ </para>
+ <para>
+ <function>stat</function> ne gère pas les URL comme peut le
+ faire <function>fopen</function>.
</para>
<para>
Les résultats de <function>stat</function> sont mis en cache.
@@ -2539,7 +2616,7 @@
<listitem><simpara>3 : nombre de liens </simpara></listitem>
<listitem><simpara>4 : id de l'utilisateur propriétaire
</simpara></listitem>
<listitem><simpara>5 : id du groupe propriétaire</simpara></listitem>
- <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem>
+ <listitem><simpara>6 : type du volume de l'inode * </simpara></listitem>
<listitem><simpara>7 : taille en octets </simpara></listitem>
<listitem><simpara>8 : date du dernier accès </simpara></listitem>
<listitem><simpara>9 : date de la dernière modification
</simpara></listitem>
@@ -2547,12 +2624,12 @@
<listitem><simpara>11 : taille de bloc du système pour les
entrées/sorties * </simpara></listitem>
<listitem><simpara>12 : nombre de blocs alloués</simpara></listitem>
</itemizedlist>
- * - uniquement sur les systèmes qui supporte le type st_blksize type
- les autres systèmes (i.e. Windows) retourne -1.
+ * - uniquement sur les systèmes qui supportent le type st_blksize.
+ Les autres systèmes (i.e. Windows) retournent -1.
</para>
<para>
Les résultats de <function>lstat</function> sont mis en cache.
- Reportez vous à la fonction <function>clearstatcache</function>
+ Reportez-vous à la fonction <function>clearstatcache</function>
pour plus de détails.
</para>
</refsect1>
@@ -2608,8 +2685,9 @@
<parameter>target</parameter> avec le nom de <parameter>link</parameter>.
</para>
<para>
- Voir aussi <function>link</function> pour créer des liens durs,
- et <function>readlink</function> ainsi que <function>linkinfo</function>.
+ Voir aussi
+ <function>link</function> pour créer des liens durs et
+ <function>readlink</function> ainsi que <function>linkinfo</function>.
</para>
<note>
<simpara>
@@ -2635,7 +2713,7 @@
<para>
<function>tempnam</function> crée un fichier temporaire unique
dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas,
- <function>tempnam</function> va génèrer un nom de fichier
+ <function>tempnam</function> va générer un nom de fichier
dans le dossier temporaire du système.
</para>
<para>
@@ -2677,11 +2755,11 @@
<para>
<function>tmpfile</function> crée un fichier temporaire
avec un nom unique, ouvert en écriture, et retourne un
- pointeur de fichier, identique à ceux retourné par
+ pointeur de fichier, identique à ceux retournés par
<function>fopen</function>.
Ce fichier sera automatiquement effacé lorsqu'il sera
- fermé (avec <function>fclose</function>), ou lorsque le fichier
- sera termniné.
+ fermé (avec <function>fclose</function>), ou lorsque le script
+ sera terminé.
</para>
<para>
Pour plus de détails, consultez votre documentation système
@@ -2689,7 +2767,8 @@
<filename>stdio.h</filename>.
</para>
<para>
- Voir aussi <function>tempnam</function>.
+ Voir aussi
+ <function>tempnam</function>.
</para>
</refsect1>
</refentry>
@@ -2716,7 +2795,7 @@
c'est l'heure courante qui est utilisée.
</para>
<para>
- Si le fichier n'existe pas, il est crée.
+ Si le fichier n'existe pas, il est créé.
</para>
<para>
<function>touch</function> retourne <literal>TRUE</literal> en cas de
succès,
@@ -2776,15 +2855,16 @@
Identique à la fonction Unix C unlink().
</para>
<para>
- <function>unlink</function> retourne <literal>FALSE</literal> en cas
d'échec.
+ <function>unlink</function> retourne <literal>FALSE</literal> en cas
+ d'échec.
</para>
<para>
- Voir aussi
+ Voir aussi
<function>rmdir</function> pour supprimer des dossiers.
</para>
<note>
<simpara>
- <function>unlink</function> peut ne pas fonctionner sous Windows.
+ <function>unlink</function> ne fonctionne pas sous Windows.
</simpara>
</note>
</refsect1>