[PHP-DOC] cvs: phpdoc /fr/functions filesystem.xml

[Damien Seguy]

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">
 &lt;?php
-$path = "/home/httpd/html/index.php3";
-$file = basename($path); // $file est affect&eacute; avec "index.php3"
+  $path = "/home/httpd/html/index.php3";
+  $file = basename($path);
+  // $file est affect&eacute; avec "index.php3"
 ?&gt;
      </programlisting>
     </example>
@@ -107,9 +108,9 @@
     <informalexample>
      <programlisting role="php">
 &lt;?php
-chmod( "/somedir/somefile", 755 );
+  chmod( "/somedir/somefile", 755 );
 // notation d&eacute;cimale; probablement <literal>FALSE</literal>
-chmod( "/somedir/somefile", 0755 );
+  chmod( "/somedir/somefile", 0755 );
 // notation octale; valeur du mode correcte
 ?&gt;
      </programlisting>
@@ -306,8 +307,8 @@
      <title>Exemple avec <function>dirname</function></title>
      <programlisting role="php">
 &lt;?php
-$path = "/etc/passwd";
-$file = dirname($path); // $file contient "/etc"
+  $path = "/etc/passwd";
+  $file = dirname($path); // $file contient "/etc"
 ?&gt;
      </programlisting>
     </example>
@@ -342,7 +343,8 @@
      <title>Exemple avec <function>diskfreespace</function></title>
      <programlisting role="php">
 &lt;?php
-$df = diskfreespace("/"); // $df contient le nombre d'octets libres sur "/"
+  $df = diskfreespace("/");
+  // $df contient le nombre d'octets libres sur "/"
 ?&gt;
      </programlisting>
     </example>
@@ -373,7 +375,7 @@
      <title>Exemple avec <function>disk_total_space</function></title>
      <programlisting role="php">
 &lt;?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 "/"
 ?&gt;
      </programlisting>
@@ -552,17 +554,17 @@
     </title>
     <programlisting role="php">
 &lt;?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 "&lt;p> $num champs dans la ligne $row: &lt;br&gt;";
     $row++;
     for ($c=0; $c<$num; $c++) {
         print $data[$c] . "&lt;br&gt;";
     }
-}
-fclose ($fp);
+  }
+  fclose ($fp);
 ?&gt;
     </programlisting>
    </example>
@@ -612,12 +614,12 @@
      <title>Lecture d'un fichier ligne par ligne</title>
      <programlisting role="php">
 &lt;?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);
 ?&gt;
      </programlisting>
     </example>
@@ -713,12 +715,12 @@
      <programlisting role="php">
 &lt;?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 "&lt;B&gt;Ligne $numero_ligne:&lt;/B&gt; ".htmlspecialchars( $ligne ) . 
"&lt;br&gt;\n";
-}
+  }
 // lire une page web dans une cha&icirc;ne
-$fcontents = join( '', file( 'http://www.php.net' ) );
+  $fcontents = join( '', file( 'http://www.php.net' ) );
 ?&gt;
      </programlisting>
     </informalexample>
@@ -949,19 +951,17 @@
     du serveur.
    </simpara>
    <para>
-    <note>
     <function>filemtime</function> retourne l'heure d'&eacute;criture
     des blocs donn&eacute;es d'un fichier. Utilisez <function>date</function>
     sur ce r&eacute;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&eacute;taire du fichier.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
@@ -1187,11 +1187,18 @@
     Si <parameter>filename</parameter> commence par "http://"; (insensible &agrave;
     la casse), une connexion HTTP 1.x est ouverte avec le serveur
     sp&eacute;cifi&eacute;, et un pointeur sur la r&eacute;ponse fournie est
-    retourn&eacute;.
+    retourn&eacute;. Une en-t&ecirc;te '<literal>Host:</literal>' est envoy&eacute; 
+avec la
+    requ&ecirc;te, afin de g&eacute;rer les virtual hosts bas&eacute;s sur les noms.
+    </simpara>
+    <simpara>
+     Notez que le pointeur de fichier retourn&eacute; repr&eacute;sente le corps de la
+     r&eacute;ponse, et qu'il n'est pas possible d'acc&eacute;der aux en-t&ecirc;tes 
+HTTP
+     avec cette fonction.
    </simpara>
    <simpara>
