cvs: phpdoc /fr/functions filesystem.xml
| From: | Damien Seguy | Date: | Mon, 23 Jul 2001 16:48:28 +0000 |
| Subject: | cvs: phpdoc /fr/functions filesystem.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336457@lists.php.net to get a copy of this message | ||
dams Mon Jul 23 12:48:28 2001 EDT
Modified files:
/phpdoc/fr/functions filesystem.xml
Log:
Updating for building
Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.24 phpdoc/fr/functions/filesystem.xml:1.25 --- phpdoc/fr/functions/filesystem.xml:1.24 Sat Jul 7 18:22:08 2001 +++ phpdoc/fr/functions/filesystem.xml Mon Jul 23 12:48:28 2001 @@ -31,8 +31,9 @@ <title>Exemple avec <function>basename</function></title> <programlisting role="php"> <?php -$path = "/home/httpd/html/index.php3"; -$file = basename($path); // $file est affecté avec "index.php3" + $path = "/home/httpd/html/index.php3"; + $file = basename($path); + // $file est affecté avec "index.php3" ?> </programlisting> </example> @@ -107,9 +108,9 @@ <informalexample> <programlisting role="php"> <?php -chmod( "/somedir/somefile", 755 ); + chmod( "/somedir/somefile", 755 ); // notation décimale; probablement <literal>FALSE</literal> -chmod( "/somedir/somefile", 0755 ); + chmod( "/somedir/somefile", 0755 ); // notation octale; valeur du mode correcte ?> </programlisting> @@ -306,8 +307,8 @@ <title>Exemple avec <function>dirname</function></title> <programlisting role="php"> <?php -$path = "/etc/passwd"; -$file = dirname($path); // $file contient "/etc" + $path = "/etc/passwd"; + $file = dirname($path); // $file contient "/etc" ?> </programlisting> </example> @@ -342,7 +343,8 @@ <title>Exemple avec <function>diskfreespace</function></title> <programlisting role="php"> <?php -$df = diskfreespace("/"); // $df contient le nombre d'octets libres sur "/" + $df = diskfreespace("/"); + // $df contient le nombre d'octets libres sur "/" ?> </programlisting> </example> @@ -373,7 +375,7 @@ <title>Exemple avec <function>disk_total_space</function></title> <programlisting role="php"> <?php -$df = disk_total_space("/"); // $df contient le nombre d'octets libres + $df = disk_total_space("/"); // $df contient le nombre d'octets libres // dans le dossier "/" ?> </programlisting> @@ -552,17 +554,17 @@ </title> <programlisting role="php"> <?php -$row = 1; -$fp = fopen ("test.csv","r"); -while ($data = fgetcsv ($fp, 1000, ",")) { + $row = 1; + $fp = fopen ("test.csv","r"); + while ($data = fgetcsv ($fp, 1000, ",")) { $num = count ($data); print "<p> $num champs dans la ligne $row: <br>"; $row++; for ($c=0; $c<$num; $c++) { print $data[$c] . "<br>"; } -} -fclose ($fp); + } + fclose ($fp); ?> </programlisting> </example> @@ -612,12 +614,12 @@ <title>Lecture d'un fichier ligne par ligne</title> <programlisting role="php"> <?php -$fd = fopen ("/tmp/inputfile.txt", "r"); -while (!feof($fd)) { + $fd = fopen ("/tmp/inputfile.txt", "r"); + while (!feof($fd)) { $buffer = fgets($fd, 4096); echo $buffer; -} -fclose ($fd); + } + fclose ($fd); ?> </programlisting> </example> @@ -713,12 +715,12 @@ <programlisting role="php"> <?php // Lire une page web dans un tableau, et l'afficher -$fcontents = file( 'http://www.php.net' ); -while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { + $fcontents = file( 'http://www.php.net' ); + while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { echo "<B>Ligne $numero_ligne:</B> ".htmlspecialchars( $ligne ) . "<br>\n"; -} + } // lire une page web dans une chaîne -$fcontents = join( '', file( 'http://www.php.net' ) ); + $fcontents = join( '', file( 'http://www.php.net' ) ); ?> </programlisting> </informalexample> @@ -949,19 +951,17 @@ du serveur. </simpara> <para> - <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> <refentry id="function.fileowner"> <refnamediv> <refname>fileowner</refname> - <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> + <refpurpose>Renvoie le nom du propriétaire du fichier.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1187,11 +1187,18 @@ Si <parameter>filename</parameter> commence par "http://" (insensible à la casse), une connexion HTTP 1.x est ouverte avec le serveur spécifié, et un pointeur sur la réponse fournie est - retourné. + retourné. Une en-tête '<literal>Host:</literal>' est envoyé avec la + requête, afin de gérer les virtual hosts basés sur les noms. + </simpara> + <simpara> + Notez que le pointeur de fichier retourné représente le corps de la + réponse, et qu'il n'est pas possible d'accéder aux en-têtes HTTP + avec cette fonction. </simpara> <simpara> - Attention, <function>fopen</function> ne gère pas les redirections, - ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. + Les versions antérieures à PHP 4.0.6, ne gère pas les + redirections automatiques, ce qui oblige à ajouter les slash finaux + "/" pour indiquer un dossier. </simpara> <simpara> Si <parameter>filename</parameter> commence par "ftp://" (insensible à @@ -1277,9 +1284,9 @@ <title>Exemple avec <function>fopen</function></title> <programlisting role="php"> <?php -$fp = fopen("/home/rasmus/file.txt", "r"); -$fp = fopen("http://www.php.net/", "r"); -$fp = fopen("ftp://user:password@example.com/", "w"); + $fp = fopen("/home/rasmus/file.txt", "r"); + $fp = fopen("http://www.php.net/", "r"); + $fp = fopen("ftp://user:password@example.com/", "w"); ?> </programlisting> </example> @@ -1296,7 +1303,7 @@ <informalexample> <programlisting role="php"> <?php -$fp = fopen("c:\\data\\info.txt", "r"); + $fp = fopen("c:\\data\\info.txt", "r"); ?> </programlisting> </informalexample> @@ -1407,10 +1414,10 @@ <programlisting role="php"> <?php // Lit un fichier, et le place dans une chaîne -$filename = "/usr/local/quelquechose.txt"; -$fd = fopen($filename, "r"); -$contents = fread($fd, filesize ($filename)); -fclose($fd); + $filename = "/usr/local/quelquechose.txt"; + $fd = fopen($filename, "r"); + $contents = fread($fd, filesize ($filename)); + fclose($fd); ?> </programlisting> </informalexample> @@ -1428,10 +1435,10 @@ <informalexample> <programlisting role="php"> <?php -$filename = "c:\\fichiers\\uneimage.gif"; -$fd = fopen($filename, "rb"); -$contents = fread($fd, filesize ($filename)); -fclose($fd); + $filename = "c:\\fichiers\\uneimage.gif"; + $fd = fopen($filename, "rb"); + $contents = fread($fd, filesize ($filename)); + fclose($fd); ?> </programlisting> </informalexample> @@ -1483,12 +1490,12 @@ <title>Exemple <function>fscanf</function></title> <programlisting role="php"> <?php -$fp = fopen ("users.txt","r"); -while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { + $fp = fopen ("users.txt","r"); + while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; //... traitement des données -} -fclose($fp); + } + fclose($fp); ?> </programlisting> </example> @@ -1763,12 +1770,12 @@ <title>Exemple avec <function>set_file_buffer</function></title> <programlisting role="php"> <?php -$fp=fopen($file, "w"); -if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); -} + $fp=fopen($file, "w"); + if($fp){ + set_file_buffer($fp, 0); + fputs($fp, $output); + fclose($fp); + } ?> </programlisting> </example> @@ -2152,11 +2159,13 @@ </para> <para> Notez que vous aurez à préciser le mode en base octale, - ce qui signifie que vous aurez probablement un 0 comme premier chiffre : + ce qui signifie que vous aurez probablement un 0 comme premier chiffre. + Le mode sera aussi modifié par le umask courant, que vous pouvez + modifier avec la fonction <function>umask</function>. <informalexample> <programlisting role="php"> <?php -mkdir ("/chemin/de/mon/dossier", 0700); + mkdir ("/chemin/de/mon/dossier", 0700); ?> </programlisting> </informalexample> @@ -2245,10 +2254,10 @@ <title>Exemple avec <function>pathinfo</function></title> <programlisting role="php"> <?php -$path_parts = pathinfo("/www/htdocs/index.html"); -echo $path_parts["dirname"] . "\n"; -echo $path_parts["basename"] . "\n"; -echo $path_parts["extension"] . "\n"; + $path_parts = pathinfo("/www/htdocs/index.html"); + echo $path_parts["dirname"] . "\n"; + echo $path_parts["basename"] . "\n"; + echo $path_parts["extension"] . "\n"; ?> </programlisting> </example> @@ -2336,7 +2345,7 @@ <informalexample> <programlisting role="php"> <?php -$fp = popen ("/bin/ls", "r"); + $fp = popen("/bin/ls", "r"); ?> </programlisting> </informalexample> @@ -2379,10 +2388,10 @@ spécifié, et le texte de la réponse sera affiché sur la sortie standard. </para> - <para> - ATTENTION : PHP ne gère pas les redirections, donc il faut penser - à ajouter un "/" final pour les dossiers. - </para> + <simpara> + Les versions antérieures à PHP 4.0.6, ne gère pas les redirections automatiques, + ce qui oblige à ajouter les slash finaux "/" pour indiquer un dossier. + </simpara> <para> Si <parameter>filename</parameter> commence par "ftp://" (insensible à la casse), une connexion FTP est ouverte avec l'hôte @@ -2659,7 +2668,7 @@ <title>Exemple <function>realpath</function></title> <programlisting role="php"> <?php -$real_path = realpath ("../../index.php"); + $real_path = realpath("../../index.php"); ?> </programlisting> </example> @@ -2717,13 +2726,13 @@ dans le dossier temporaire du système. </para> <para> - Le comportement de <function>tempnam</function> dépend du - système. Sous Windows, la variable d'environnement TMP sera - prioritaire par rapport au paramètre <parameter>dir</parameter>; - sous Linux la variable d'environnement TMPDIR aura la priorité, - tandis que l'OS SVR4 utilisera toujours le paramètre - <parameter>dir</parameter> si le dossier n'existe pas. Reportez - vous à la documentation de votre système(tempnam(3)). + Avant PHP 4.0.6, le comportement de <function>tempnam</function> dépendait + de l'OS sous-jacent. Sous Windows, la variable d'environnement + TMP remplace le paramètre <parameter>dir</parameter>; sous Linux, la + variable d'environnement TMPDIR a la priorité, tandis que pour les + OS en système V R4, le paramètre <parameter>dir</parameter> sera toujours + utilisé, si le dossier qu'il représente existe. Consultez votre + documentation pour plus de détails. </para> <para> <function>tempnam</function> retourne le nom du fichier temporaire, ou @@ -2732,7 +2741,7 @@ <title>Exemple avec <function>tempnam</function></title> <programlisting role="php"> <?php -$tmpfname = tempnam ("/tmp", "FOO"); + $tmpfname = tempnam("/tmp", "FOO"); ?> </programlisting> </example>
Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.24 phpdoc/fr/functions/filesystem.xml:1.25 --- phpdoc/fr/functions/filesystem.xml:1.24 Sat Jul 7 18:22:08 2001 +++ phpdoc/fr/functions/filesystem.xml Mon Jul 23 12:48:28 2001 @@ -31,8 +31,9 @@ <title>Exemple avec <function>basename</function></title> <programlisting role="php"> <?php -$path = "/home/httpd/html/index.php3"; -$file = basename($path); // $file est affecté avec "index.php3" + $path = "/home/httpd/html/index.php3"; + $file = basename($path); + // $file est affecté avec "index.php3" ?> </programlisting> </example> @@ -107,9 +108,9 @@ <informalexample> <programlisting role="php"> <?php -chmod( "/somedir/somefile", 755 ); + chmod( "/somedir/somefile", 755 ); // notation décimale; probablement <literal>FALSE</literal> -chmod( "/somedir/somefile", 0755 ); + chmod( "/somedir/somefile", 0755 ); // notation octale; valeur du mode correcte ?> </programlisting> @@ -306,8 +307,8 @@ <title>Exemple avec <function>dirname</function></title> <programlisting role="php"> <?php -$path = "/etc/passwd"; -$file = dirname($path); // $file contient "/etc" + $path = "/etc/passwd"; + $file = dirname($path); // $file contient "/etc" ?> </programlisting> </example> @@ -342,7 +343,8 @@ <title>Exemple avec <function>diskfreespace</function></title> <programlisting role="php"> <?php -$df = diskfreespace("/"); // $df contient le nombre d'octets libres sur "/" + $df = diskfreespace("/"); + // $df contient le nombre d'octets libres sur "/" ?> </programlisting> </example> @@ -373,7 +375,7 @@ <title>Exemple avec <function>disk_total_space</function></title> <programlisting role="php"> <?php -$df = disk_total_space("/"); // $df contient le nombre d'octets libres + $df = disk_total_space("/"); // $df contient le nombre d'octets libres // dans le dossier "/" ?> </programlisting> @@ -552,17 +554,17 @@ </title> <programlisting role="php"> <?php -$row = 1; -$fp = fopen ("test.csv","r"); -while ($data = fgetcsv ($fp, 1000, ",")) { + $row = 1; + $fp = fopen ("test.csv","r"); + while ($data = fgetcsv ($fp, 1000, ",")) { $num = count ($data); print "<p> $num champs dans la ligne $row: <br>"; $row++; for ($c=0; $c<$num; $c++) { print $data[$c] . "<br>"; } -} -fclose ($fp); + } + fclose ($fp); ?> </programlisting> </example> @@ -612,12 +614,12 @@ <title>Lecture d'un fichier ligne par ligne</title> <programlisting role="php"> <?php -$fd = fopen ("/tmp/inputfile.txt", "r"); -while (!feof($fd)) { + $fd = fopen ("/tmp/inputfile.txt", "r"); + while (!feof($fd)) { $buffer = fgets($fd, 4096); echo $buffer; -} -fclose ($fd); + } + fclose ($fd); ?> </programlisting> </example> @@ -713,12 +715,12 @@ <programlisting role="php"> <?php // Lire une page web dans un tableau, et l'afficher -$fcontents = file( 'http://www.php.net' ); -while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { + $fcontents = file( 'http://www.php.net' ); + while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { echo "<B>Ligne $numero_ligne:</B> ".htmlspecialchars( $ligne ) . "<br>\n"; -} + } // lire une page web dans une chaîne -$fcontents = join( '', file( 'http://www.php.net' ) ); + $fcontents = join( '', file( 'http://www.php.net' ) ); ?> </programlisting> </informalexample> @@ -949,19 +951,17 @@ du serveur. </simpara> <para> - <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> <refentry id="function.fileowner"> <refnamediv> <refname>fileowner</refname> - <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> + <refpurpose>Renvoie le nom du propriétaire du fichier.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1187,11 +1187,18 @@ Si <parameter>filename</parameter> commence par "http://" (insensible à la casse), une connexion HTTP 1.x est ouverte avec le serveur spécifié, et un pointeur sur la réponse fournie est - retourné. + retourné. Une en-tête '<literal>Host:</literal>' est envoyé avec la + requête, afin de gérer les virtual hosts basés sur les noms. + </simpara> + <simpara> + Notez que le pointeur de fichier retourné représente le corps de la + réponse, et qu'il n'est pas possible d'accéder aux en-têtes HTTP + avec cette fonction. </simpara> <simpara> - Attention, <function>fopen</function> ne gère pas les redirections, - ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. + Les versions antérieures à PHP 4.0.6, ne gère pas les + redirections automatiques, ce qui oblige à ajouter les slash finaux + "/" pour indiquer un dossier. </simpara> <simpara> Si <parameter>filename</parameter> commence par "ftp://" (insensible à @@ -1277,9 +1284,9 @@ <title>Exemple avec <function>fopen</function></title> <programlisting role="php"> <?php -$fp = fopen("/home/rasmus/file.txt", "r"); -$fp = fopen("http://www.php.net/", "r"); -$fp = fopen("ftp://user:password@example.com/", "w"); + $fp = fopen("/home/rasmus/file.txt", "r"); + $fp = fopen("http://www.php.net/", "r"); + $fp = fopen("ftp://user:password@example.com/", "w"); ?> </programlisting> </example> @@ -1296,7 +1303,7 @@ <informalexample> <programlisting role="php"> <?php -$fp = fopen("c:\\data\\info.txt", "r"); + $fp = fopen("c:\\data\\info.txt", "r"); ?> </programlisting> </informalexample> @@ -1407,10 +1414,10 @@ <programlisting role="php"> <?php // Lit un fichier, et le place dans une chaîne -$filename = "/usr/local/quelquechose.txt"; -$fd = fopen($filename, "r"); -$contents = fread($fd, filesize ($filename)); -fclose($fd); + $filename = "/usr/local/quelquechose.txt"; + $fd = fopen($filename, "r"); + $contents = fread($fd, filesize ($filename)); + fclose($fd); ?> </programlisting> </informalexample> @@ -1428,10 +1435,10 @@ <informalexample> <programlisting role="php"> <?php -$filename = "c:\\fichiers\\uneimage.gif"; -$fd = fopen($filename, "rb"); -$contents = fread($fd, filesize ($filename)); -fclose($fd); + $filename = "c:\\fichiers\\uneimage.gif"; + $fd = fopen($filename, "rb"); + $contents = fread($fd, filesize ($filename)); + fclose($fd); ?> </programlisting> </informalexample> @@ -1483,12 +1490,12 @@ <title>Exemple <function>fscanf</function></title> <programlisting role="php"> <?php -$fp = fopen ("users.txt","r"); -while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { + $fp = fopen ("users.txt","r"); + while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; //... traitement des données -} -fclose($fp); + } + fclose($fp); ?> </programlisting> </example> @@ -1763,12 +1770,12 @@ <title>Exemple avec <function>set_file_buffer</function></title> <programlisting role="php"> <?php -$fp=fopen($file, "w"); -if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); -} + $fp=fopen($file, "w"); + if($fp){ + set_file_buffer($fp, 0); + fputs($fp, $output); + fclose($fp); + } ?> </programlisting> </example> @@ -2152,11 +2159,13 @@ </para> <para> Notez que vous aurez à préciser le mode en base octale, - ce qui signifie que vous aurez probablement un 0 comme premier chiffre : + ce qui signifie que vous aurez probablement un 0 comme premier chiffre. + Le mode sera aussi modifié par le umask courant, que vous pouvez + modifier avec la fonction <function>umask</function>. <informalexample> <programlisting role="php"> <?php -mkdir ("/chemin/de/mon/dossier", 0700); + mkdir ("/chemin/de/mon/dossier", 0700); ?> </programlisting> </informalexample> @@ -2245,10 +2254,10 @@ <title>Exemple avec <function>pathinfo</function></title> <programlisting role="php"> <?php -$path_parts = pathinfo("/www/htdocs/index.html"); -echo $path_parts["dirname"] . "\n"; -echo $path_parts["basename"] . "\n"; -echo $path_parts["extension"] . "\n"; + $path_parts = pathinfo("/www/htdocs/index.html"); + echo $path_parts["dirname"] . "\n"; + echo $path_parts["basename"] . "\n"; + echo $path_parts["extension"] . "\n"; ?> </programlisting> </example> @@ -2336,7 +2345,7 @@ <informalexample> <programlisting role="php"> <?php -$fp = popen ("/bin/ls", "r"); + $fp = popen("/bin/ls", "r"); ?> </programlisting> </informalexample> @@ -2379,10 +2388,10 @@ spécifié, et le texte de la réponse sera affiché sur la sortie standard. </para> - <para> - ATTENTION : PHP ne gère pas les redirections, donc il faut penser - à ajouter un "/" final pour les dossiers. - </para> + <simpara> + Les versions antérieures à PHP 4.0.6, ne gère pas les redirections automatiques, + ce qui oblige à ajouter les slash finaux "/" pour indiquer un dossier. + </simpara> <para> Si <parameter>filename</parameter> commence par "ftp://" (insensible à la casse), une connexion FTP est ouverte avec l'hôte @@ -2659,7 +2668,7 @@ <title>Exemple <function>realpath</function></title> <programlisting role="php"> <?php -$real_path = realpath ("../../index.php"); + $real_path = realpath("../../index.php"); ?> </programlisting> </example> @@ -2717,13 +2726,13 @@ dans le dossier temporaire du système. </para> <para> - Le comportement de <function>tempnam</function> dépend du - système. Sous Windows, la variable d'environnement TMP sera - prioritaire par rapport au paramètre <parameter>dir</parameter>; - sous Linux la variable d'environnement TMPDIR aura la priorité, - tandis que l'OS SVR4 utilisera toujours le paramètre - <parameter>dir</parameter> si le dossier n'existe pas. Reportez - vous à la documentation de votre système(tempnam(3)). + Avant PHP 4.0.6, le comportement de <function>tempnam</function> dépendait + de l'OS sous-jacent. Sous Windows, la variable d'environnement + TMP remplace le paramètre <parameter>dir</parameter>; sous Linux, la + variable d'environnement TMPDIR a la priorité, tandis que pour les + OS en système V R4, le paramètre <parameter>dir</parameter> sera toujours + utilisé, si le dossier qu'il représente existe. Consultez votre + documentation pour plus de détails. </para> <para> <function>tempnam</function> retourne le nom du fichier temporaire, ou @@ -2732,7 +2741,7 @@ <title>Exemple avec <function>tempnam</function></title> <programlisting role="php"> <?php -$tmpfname = tempnam ("/tmp", "FOO"); + $tmpfname = tempnam("/tmp", "FOO"); ?> </programlisting> </example>