cvs: phpdoc /fr/functions filesystem.xml
| From: | Damien Seguy | Date: | Mon, 02 Jul 2001 10:24:28 +0000 |
| Subject: | cvs: phpdoc /fr/functions filesystem.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969335802@lists.php.net to get a copy of this message | ||
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>
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>