-    Attention, <function>fopen</function> ne g&egrave;re pas les redirections,
-    ce qui oblige &agrave; ajouter les slash " / " finaux pour indiquer un dossier.
+    Les versions ant&eacute;rieures &agrave; PHP 4.0.6, ne g&egrave;re pas les
+    redirections automatiques, ce qui oblige &agrave; ajouter les slash finaux
+    "/" pour indiquer un dossier.
    </simpara>
    <simpara>
     Si <parameter>filename</parameter> commence par "ftp://"; (insensible &agrave;
@@ -1277,9 +1284,9 @@
      <title>Exemple avec <function>fopen</function></title>
      <programlisting role="php">
 &lt;?php
-$fp = fopen("/home/rasmus/file.txt", "r");
-$fp = fopen("http://www.php.net/";, "r");
-$fp = fopen("ftp://user:password&#64;example.com/";, "w");
+  $fp = fopen("/home/rasmus/file.txt", "r");
+  $fp = fopen("http://www.php.net/";, "r");
+  $fp = fopen("ftp://user:password&#64;example.com/";, "w");
 ?&gt;
      </programlisting>
     </example>
@@ -1296,7 +1303,7 @@
     <informalexample>
      <programlisting role="php">
 &lt;?php
-$fp = fopen("c:\\data\\info.txt", "r");
+  $fp = fopen("c:\\data\\info.txt", "r");
 ?&gt;
      </programlisting>
     </informalexample>
@@ -1407,10 +1414,10 @@
      <programlisting role="php">
 &lt;?php
 // Lit un fichier, et le place dans une cha&icirc;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);
 ?&gt;
      </programlisting>
     </informalexample>
@@ -1428,10 +1435,10 @@
      <informalexample>
       <programlisting role="php">
 &lt;?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);
 ?&gt;
       </programlisting>
      </informalexample>
@@ -1483,12 +1490,12 @@
      <title>Exemple <function>fscanf</function></title>
      <programlisting role="php">
 &lt;?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&eacute;es
-}
-fclose($fp);
+  }
+  fclose($fp);
 ?&gt;
      </programlisting>
     </example>
@@ -1763,12 +1770,12 @@
      <title>Exemple avec <function>set_file_buffer</function></title>
      <programlisting role="php">
 &lt;?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);
+  }
 ?&gt;
      </programlisting>
     </example>
@@ -2152,11 +2159,13 @@
    </para>
    <para>
     Notez que vous aurez &agrave; pr&eacute;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&eacute; par le umask courant, que vous pouvez
+    modifier avec la fonction <function>umask</function>.
     <informalexample>
      <programlisting role="php">
 &lt;?php
-mkdir ("/chemin/de/mon/dossier", 0700);
+  mkdir ("/chemin/de/mon/dossier", 0700);
 ?&gt;
      </programlisting>
     </informalexample>
@@ -2245,10 +2254,10 @@
      <title>Exemple avec <function>pathinfo</function></title>
      <programlisting role="php">
 &lt;?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";
 ?&gt;
      </programlisting>
     </example>
@@ -2336,7 +2345,7 @@
     <informalexample>
      <programlisting role="php">
 &lt;?php
-$fp = popen ("/bin/ls", "r");
+  $fp = popen("/bin/ls", "r");
 ?&gt;
      </programlisting>
     </informalexample>
@@ -2379,10 +2388,10 @@
     sp&eacute;cifi&eacute;, et le texte de la r&eacute;ponse sera affich&eacute;
     sur la sortie standard.
    </para>
-   <para>
-    ATTENTION : PHP ne g&egrave;re pas les redirections, donc il faut penser
-    &agrave; ajouter un "/" final pour les dossiers.
-   </para>
+   <simpara>
+    Les versions ant&eacute;rieures &agrave; PHP 4.0.6, ne g&egrave;re pas les 
+redirections automatiques,
+    ce qui oblige &agrave; ajouter les slash finaux "/" pour indiquer un dossier.
+   </simpara>
    <para>
     Si <parameter>filename</parameter> commence par "ftp://"; (insensible
     &agrave; la casse), une connexion FTP est ouverte avec l'h&ocirc;te
@@ -2659,7 +2668,7 @@
      <title>Exemple <function>realpath</function></title>
      <programlisting role="php">
 &lt;?php
-$real_path = realpath ("../../index.php");
+  $real_path = realpath("../../index.php");
 ?&gt;
      </programlisting>
     </example>
@@ -2717,13 +2726,13 @@
     dans le dossier temporaire du syst&egrave;me.
    </para>
    <para>
-    Le comportement de <function>tempnam</function> d&eacute;pend du
-    syst&egrave;me. Sous Windows, la variable d'environnement TMP sera
-    prioritaire par rapport au param&egrave;tre <parameter>dir</parameter>;
-    sous Linux la variable d'environnement TMPDIR aura la priorit&eacute;,
-    tandis que l'OS SVR4 utilisera toujours le param&egrave;tre
-    <parameter>dir</parameter> si le dossier n'existe pas. Reportez
-    vous &agrave; la documentation de votre syst&egrave;me(tempnam(3)).
+    Avant PHP 4.0.6, le comportement de <function>tempnam</function> d&eacute;pendait
+    de l'OS sous-jacent. Sous Windows, la variable d'environnement
+    TMP remplace le param&egrave;tre <parameter>dir</parameter>; sous Linux, la
+    variable d'environnement TMPDIR a la priorit&eacute;, tandis que pour les
+    OS en syst&egrave;me V R4, le param&egrave;tre <parameter>dir</parameter> sera 
+toujours
+    utilis&eacute;, si le dossier qu'il repr&eacute;sente existe. Consultez votre
+    documentation pour plus de d&eacute;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">
 &lt;?php
-$tmpfname = tempnam ("/tmp", "FOO");
+  $tmpfname = tempnam("/tmp", "FOO");
 ?&gt;
      </programlisting>
     </example>