<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.30 $ -->
<reference id="ref.filesystem">
 <title>Syst&egrave;me de fichiers</title>
 <titleabbrev>Syst&egrave;me de fichiers</titleabbrev>
 <refentry id="function.basename">
  <refnamediv>
   <refname>basename</refname>
   <refpurpose>
    S&eacute;pare le nom du fichier et le nom du dossier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>basename</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>suffix</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>basename</function> prend en param&egrave;tre le chemin complet
    d'un fichier et en extrait le nom du fichier. Si <optional>suffix</optional>
    est fourni, le suffixe sera aussi supprim&eacute;.
   </para>
   <para>
    Sous Windows, les caract&egrave;res (<literal>/</literal>) et antislash
    (<literal>\</literal>) sont utilis&eacute;s comme s&eacute;parateurs de
    dossier. Sous les autres OS, seul le caract&egrave;re slash
    (<literal>/</literal>) est utilis&eacute;.
   </para>
   <para>
    <example>
     <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"
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>dirname</function>.
   </para>
   <note>
    <para>
     <parameter>suffix</parameter> a &eacute;t&eacute; ajout&eacute; en PHP 4.1.0.
    </para>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.chgrp">
  <refnamediv>
   <refname>chgrp</refname>
   <refpurpose>Change le groupe possesseur du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>chgrp</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>group</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>chgrp</function> essaie de changer le groupe propri&eacute;taire
    du fichier. Seul le super-utilisateur (root) peut changer le groupe
    propri&eacute;taire d'un fichier arbitrairement. Les utilisateurs
    classiques ne peuvent changer
    le groupe propri&eacute;taire d'un fichier que si l'utilisateur
    propri&eacute;taire du fichier est membre du groupe.
   </para>
   <para>
    <function>chgrp</function> renvoie &true; en
    cas de succ&egrave;s, sinon renvoie &false;.
   </para>
   <para>
    Voir aussi
    <function>chown</function> et
    <function>chmod</function>.
   </para>
   <note>
    <simpara>
     <function>chgrp</function> ne fonctionne pas sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.chmod">
  <refnamediv>
   <refname>chmod</refname>
   <refpurpose>Change le mode du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>chmod</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>int</type><parameter>mode</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>chmod</function> remplace le mode du fichier
    <parameter>filename</parameter> par le mode <parameter>mode</parameter>.
   </para>
   <para>
    Il est &agrave; noter que le mode <parameter>mode</parameter> est
    consid&eacute;r&eacute; comme un nombre en notation octale. Afin de
    vous en assurer, vous pouvez pr&eacute;fixer cette valeur par un
    z&eacute;ro (<parameter>mode</parameter>):
    <informalexample>
     <programlisting role="php">
&lt;?php
  chmod( "/somedir/somefile", 755 );
// notation d&eacute;cimale; probablement <literal>FALSE</literal>
  chmod( "/somedir/somefile", 0755 );
// notation octale; valeur du mode correcte
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
    <function>chmod</function> renvoie &true;
    en cas de succ&egrave;s, &false; sinon.
   </para>
   <para>
    Voir aussi
    <function>chown</function> et
    <function>chgrp</function>.
   </para>
   <note>
    <simpara>
     <function>chmod</function> ne fonctionne pas sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.chown">
  <refnamediv>
   <refname>chown</refname>
   <refpurpose>Change le groupe propri&eacute;taire du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>chown</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>mixed</type><parameter>user</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>chown</function> change le groupe propri&eacute;taire du fichier.
    Seul le super-utilisateur (root) peut changer le propri&eacute;taire
    arbitrairement d'un fichier.
   </para>
   <para>
    <function>chown</function> renvoie &true;
    en cas de succ&egrave;s, "&false;" sinon.
    <note>
     <simpara>
      Sous Windows, <function>chown</function> ne fait rien et
      retourne &true;.
     </simpara>
    </note>
   </para>
   <para>
    Voir aussi
    <function>chown</function> et
    <function>chmod</function>.
   </para>
   <note>
    <simpara>
     <function>chown</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.clearstatcache">
  <refnamediv>
   <refname>clearstatcache</refname>
   <refpurpose>Efface le cache de <function>stat</function></refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>clearstatcache</methodname>
     <void/>
    </methodsynopsis>
   <para>
    L'appel &agrave; la fonction <systemitem>stat</systemitem> ou
    <systemitem>lstat</systemitem> est relativement co&ucirc;teux en terme de
    temps d'ex&eacute;cution. Pour cela, le r&eacute;sultat du dernier
    appel &agrave; l'une des fonctions de statut, (voir la liste ci-dessous), est
    sauvegard&eacute; pour r&eacute;-utilisation ult&eacute;rieure. Si vous voulez
    forcer la v&eacute;rification du statut d'un fichier, dans le cas o&ugrave; le
    fichier aurait pu &ecirc;tre modifi&eacute; ou aurait disparu, vous
    devez utiliser la fonction <function>clearstatcache</function>
    afin d'effacer de la m&eacute;moire les r&eacute;sultats du dernier
    appel &agrave; la fonction.
   </para>
   <para>
    La valeur du cache n'est valable que pour la dur&eacute;e d'une requ&ecirc;te.
   </para>
   <para>
    Les fonctions affect&eacute;es sont : <function>stat</function>,
    <function>lstat</function>,
    <function>file_exists</function>,
    <function>is_writable</function>,
    <function>is_readable</function>,
    <function>is_executable</function>,
    <function>is_file</function>,
    <function>is_dir</function>,
    <function>is_link</function>,
    <function>filectime</function>,
    <function>fileatime</function>,
    <function>filemtime</function>,
    <function>fileinode</function>,
    <function>filegroup</function>,
    <function>fileowner</function>,
    <function>filesize</function>,
    <function>filetype</function>, et
    <function>fileperms</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.copy">
  <refnamediv>
   <refname>copy</refname>
   <refpurpose>Copie un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>copy</methodname>
     <methodparam><type>string</type><parameter>source</parameter></methodparam>
     <methodparam><type>string</type><parameter>dest</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>copy</function> fait une copie du fichier. Elle renvoie &true; en
    cas de succ&egrave;s, &false; sinon.
    <example>
     <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&eacute;ussi...&lt;br&gt;\n");
}
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>rename</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.delete">
  <refnamediv>
   <refname>delete</refname>
   <refpurpose>Effacer</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>delete</methodname>
     <methodparam><type>string</type><parameter>file</parameter></methodparam>
    </methodsynopsis>
   <para>
    Ceci est une fausse entr&eacute;e du manuel pour ceux qui recherchent
    en fait la fonction <function>unlink</function> ou <function>unset</function>.
   </para>
   <para>
    Voir aussi
    <function>unlink</function> pour effacer des fichiers et
    <function>unset</function> pour effacer des variables.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.dirname">
  <refnamediv>
   <refname>dirname</refname>
   <refpurpose>Renvoie le nom du dossier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>dirname</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
    </methodsynopsis>
   <para>
    Si <parameter>path</parameter> contient le chemin d'un fichier ou dossier,
    <function>dirname</function> retournera le nom du dossier qui le contient.
   </para>
   <para>
    Sous Windows, les slash (<literal>/</literal>) et anti-slash
    (<literal>\</literal>) sont utilis&eacute;s comme s&eacute;parateurs
    de dossier. Dans les autres environnements, seul le slash
    (<literal>/</literal>) est utilis&eacute;.
   </para>
   <para>
    <example>
     <title>Exemple avec <function>dirname</function></title>
     <programlisting role="php">
&lt;?php
  $path = "/etc/passwd";
  $file = dirname($path); // $file contient "/etc"
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>basename</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.disk_free_space">
  <refnamediv>
   <refname>disk_free_space</refname>
   <refpurpose>
    Renvoie l'espace disque disponible dans le r&eacute;pertoire.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>float</type><methodname>disk_free_space</methodname>
     <methodparam><type>string</type><parameter>directory</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>disk_free_space</function> retournera le nombre d'octets disponibles sur
    le disque correspondant contenant le dossier <parameter>directory</parameter>.
   </para>
   <para>
    <example>
     <title>Exemple avec <function>disk_free_space</function></title>
     <programlisting role="php">
&lt;?php
  $df = disk_free_space("/");
  // $df contient le nombre d'octets libres sur "/"
?&gt;
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.diskfreespace">
  <refnamediv>
   <refname>diskfreespace</refname>
   <refpurpose>Alias de <function>disk_free_space</function></refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>float</type><methodname>diskfreespace</methodname>
     <methodparam><type>string</type><parameter>directory</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>diskfreespace</function> est l'ancien nom de la fonction
    <function>disk_free_space</function>. Elle est obsol&egrave;te, et il
    est vivement recommand&eacute; d'utiliser <function>disk_free_space</function>.
   </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>
    <methodsynopsis>
     <type>float</type><methodname>disk_total_space</methodname>
     <methodparam><type>string</type><parameter>directory</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>disk_total_space</function> lit r&eacute;cursivement toutes les tailles
    du dossier <parameter>directory</parameter> et retourne la
    somme.   <parameter>directory</parameter> peut &ecirc;tre aussi une partition
    de disque.
   </para>
   <para>
    <example>
     <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
                             // dans le dossier "/"
?&gt;
     </programlisting>
    </example>
   </para>
   &note.sm.uidcheck;
  </refsect1>
 </refentry>
 <refentry id="function.fclose">
  <refnamediv>
   <refname>fclose</refname>
   <refpurpose>Ferme un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>bool</type><methodname>fclose</methodname>
     <methodparam><type>resource</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fclose</function> ferme le fichier <parameter>fp</parameter>.
   </para>
   <para>
    <function>fclose</function> retourne &true; en cas de succ&egrave;s,
    et &false; en cas d'&eacute;chec.
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function> ou
    <function>fsockopen</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.feof">
  <refnamediv>
   <refname>feof</refname>
   <refpurpose>Teste la fin du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>feof</methodname>
     <methodparam><type>resource</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>feof</function> retourne &true; si le pointeur
    <parameter>fp</parameter> est &agrave; la fin du fichier, ou si
    une erreur survient, sinon, retourne &false;.
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function>, <function>popen</function>,
    ou <function>fsockopen</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fflush">
  <refnamediv>
   <refname>fflush</refname>
   <refpurpose>
    Envoi tout le contenu g&eacute;n&eacute;r&eacute; dans un fichier
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fflush</methodname>
     <methodparam><type>resource</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fflush</function> force l'&eacute;criture de toutes les
    donn&eacute;es bufferis&eacute;es dans le fichier d&eacute;sign&eacute;
    par <parameter>fp</parameter>. <function>fflush</function> retourne
    &true; en cas de succ&egrave;s, et &false;
    sinon.
   </para>
   <para>
    <parameter>fp</parameter> est un pointeur de fichier ouvert
    avec <function>fopen</function>, <function>popen</function>, ou
    <function>fsockopen</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fgetc">
  <refnamediv>
   <refname>fgetc</refname>
   <refpurpose>
    Renvoie le caract&egrave;re que pointe le pointeur du fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>fgetc</methodname>
     <methodparam><type>resource</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fgetc</function> retourne une cha&icirc;ne contenant un
    seul caract&egrave;re, lu depuis le fichier point&eacute; par
    <parameter>fp</parameter>. <function>fgetc</function> retourne
    &false; &agrave; la fin du fichier
    (tout comme <function>feof</function>).
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function>, <function>popen</function>,
    ou <function>fsockopen</function>.
   </para>
   <para>
    Voir aussi
    <function>fread</function>,
    <function>fopen</function>,
    <function>popen</function>,
    <function>fsockopen</function> et
    <function>fgets</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fgetcsv">
  <refnamediv>
   <refname>fgetcsv</refname>
   <refpurpose>
    Renvoie la ligne courante et cherche les champs CSV
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>fgetcsv</methodname>
     <methodparam><type>resource</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>length</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>
      delimiter
      </parameter></methodparam>
    </methodsynopsis>
   <simpara>
    Identique &agrave; <function>fgets</function> mais <function>fgetcsv</function>
    analyse la ligne qu'il lit et recherche les champs CSV, qu'il
    va retourner dans un tableau les contenant. Le d&eacute;limiteur de champs
    <parameter>delimiter</parameter> est la virgule, &agrave; moins que vous ne
    fournissiez un troisi&egrave;me argument.
   </simpara>
   <simpara>
    <parameter>fp</parameter> doit &ecirc;tre un pointeur valide, et avoir
    &eacute;t&eacute; correctement ouvert par <function>fopen</function>,
    <function>popen</function>, ou <function>fsockopen</function>.
   </simpara>
   <simpara>
    <parameter>length</parameter> doit &ecirc;tre plus grand que la plus
    grande ligne trouv&eacute;e dans un fichier CSV (en comptant les
    caract&egrave;res de fin de ligne).
   </simpara>
   <simpara>
    <function>fgetcsv</function> retourne &false; en cas
    d'erreur, ou en cas de fin du fichier.
   </simpara>
   <simpara>
    Note : une ligne vide dans un fichier CSV sera retourn&eacute;e dans le
    tableau comme une cha&icirc;ne vide, et ne sera pas trait&eacute;e comme
    une erreur.
   </simpara>
   <example>
    <title>
     Exemple avec <function>fgetcsv</function>
    </title>
    <programlisting role="php">
&lt;?php
  $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&lt;$num; $c++) {
        print $data[$c] . "&lt;br&gt;";
    }
  }
  fclose ($fp);
?&gt;
    </programlisting>
   </example>
  </refsect1>
 </refentry>
 <refentry id="function.fgets">
  <refnamediv>
   <refname>fgets</refname>
   <refpurpose>
    Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>fgets</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>length</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fgets</function> retourne la cha&icirc;ne lue jusqu'&agrave;
    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&eacute;).
   </para>
   <para>
    Si une erreur survient, <function>fgets</function> retourne &false;.
   </para>
   <para>
    Erreur courante :
   </para>
   <simpara>
    Les programmeurs habitu&eacute;s &agrave; la programmation 'C' noteront que
    <function>fgets</function> ne se comporte pas comme son &eacute;quivalent C
    lors de la rencontre de la fin du fichier.
   </simpara>
   <simpara>
    <parameter>fp</parameter> doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function>, <function>popen</function>,
    ou <function>fsockopen</function>.
   </simpara>
   <para>
    Un exemple simple :
    <example>
     <title>Lecture d'un fichier ligne par ligne</title>
     <programlisting role="php">
&lt;?php
  $fd = fopen ("/tmp/inputfile.txt", "r");
  while (!feof($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
  }
  fclose ($fd);
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>fread</function>,
    <function>fopen</function>,
    <function>popen</function>,
    <function>fgetc</function>,
    <function>fsockopen</function> et
    <function>socket_set_timeout</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fgetss">
  <refnamediv>
   <refname>fgetss</refname>
   <refpurpose>
    Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier et
    &eacute;limine les balises HTML
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>fgetss</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>length</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>
      allowable_tags
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    Identique &agrave; <function>fgets</function>, mais <function>fgetss</function>
    supprime toutes les balises HTML et PHP qu'il trouve dans le texte lu.
   </para>
   <para>
    Vous pouvez aussi pr&eacute;ciser les balises qui seront ignor&eacute;es dans
    le troisi&egrave;me param&egrave;tre, optionnel.
    <note>
     <para>
      <parameter>allowable_tags</parameter> a &eacute;t&eacute; ajout&eacute; dans
      PHP 3.0.13, PHP 4B3.
     </para>
    </note>
   </para>
   <para>
    Voir aussi
    <function>fgets</function>,
    <function>fopen</function>,
    <function>fsockopen</function>,
    <function>popen</function> et
    <function>strip_tags</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.file">
  <refnamediv>
   <refname>file</refname>
   <refpurpose>
    Lit le fichier et renvoie le r&eacute;sultat dans un tableau.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>file</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
    </methodsynopsis>
   <para>
    Identique &agrave; <function>readfile</function>, hormis le fait que
    <function>file</function> retourne le fichier dans un tableau. Chaque
    &eacute;l&eacute;ment du tableau correspond &agrave; une ligne du fichier,
    et les retour-chariots sont plac&eacute;s en fin de ligne.
   </para>
   <para>
    Vous pouvez utiliser l'option <parameter>use_include_path</parameter> :
    en la mettant &agrave; "1", vous rechercherez aussi dans le dossier
    <link linkend="ini.include-path">include_path</link>.
   </para>
   <para>
    <informalexample>
     <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 ) ) {
   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' ) );
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>readfile</function>,
    <function>fopen</function>,
    <function>fsockopen</function> et
    <function>popen</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.file-exists">
  <refnamediv>
   <refname>file_exists</refname>
   <refpurpose>V&eacute;rifie si un fichier existe.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>file_exists</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>file_exists</function> retourne &true; si le fichier
    <parameter>filename</parameter> existe, et &false; sinon.
   </simpara>
   <simpara>
    <function>file_exists</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <simpara>
    Le r&eacute;sultat de <function>file_exists</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour
    plus de d&eacute;tails.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.fileatime">
  <refnamediv>
   <refname>fileatime</refname>
   <refpurpose>
    Renvoie la date &agrave; laquelle le fichier a &eacute;t&eacute;
    acc&eacute;d&eacute; pour la derni&egrave;re fois.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fileatime</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>fileatime</function> renvoie la date &agrave; laquelle le fichier
    a &eacute;t&eacute; acc&eacute;d&eacute; pour la derni&egrave;re fois, ou
    &false; en cas d'erreur.
   </simpara>
   <simpara>
    <function>fileatime</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <simpara>
    Le r&eacute;sultat de <function>fileatime</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.filectime">
  <refnamediv>
   <refname>filectime</refname>
   <refpurpose>
    Renvoie l'heure &agrave; laquelle l'inode a &eacute;t&eacute;
    acc&eacute;d&eacute; pour la derni&egrave;re fois.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>filectime</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>filectime</function> renvoie l'heure &agrave; laquelle l'inode
    <parameter>filename</parameter> a &eacute;t&eacute; acc&eacute;d&eacute; pour
    la derni&egrave;re fois, ou &false; en cas d'erreur.
   </para>
   <simpara>
    <function>filectime</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Note: Sur la plupart des serveurs UNIX, un fichier est consid&eacute;r&eacute;
    comme modifi&eacute; si les donn&eacute;es de son inode sont modifi&eacute;es.
    C'est-&agrave;-dire lorsque les permissions (utilisateur, groupe ou autre) ont
    &eacute;t&eacute; modifi&eacute;es. Voyez aussi <function>filemtime</function>
    (que vous pourrez utiliser lorsque vous cr&eacute;erez des indications
    telles que "Derni&egrave;re modification : " sur les pages web) et
    <function>fileatime</function>.
   </para>
   <para>
    Notez aussi que sur certains syst&egrave;mes UNIX, le ctime d'un fichier
    texte est consid&eacute;r&eacute; comme sa date de cr&eacute;ation. Cela est faux!
    Il n'y a pas de date de cr&eacute;ation de fichier sous la plupart
    des syst&egrave;mes UNIX.
   </para>
   <para>
    Le r&eacute;sultat de <function>filectime</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.filegroup">
  <refnamediv>
   <refname>filegroup</refname>
   <refpurpose>Lire le nom du groupe</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>filegroup</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>filegroup</function> renvoie le groupe qui poss&egrave;de le fichier
    <parameter>filename</parameter>, ou &false; en cas d'erreur.
    L'identifiant de groupe est retourn&eacute; au format num&eacute;rique, utilisez
    <function>posix_getgrgid</function> pour retrouver le nom du groupe.
   </para>
   <simpara>
    <function>filegroup</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>filegroup</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <note>
    <simpara>
     <function>filegroup</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.fileinode">
  <refnamediv>
   <refname>fileinode</refname>
   <refpurpose>Renvoie le num&eacute;ro d'inode du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fileinode</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fileinode</function> renvoie le num&eacute;ro d'inode du fichier
    <parameter>filename</parameter>, ou &false; en cas d'erreur.
   </para>
   <para>
    Le r&eacute;sultat de <function>fileinode</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>fileinode</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <note>
    <simpara>
     <function>fileinode</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.filemtime">
  <refnamediv>
   <refname>filemtime</refname>
   <refpurpose>
    Renvoie la date de derni&egrave;re modification du fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>filemtime</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>filemtime</function> renvoie la date de derni&egrave;re
    modification du fichier <parameter>filename</parameter>, ou &false;
    en cas d'erreur.
   </para>
   <para>
    Le r&eacute;sultat de <function>filemtime</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>filemtime</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    <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.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fileowner">
  <refnamediv>
   <refname>fileowner</refname>
   <refpurpose>Renvoie le nom du propri&eacute;taire du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fileowner</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fileowner</function> renvoie le nom du possesseur du fichier
    <parameter>filename</parameter>, ou &false; en cas d'erreur.
    L'identification du possesseur de fichier est num&eacute;rique : il faut utiliser
    <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur.
   </para>
   <simpara>
    <function>fileowner</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>fileowner</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <note>
    <simpara>
     <function>fileowner</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.fileperms">
  <refnamediv>
   <refname>fileperms</refname>
   <refpurpose>
    Renvoie les permissions affect&eacute;es au fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fileperms</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fileperms</function> renvoie les permissions affect&eacute;es
    au fichier <parameter>filename</parameter>, ou &false;
    en cas d'erreur.
   </para>
   <simpara>
    <function>fileperms</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>fileperms</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.filesize">
  <refnamediv>
   <refname>filesize</refname>
   <refpurpose>Renvoie la taille du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>filesize</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>filesize</function> renvoie la taille du fichier
    <parameter>filename</parameter>, ou &false; en cas d'erreur.
   </para>
   <simpara>
    <function>filesize</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>filesize</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus
    de d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.filetype">
  <refnamediv>
   <refname>filetype</refname>
   <refpurpose>Retourne le type de fichier</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>filetype</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>filetype</function> renvoie le type du fichier
    <parameter>filename</parameter>. Les r&eacute;ponses possibles sont :
    fifo, char, dir, block, link, file, et unknown.
   </para>
   <para>
    <function>filetype</function> retourne &false; en cas d'erreur.
   </para>
   <simpara>
    <function>filetype</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>filetype</function> est mis en cache.
    Reportez-vous &agrave; <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.flock">
  <refnamediv>
   <refname>flock</refname>
   <refpurpose>Verrouille le fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>flock</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>operation</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    PHP dispose d'un syst&egrave;me complet de verrouillage de fichiers.
    Tous les programmes qui acc&egrave;dent au fichier doivent utiliser la
    m&ecirc;me m&eacute;thode de verrouillage pour qu'il soit efficace.
   </simpara>
   <simpara>
    <function>flock</function> agit sur le fichier <parameter>fp</parameter>
    qui doit avoir &eacute;t&eacute; ouvert au pr&eacute;alable.
    <parameter>operation</parameter> est une des valeurs suivantes :
   </simpara>
   <para>
    <itemizedlist>
     <listitem>
      <simpara>
       Acquisition d'un verrou : <parameter>operation</parameter> = 1.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Acquisition d'un verrou exclusif (&eacute;criture),
       <parameter>operation</parameter> = 2.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Lib&eacute;ration d'un verrou (partag&eacute; ou exclusif),
       <parameter>operation</parameter> = 3.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Si vous voulez que <function>flock</function> ne se bloque pas durant
       le verrouillage, ajoutez 4 &agrave; <parameter>operation</parameter>.
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
   <simpara>
    <function>flock</function> permet de r&eacute;aliser un syst&egrave;me simple de
    verrous &eacute;criture / lecture, qui peut &ecirc;tre utilis&eacute; sur
    n'importe quelle plate-forme (Unix et Windows compris).
   </simpara>
   <simpara>
    <function>flock</function> retourne &true; en cas
    de succ&egrave;s, et &false;
    sinon. (le verrou n'a pas pu &ecirc;tre obtenu).
   </simpara>
   <warning>
   <para>
    Sur la plupart des OS, <function>flock</function> est impl&eacute;ment&eacute;
    au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread,
    comme ISAPI, vous ne pouvez pas vous fier &agrave; <function>flock</function>
    pour prot&eacute;ger vos fichiers contre des acc&egrave;s concurrents du
    m&ecirc;me serveur.
   </para>
   </warning>
  </refsect1>
 </refentry>
 <refentry id="function.fopen">
  <refnamediv>
   <refname>fopen</refname>
   <refpurpose>Ouverture d'un fichier ou d'une URL.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fopen</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>string</type><parameter>mode</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>
      use_include_path
      </parameter></methodparam>
    </methodsynopsis>
   <simpara>
    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;. 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>
    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;
    la casse), une connexion FTP est ouverte avec le serveur sp&eacute;cifi&eacute;,
    et un pointeur sur la r&eacute;ponse fournie est retourn&eacute;. Si le serveur
    ne supporte par le mode FTP passif, <function>fopen</function> &eacute;chouera.
    Vous pouvez ouvrir des fichiers en lecture seulement, ou en &eacute;criture
    seulement (le full duplex n'est pas support&eacute;).
   </simpara>
   <simpara>
    Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout",
    ou "php://stderr", le flot correspondant sera ouvert. (Cela a &eacute;t&eacute;
    introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin"
    ou "/dev/fd/0" devaient &ecirc;tre utilis&eacute;s pour acc&eacute;der &agrave;
    ces flots).
   </simpara>
   <simpara>
    Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP
    tentera de lire ce fichier dans le syst&egrave;me local, et un pointeur sur
    le fichier ouvert sera retourn&eacute;.
   </simpara>
   <simpara>
    Si l'ouverture &eacute;choue, <function>fopen</function> retourne
    &false;.
   </simpara>
   <para>
    <parameter>mode</parameter> peut prendre les valeurs suivantes :
    <itemizedlist>
     <listitem>
      <simpara>
       'r' - Ouvre en lecture seule, et place le pointeur de fichier au
       d&eacute;but du fichier.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       'r+' - Ouvre en lecture et &eacute;criture, et place le pointeur de
       fichier au d&eacute;but du fichier.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       'w' - Ouvre en &eacute;criture seule; place le pointeur de fichier au
       d&eacute;but du fichier et r&eacute;duit la taille du fichier &agrave; 0.
       Si le fichier n'existe pas, on tente de le cr&eacute;er.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       'w+' - Ouvre en lecture et &eacute;criture; place le pointeur de fichier
       au d&eacute;but du fichier et r&eacute;duit la taille du fichier &agrave;
       0. Si le fichier n'existe pas, on tente de le cr&eacute;er.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       'a' - Ouvre en &eacute;criture seule; place le pointeur de fichier &agrave;
       la fin du fichier file. Si le fichier n'existe pas, on tente de le
       cr&eacute;er.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       'a+' - Ouvre en lecture et &eacute;criture; place le pointeur de fichier
       &agrave; la fin du fichier. Si le fichier n'existe pas, on tente de le
       cr&eacute;er.
      </simpara>
     </listitem>
    </itemizedlist>
    De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option
    n'est utile que sur les syst&egrave;mes qui font la diff&eacute;rence entre
    les fichiers binaires et les fichiers textes (en bref, c'est une
    fonctionnalit&eacute; Windows, totalement inutile sous Unix).
    S'il n'est pas n&eacute;cessaire, il sera ignor&eacute;.
   </para>
   <para>
    Vous pouvez utiliser le troisi&egrave;me param&egrave;tre optionnel
    pour explorer le dossier <link linkend="ini.include-path">include_path</link>,
    en le mettant &agrave; 1.
   </para>
   <para>
    <example>
     <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");
?&gt;
     </programlisting>
    </example>
   </para>
   <simpara>
    Si vous rencontrez des probl&egrave;mes en lecture ou &eacute;criture
    de fichier et que vous utilisez PHP en version module de serveur,
    n'oubliez pas que les fichiers auxquels vous acc&eacute;dez ne sont
    pas n&eacute;cessairement accessibles au processus serveur.
   </simpara>
   <para>
    Sous Windows, assurez-vous de bien &eacute;chapper les anti-slash
    utilis&eacute;s dans le chemin du fichier, ou bien utilisez des slash.
    <informalexample>
     <programlisting role="php">
&lt;?php
  $fp = fopen("c:\\data\\info.txt", "r");
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <simpara>
    Voir aussi
    <function>fclose</function>,
    <function>fsockopen</function>,
    <function>socket_set_timeout</function> et
    <function>popen</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.fpassthru">
  <refnamediv>
   <refname>fpassthru</refname>
   <refpurpose>
    Affiche la partie du fichier situ&eacute;e apr&egrave;s le pointeur du fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fpassthru</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>fpassthru</function> lit tout le reste d'un fichier
    jusqu'&agrave; la fin, et dirige le r&eacute;sultat vers la sortie standard.
   </simpara>
   <simpara>
    Si une erreur survient, <function>fpassthru</function> retourne &false;.
   </simpara>
   <simpara>
    Le pointeur de fichier doit &ecirc;tre valide, et doit avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function>, <function>popen</function>,
    ou <function>fsockopen</function>. Apr&egrave;s lecture,
    <function>fpassthru</function> va fermer le fichier (le pointeur
    <parameter>fp</parameter> sera alors invalide).
   </simpara>
   <simpara>
    Si vous voulez simplement afficher le contenu d'un fichier, il
    suffit d'utiliser <function>readfile</function>, ce qui &eacute;pargnera
    l'appel &agrave; <function>fopen</function>.
   </simpara>
   <simpara>
    Voir aussi
    <function>readfile</function>,
    <function>fopen</function>,
    <function>popen</function> et
    <function>fsockopen</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.fputs">
  <refnamediv>
   <refname>fputs</refname>
   <refpurpose>Ecrit dans un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fputs</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>string</type><parameter>str</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>
      length
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    <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&egrave;tre optionnel,
    et s'il n'est pas sp&eacute;cifi&eacute;, toute la cha&icirc;ne
    est &eacute;crite.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fread">
  <refnamediv>
   <refname>fread</refname>
   <refpurpose>Lecture du fichier en mode binaire.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>fread</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>length</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>fread</function> lit jusqu'&agrave; <parameter>length</parameter>
    octets dans le fichier ref&eacute;renc&eacute; par <parameter>fp</parameter>.
    La lecture s'arr&ecirc;te lorsque <parameter>length</parameter> octets
    ont &eacute;t&eacute; lus, ou que l'on a atteint la fin du fichier, ou
    qu'une erreur survient (le premier des trois).
   </simpara>
   <para>
    <informalexample>
     <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);
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <note>
    <para>
     Sur les syst&egrave;mes qui diff&eacute;rencient les fichiers
     textes et binaires (i.e. Windows) le fichier doit &ecirc;tre
     ouvert avec la lettre 'b' ajout&eacute;e au param&egrave;tre
     de mode de la fonction <function>fopen</function>.
    </para>
   </note>
   <note>
    <para>
     <informalexample>
      <programlisting role="php">
&lt;?php
  $filename = "c:\\fichiers\\uneimage.gif";
  $fd = fopen($filename, "rb");
  $contents = fread($fd, filesize ($filename));
  fclose($fd);
?&gt;
      </programlisting>
     </informalexample>
    </para>
   </note>
   <simpara>
    Voir aussi
    <function>fwrite</function>,
    <function>fopen</function>,
    <function>fsockopen</function>,
    <function>popen</function>,
    <function>fgets</function>,
    <function>fgetss</function>,
    <function>file</function> et
    <function>fpassthru</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.fscanf">
  <refnamediv>
   <refname>fscanf</refname>
   <refpurpose>Analyse un fichier en fonction d'un format</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>mixed</type><methodname>fscanf</methodname>
     <methodparam><type>int</type><parameter>handle</parameter></methodparam>
     <methodparam><type>string</type><parameter>format</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fscanf</function> est similaire &agrave;
    <function>sscanf</function>, mais elle prend comme
    entr&eacute;e un fichier, associ&eacute; &agrave;
    <parameter>handle</parameter> et l'interpr&egrave;te en
    fonction du format <parameter>format</parameter>. Si
    seulement deux param&egrave;tres sont pass&eacute;s
    &agrave; la fonction, les valeurs analys&eacute;es seront
    retourn&eacute;es sous forme de tableau. Si des arguments
    optionnels sont pass&eacute;s, la fonction retournera le
    nombre de valeurs assign&eacute;es. Les options doivent
    &ecirc;tre pass&eacute;es par r&eacute;f&eacute;rence.
    <example>
     <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")) {
    list ($name, $profession, $countrycode) = $userinfo;
    //... traitement des donn&eacute;es
  }
  fclose($fp);
?&gt;
     </programlisting>
    </example>
    <example>
     <title>users.txt</title>
     <programlisting role="txt">
janus  argonaute        gr
rodin  sculpteur        fr
sam    oncle            us
leonard   inventeur     it
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>fread</function>,
    <function>fgets</function>,
    <function>fgetss</function>,
    <function>sscanf</function>,
    <function>printf</function> et
    <function>sprintf</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fseek">
  <refnamediv>
   <refname>fseek</refname>
   <refpurpose>Modifie le pointeur de fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fseek</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>offset</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fseek</function> modifie le curseur de position
    dans le fichier <parameter>fp</parameter>. La nouvelle position
    mesur&eacute;e en octets &agrave; partir du d&eacute;but du fichier,
    est obtenue en additionnant la distance <parameter>offset</parameter>
    &agrave; la position <parameter>whence</parameter>. Ce param&egrave;tre
    peut prendre les valeurs suivantes :
    <simplelist>
    <member>
    SEEK_SET - La position finale vaut <parameter>offset</parameter> octets.
    </member>
    <member>
    SEEK_CUR - La position finale vaut la position courante
    ajout&eacute;e &agrave; <parameter>offset</parameter> octets.
    </member>
    <member>
    SEEK_END - La position finale vaut la position courante par rapport &agrave;
    la fin du fichier, ajout&eacute;e de <parameter>offset</parameter>.
    </member>
    </simplelist>
   </para>
   <para>
    Si <parameter>whence</parameter> n'est pas sp&eacute;cifi&eacute;e, il
    vaut par d&eacute;faut SEEK_SET.
   </para>
   <para>
    <function>fseek</function> retourne &true; en cas de
    succ&egrave;s, et sinon -1. Notez que positionner le pointeur au
    del&agrave; de la fin du fichier n'est pas une erreur.
   </para>
   <para>
    <function>fseek</function> ne peut pas &ecirc;tre utilis&eacute; sur les pointeurs
    retourn&eacute;s par <function>fopen</function> s'ils sont au format HTTP ou FTP.
   </para>
   <para>
    Voir aussi
    <function>ftell</function> et
    <function>rewind</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fstat">
  <refnamediv>
   <refname>fstat</refname>
   <refpurpose>
    Lit les informations sur un fichier &agrave; partir d'un pointeur de fichier
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>fstat</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>fstat</function> rassemble les informations sur le fichier dont on
    conna&icirc;t le pointeur <parameter>fp</parameter>. <function>fstat</function>
    est similaire &agrave; la fonction <function>stat</function>, hormis
    le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier.
   </para>
   <para>
    <function>fstat</function> retourne un tableau avec les &eacute;l&eacute;ments suivants :
    <itemizedlist>
     <listitem><simpara>1 : volume </simpara></listitem>
     <listitem><simpara>2 : inode</simpara></listitem>
     <listitem><simpara>3 : mode de protection du inode </simpara></listitem>
     <listitem><simpara>4 : nombre de liens </simpara></listitem>
     <listitem><simpara>5 : id de l'utilisateur propri&eacute;taire </simpara></listitem>
     <listitem><simpara>6 : id du groupe propri&eacute;taire</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&egrave;s </simpara></listitem>
     <listitem><simpara>10 : date de la derni&egrave;re modification </simpara></listitem>
     <listitem><simpara>11 : date du dernier changement </simpara></listitem>
     <listitem><simpara>12 : taille de bloc du syst&egrave;me pour les entr&eacute;es/sorties(*)</simpara></listitem>
     <listitem><simpara>13 : Nombre de blocs allou&eacute;s</simpara></listitem>
    </itemizedlist>
    * - uniquement sur les syst&egrave;mes qui supportent le type st_blksize.
    Les autres syst&egrave;mes (i.e. Windows) retournent -1.
   </para>
   <para>
    Les r&eacute;sultats de <function>fstat</function> sont mis en cache.
    Reportez-vous &agrave; la fonction <function>clearstatcache</function>
    pour plus de d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ftell">
  <refnamediv>
   <refname>ftell</refname>
   <refpurpose>Renvoie la position du pointeur du fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>ftell</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ftell</function> retourne la position courante du pointeur dans le
    fichier rep&eacute;r&eacute; par le pointeur <parameter>fp</parameter>, i.e.,
    son offset.
   </para>
   <para>
    Si une erreur survient, retourne &false;.
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    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>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ftruncate">
  <refnamediv>
   <refname>ftruncate</refname>
   <refpurpose>Tronque un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>ftruncate</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>size</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ftruncate</function> prend le pointeur de fichier
    <parameter>fp</parameter> et le tronque &agrave; la taille de
    <parameter>size</parameter>.<function>ftruncate</function> retourne
    &true; en cas de succ&egrave;s, et
    &false; sinon.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.fwrite">
  <refnamediv>
   <refname>fwrite</refname>
   <refpurpose>Ecriture du fichier en mode binaire.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>fwrite</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>string</type><parameter>string</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>
      length
      </parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>fwrite</function> &eacute;crit le contenu de la cha&icirc;ne
    <parameter>string</parameter> dans le fichier point&eacute; par
    <parameter>fp</parameter>. Si la longueur <parameter>length</parameter>
    est fournie, l'&eacute;criture s'arr&ecirc;tera apr&egrave;s
    <parameter>length</parameter> octets, ou &agrave; la fin de la
    cha&icirc;ne (le premier des deux).
   </simpara>
   <simpara>
    Notez que si <parameter>length</parameter> est fourni, alors l'option de
    configuration <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
    sera ignor&eacute;e, et les slash seront conserv&eacute;s.
   </simpara>
   <note>
    <para>
     De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option
     n'est utile que sur les syst&egrave;mes qui font la diff&eacute;rence entre
     les fichiers binaires et les fichiers textes (en bref, c'est une
     fonctionnalit&eacute; Windows, totalement inutile sous Unix).
     S'il n'est pas n&eacute;cessaire, il sera ignor&eacute;.
    </para>
   </note>
   <simpara>
    Voir aussi
    <function>fread</function>,
    <function>fopen</function>,
    <function>fsockopen</function>,
    <function>popen</function> et
    <function>fputs</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.set-file-buffer">
  <refnamediv>
   <refname>set_file_buffer</refname>
   <refpurpose>
    Fixe la bufferisation de fichier
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>set_file_buffer</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     <methodparam><type>int</type><parameter>buffer</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    L'&eacute;criture de fichier avec <function>fwrite</function> utilise normalement
    un buffer de 8K. Cela signifie que si deux processus essaient d'&eacute;crire
    dans le m&ecirc;me fichier, ils font une pause tous les 8ko pour laisser le temps
    &agrave; l'autre d'&eacute;crire &agrave; son tour.
    <function>set_file_buffer</function> permet de modifier la taille du buffer de
    sortie pour le pointeur de fichier <parameter>fp</parameter> &agrave;
    <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0,
    l'&eacute;criture se fera sans buffer. Cela force un processus &agrave; &eacute;crire
    toutes ses donn&eacute;es dans un fichier avant que les autres puissent y acc&eacute;der.
   </simpara>
   <simpara>
    <function>set_file_buffer</function> retourne 0 en cas de succ&egrave;s, ou
    EOF si la requ&ecirc;te ne peut pas &ecirc;tre honor&eacute;e.
   </simpara>
   <para>
    L'exemple suivant montre comment utiliser la fonction
    <function>set_file_buffer</function> pour cr&eacute;er un fichier
    sans buffer.
    <example>
     <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);
  }
?&gt;
     </programlisting>
    </example>
   </para>
   <simpara>
    Voir aussi
    <function>fopen</function> et
    <function>fwrite</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.is-dir">
  <refnamediv>
   <refname>is_dir</refname>
   <refpurpose>Indique si le nom de fichier est un dossier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_dir</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_dir</function> retourne &true; si
    <parameter>filename</parameter> existe et est un dossier.
   </para>
   <para>
    Le r&eacute;sultat de <function>is_dir</function> est mis en cache. Voir la fonction
    <function>clearstatcache</function> pour plus de d&eacute;tails.
   </para>
   <simpara>
    <function>is_dir</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Voir aussi
    <function>is_file</function> et
    <function>is_link</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-executable">
  <refnamediv>
   <refname>is_executable</refname>
   <refpurpose>Indique si le fichier est ex&eacute;cutable.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_executable</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_executable</function> retourne &true; si
    <parameter>filename</parameter> existe et est ex&eacute;cutable.
   </para>
   <para>
    Le r&eacute;sultat de <function>is_executable</function> est mis en cache.
    Voir la fonction <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>is_executable</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Voir aussi
    <function>is_file</function> et
    <function>is_link</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-file">
  <refnamediv>
   <refname>is_file</refname>
   <refpurpose>
    Indique si le fichier est un v&eacute;ritable fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_file</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_file</function> retourne &true; si
    <parameter>filename</parameter> existe et est un fichier
    (et pas un dossier).
   </para>
   <para>
    Le r&eacute;sultat de <function>is_file</function> est mis en cache.
    Voir la fonction <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>is_file</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Voir aussi
    <function>is_dir</function> et
    <function>is_link</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-link">
  <refnamediv>
   <refname>is_link</refname>
   <refpurpose>
    Indique si le fichier est un lien symbolique.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_link</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_link</function> retourne &true; si
    <parameter>filename</parameter> existe et est un lien symbolique.
   </para>
   <para>
    Le r&eacute;sultat de <function>is_link</function> est mis en cache.
    Voir la fonction <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>is_link</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Voir aussi
    <function>is_dir</function> et
    <function>is_file</function>.
   </para>
   <note>
    <simpara>
     <function>is_link</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.is-readable">
  <refnamediv>
   <refname>is_readable</refname>
   <refpurpose>Indique un fichier est autoris&eacute; en lecture</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_readable</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_readable</function> retourne &true; si
    <parameter>filename</parameter> existe et est accessible en lecture.
   </para>
   <para>
    N'oubliez pas que PHP acc&egrave;de aux fichiers avec les m&ecirc;mes
    autorisations que l'utilisateur qui fait tourner le serveur web
    (souvent, c'est 'nobody', personne).
   </para>
   <para>
    Le r&eacute;sultat de <function>is_readable</function> est mis en cache.
    Voir la fonction <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <simpara>
    <function>is_readable</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Voir aussi
    <function>is_writable</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-writable">
  <refnamediv>
   <refname>is_writable</refname>
   <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_writable</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_writable</function> retourne &true; si
    <parameter>filename</parameter> existe et est accessible en &eacute;criture.
   </para>
   <para>
    N'oubliez pas que PHP acc&egrave;de aux fichiers avec les m&ecirc;mes
    autorisations que l'utilisateur qui fait tourner le serveur web
    (souvent, c'est 'nobody', personne).
   </para>
   <simpara>
    <function>is_writable</function> ne fonctionne pas sur les
    <link linkend="features.remote-files">fichiers distants</link>.
    Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier
    du serveur.
   </simpara>
   <para>
    Le r&eacute;sultat de <function>is_writable</function> est mis en cache.
    Voir la fonction <function>clearstatcache</function> pour plus de
    d&eacute;tails.
   </para>
   <para>
    Voir aussi
    <function>is_readable</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-writeable">
  <refnamediv>
   <refname>is_writeable</refname>
   <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_writeable</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_writeable</function> est un alias de <function>is_writable</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.is-uploaded-file">
  <refnamediv>
   <refname>is_uploaded_file</refname>
   <refpurpose>
    Indique si le fichier a &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;
    par HTTP POST
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>is_uploaded_file</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>is_uploaded_file</function> est disponible &agrave; partir des
    versions PHP 3.0.16 et 4.0.2.
   </para>
   <para>
    <function>is_uploaded_file</function> retourne &true; si le fichier
    <varname>filename</varname> a &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;
    par HTTP POST. Cela est tr&egrave;s utile pour vous assurer qu'un
    utilisateur n'essaie pas d'acc&eacute;der intentionnellement &agrave;
    un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>).
   </para>
   <para>
    Ce type de v&eacute;rification est sp&eacute;cialement important s'il est
    possible que les fichiers t&eacute;l&eacute;charg&eacute;s
    r&eacute;v&eacute;lent leur contenu &agrave; l'utilisateur, ou
    m&ecirc;me aux utilisateurs du m&ecirc;me syst&egrave;me.
   </para>
   <para>
    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>
 </refentry>
 <refentry id="function.link">
  <refnamediv>
   <refname>link</refname>
   <refpurpose>Cr&eacute;e un lien.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>link</methodname>
     <methodparam><type>string</type><parameter>target</parameter></methodparam>
     <methodparam><type>string</type><parameter>link</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>link</function> cr&eacute;e un lien.
   </para>
   <para>
    Voir aussi
    <function>symlink</function> pour cr&eacute;er des liens
    symboliques et
    <function>readlink</function> avec <function>linkinfo</function>.
   </para>
   <note>
    <simpara>
     <function>link</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.linkinfo">
  <refnamediv>
   <refname>linkinfo</refname>
   <refpurpose>Renvoie les informations &agrave; propos d'un lien.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>linkinfo</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>linkinfo</function> renvoie les informations &agrave; propos
    d'un lien, c'est-&agrave;-dire le champs st_dev de la structure d'information UNIX
    (comme en langage C). <function>linkinfo</function> sert &agrave; v&eacute;rifier
    si un lien (rep&eacute;r&eacute; par <parameter>path</parameter>)
    existe (en utilisant la m&ecirc;me m&eacute;thode que la macro
    S_ISLNK de stat.h). <function>linkinfo</function> retourne
    &false; en cas d'erreur.
   </para>
   <para>
    Voir aussi
    <function>symlink</function>,
    <function>link</function> et
    <function>readlink</function>.
   </para>
   <note>
    <simpara>
     <function>linkinfo</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.mkdir">
  <refnamediv>
   <refname>mkdir</refname>
   <refpurpose>Cr&eacute;e un dossier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>mkdir</methodname>
     <methodparam><type>string</type><parameter>pathname</parameter></methodparam>
     <methodparam><type>int</type><parameter>mode</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>mkdir</function> tente de cr&eacute;er un dossier dans
    le chemin <parameter>pathname</parameter>.
   </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.
    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);
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
    <function>mkdir</function> retourne &true; en cas de
    succ&egrave;s, et &false; en cas d'&eacute;chec.
   </para>
   <para>
    Voir aussi
    <function>rmdir</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.move-uploaded-file">
  <refnamediv>
   <refname>move_uploaded_file</refname>
   <refpurpose>D&eacute;place un fichier t&eacute;l&eacute;charg&eacute;.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>move_uploaded_file</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>string</type><parameter>destination</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>move_uploaded_file</function> est disponible &agrave; partir
    des versions PHP 3.0.16 et 4.0.2.
   </para>
   <para>
    <function>move_uploaded_file</function> s'assure que le fichier
    <parameter>filename</parameter> est un fichier t&eacute;l&eacute;charg&eacute;
    par HTTP POST. Si le fichier est valide, il est d&eacute;plac&eacute;
    jusqu'&agrave; <parameter>destination</parameter>.
   </para>
   <para>
    Si <parameter>filename</parameter> n'est pas valide, rien ne se passe,
    et <function>move_uploaded_file</function> retournera &false;.
   </para>
   <para>
    Si <parameter>filename</parameter> est un fichier
    t&eacute;l&eacute;charg&eacute;, mais que pour une raison
    quelconque, il ne peut &ecirc;tre d&eacute;plac&eacute;, rien ne se passe,
    et <function>move_uploaded_file</function> retourne &false;.
    De plus, une alerte sera affich&eacute;e.
   </para>
   <para>
    Ce type de v&eacute;rification est sp&eacute;cialement important s'il
    est possible que les fichiers t&eacute;l&eacute;charg&eacute;s
    r&eacute;v&egrave;lent leur contenu &agrave; l'utilisateur,
    ou m&ecirc;me aux utilisateurs du m&ecirc;me syst&egrave;me.
   </para>
   <para>
    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>
 </refentry>
 <refentry id="function.parse-ini-file">
  <refnamediv>
   <refname>parse_ini_file</refname>
   <refpurpose>Traite un fichier de configuration</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>parse_ini_file</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam choice="opt"><type>bool</type><parameter>
       process_sections
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>parse_ini_file</function> charge le fichier
    <parameter>filename</parameter> et retourne les
    configuration qui s'y trouve sous forme d'un tableau
    associatif. En passant le deuxi&egrave;me param&egrave;tre optionnel
    &agrave; <parameter>process_sections</parameter>, vous obtiendrez
    un tableau multi-dimensionnel, avec les noms des sections.
    La valeur par d&eacute;faut de ce param&egrave;tre est &false;
   </para>
   <note>
    <para>
     Cette fonction n'a rien a voir avec le fichier
     <filename>php.ini</filename>. Ce dernier a d&eacute;j&agrave; &eacute;tait
     trait&eacute; lorsque vous commencez a ex&eacute;cuter votre script. Cette
     fonction peut vous permettre de lire vos propres fichiers
     de configuration.
    </para>
   </note>
   <para>
    La structure des fichiers de configuration lus est similaire
    &agrave; celle de <filename>php.ini</filename>.
   </para>
   <para>
    <example>
     <title>Contenu de exemple.ini</title>
     <programlisting>
; Ceco est un fichier de configuration
; Les commentaires commencent par ';', comme dans php.ini
[premiere_section]
un = 1
cinq = 5
[seconde_section]
chemin = /usr/local/bin
     </programlisting>
    </example>
   </para>
   <para>
    <example>
     <title>Exemple avec <function>parse_ini_file</function></title>
     <programlisting>
&lt;?php
// Traitement sans les sections
$ini_array = parse_ini_file("exemple.ini");
print_r($ini_array);
// Traitement avec les sections
$ini_array = parse_ini_file("sample.ini", TRUE);
print_r($ini_array);
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Cet exemple va produire :
    <informalexample>
     <programlisting>
Array
(
   [un] => 1
   [cinq] => 5
   [chemin] => /usr/local/bin
)
Array
(
   [premiere_section] => Array
       (
           [un] => 1
           [cinq] => 5
       )
   [seconde_section] => Array
       (
           [chemin] => /usr/local/bin
       )
)
     </programlisting>
    </informalexample>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.pathinfo">
  <refnamediv>
   <refname>pathinfo</refname>
   <refpurpose>Retourne des informations sur un chemin syst&egrave;me</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>pathinfo</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>pathinfo</function> retourne un tableau associatif,
    contenant les informations sur le chemin <parameter>path</parameter>.
    Les &eacute;l&eacute;ments suivants sont retourn&eacute;s :
    <parameter>dirname</parameter>, <parameter>basename</parameter>
    et <parameter>extension</parameter>.
   </para>
   <para>
    <example>
     <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";
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Va afficher :
    <informalexample>
     <programlisting>
/www/htdocs
index.html
html
     </programlisting>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>dirname</function>,
    <function>parse_url</function>,
    <function>basename</function> et
    <function>realpath</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.pclose">
  <refnamediv>
   <refname>pclose</refname>
   <refpurpose>Ferme un processus de pointeur de fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>pclose</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>pclose</function> ferme un processus de pointeur de fichier ouvert par
    <function>popen</function>.
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir
    &eacute;t&eacute; ouvert correctement par <function>popen</function>.
   </para>
   <para>
    <function>pclose</function> retourne le statut final du processus
    ex&eacute;cut&eacute;.
   </para>
   <para>
    Voir aussi
    <function>popen</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.popen">
  <refnamediv>
   <refname>popen</refname>
   <refpurpose>Cr&eacute;e un processus de pointeur de fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>popen</methodname>
     <methodparam><type>string</type><parameter>commet</parameter></methodparam>
     <methodparam><type>string</type><parameter>mode</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>popen</function> ouvre un processus fils en faisant un fork de la
    commande.
   </para>
   <para>
    <function>popen</function> retourne un pointeur de fichier
    identique &agrave; celui retourn&eacute; par <function>fopen</function>,
    hormis le fait qu'il sera unidirectionnel (lecture seule, ou
    &eacute;criture seule), et doit &ecirc;tre termin&eacute; par
    <function>pclose</function>. Ce pointeur peut &ecirc;tre utilis&eacute;
    avec <function>fgets</function>, <function>fgetss</function> et
    <function>fputs</function>.
   </para>
   <para>
    Si une erreur survient, retourne &false;.
   </para>
   <para>
    <informalexample>
     <programlisting role="php">
&lt;?php
  $fp = popen("/bin/ls", "r");
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>pclose</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.readfile">
  <refnamediv>
   <refname>readfile</refname>
   <refpurpose>Affiche un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>readfile</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam choice="opt"><type>int</type><parameter>
      use_include_path
      </parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>readfile</function> lit le fichier <parameter>filename</parameter> et
    l'envoit &agrave; la sortie standard.
   </para>
   <para>
    <function>readfile</function> retourne le nombre d'octets lus depuis le fichier.
    Si une erreur survient, retourne &false;.
   </para>
   <para>
    Si <parameter>filename</parameter> commence par "http://" (insensible
    &agrave; la casse), une connexion HTTP 1.0 sera ouverte avec le serveur
    sp&eacute;cifi&eacute;, et le texte de la r&eacute;ponse sera affich&eacute;
    sur la sortie standard.
   </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
    sp&eacute;cifi&eacute; et la r&eacute;ponse du serveur est affich&eacute;e.
    Si le serveur ne supporte les connexions passives, la requ&ecirc;te
    &eacute;chouera.
   </para>
   <para>
    Si <parameter>filename</parameter> ne commence par aucun des cas
    pr&eacute;c&eacute;dents, le fichier sera ouvert sur l'h&ocirc;te
    local, et envoy&eacute; &agrave; la sortie standard.
   </para>
   <para>
    Vous pouvez utiliser le deuxi&egrave;me param&egrave;tre optionnel
    pour explorer le dossier <link linkend="ini.include-path">include_path</link>,
    en passant la valeur de 1.
   </para>
   <para>
    Voir aussi
    <function>fpassthru</function>,
    <function>file</function>,
    <function>fopen</function>,
    <function>include</function>,
    <function>require</function> et
    <function>virtual</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.readlink">
  <refnamediv>
   <refname>readlink</refname>
   <refpurpose>
    Renvoie le nom du fichier vers lequel pointe un lien symbolique.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>readlink</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>readlink</function> fait la m&ecirc;me chose que la fonction
    readlink en C : elle retourne le contenu du lien symbolique
    rep&eacute;r&eacute; par <parameter>path</parameter>,
    ou &false; en cas d'erreur.
   </para>
   <para>
    Voir aussi
    <function>symlink</function>,
    <function>readlink</function> et
    <function>linkinfo</function>.
   </para>
   <note>
    <simpara>
     <function>readlink</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.rename">
  <refnamediv>
   <refname>rename</refname>
   <refpurpose>Renomme un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>rename</methodname>
     <methodparam><type>string</type><parameter>oldname</parameter></methodparam>
     <methodparam><type>string</type><parameter>newname</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>rename</function> rente de renommer le fichier
    <parameter>oldname</parameter> en <parameter>newname</parameter>.
   </para>
   <para>
    <function>rename</function> retourne &true; en cas de succ&egrave;s
    et &false; sinon.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.rewind">
  <refnamediv>
   <refname>rewind</refname>
   <refpurpose>Replace le pointeur de fichier au d&eacute;but.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>rewind</methodname>
     <methodparam><type>int</type><parameter>fp</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>rewind</function> replace le pointeur du fichier
    <parameter>fp</parameter> au d&eacute;but.
   </para>
   <para>
    Si une erreur survient, retourne &false;.
   </para>
   <para>
    Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute;
    correctement ouvert par <function>fopen</function>.
   </para>
   <para>
    Voir aussi
    <function>fseek</function> et
    <function>ftell</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.rmdir">
  <refnamediv>
   <refname>rmdir</refname>
   <refpurpose>Efface un dossier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>rmdir</methodname>
     <methodparam><type>string</type><parameter>dirname</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>rmdir</function> tente d'effacer le dossier dont le chemin est
    <parameter>dirname</parameter>. Le dossier doit &ecirc;tre vide,
    et le script doit avoir les autorisations ad&eacute;quates.
   </para>
   <para>
    Si une erreur survient, <function>rmdir</function> retourne &false;.
   </para>
   <para>
    Voir aussi
    <function>mkdir</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.stat">
  <refnamediv>
   <refname>stat</refname>
   <refpurpose>Renvoie les informations &agrave; propos d'un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>stat</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>stat</function> renvoie les informations &agrave; propos du
    fichier filename.
   </para>
   <para>
    <function>stat</function> retourne un tableau avec les &eacute;l&eacute;ments suivants :
    <itemizedlist>
     <listitem><simpara>0 : volume </simpara></listitem>
     <listitem><simpara>1 : inode</simpara></listitem>
     <listitem>
      <simpara>
       2 : droits d'acc&egrave;s au fichier (mode de protection du inode).
       A convertir en octal. Voir aussi <function>fileperms</function>.
      </simpara>
     </listitem>
     <listitem><simpara>3 : nombre de liens </simpara></listitem>
     <listitem><simpara>4 : id de l'utilisateur propri&eacute;taire </simpara></listitem>
     <listitem><simpara>5 : id du groupe propri&eacute;taire</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&egrave;s </simpara></listitem>
     <listitem><simpara>9 : date de la derni&egrave;re modification </simpara></listitem>
     <listitem><simpara>10 : date du dernier changement </simpara></listitem>
     <listitem><simpara>11 : taille de bloc du syst&egrave;me pour les entr&eacute;es/sorties * </simpara></listitem>
     <listitem><simpara>12 : nombre de blocs allou&eacute;s</simpara></listitem>
    </itemizedlist>
    * - uniquement sur les syst&egrave;mes qui supportent le type st_blksize.
    Les autres syst&egrave;mes (i.e. Windows) retournent -1.
   </para>
   <para>
    <function>stat</function> retourne &false; en cas d'erreur.
   </para>
   <para>
    <function>stat</function> ne g&egrave;re pas les URL comme peut le
    faire <function>fopen</function>.
   </para>
   <para>
    Les r&eacute;sultats de <function>stat</function> sont mis en cache.
    Reportez-vous &agrave; la fonction <function>clearstatcache</function> pour
    plus de d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.lstat">
  <refnamediv>
   <refname>lstat</refname>
   <refpurpose>
    Renvoie les informations &agrave; propos d'un fichier ou d'un lien symbolique.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>lstat</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>lstat</function> est identique &agrave; <function>stat</function>
    mais elle accepte aussi un lien symbolique comme argument.
   </para>
   <para>
    <function>lstat</function> retourne un tableau avec les &eacute;l&eacute;ments suivants :
    <itemizedlist>
     <listitem><simpara>0 : volume </simpara></listitem>
     <listitem><simpara>1 : inode</simpara></listitem>
     <listitem>
      <simpara>
       2 : droits d'acc&egrave;s au fichier (mode de protection du inode).
       A convertir en octal. Voir aussi <function>fileperms</function>.
      </simpara>
     </listitem>
     <listitem><simpara>3 : nombre de liens </simpara></listitem>
     <listitem><simpara>4 : id de l'utilisateur propri&eacute;taire </simpara></listitem>
     <listitem><simpara>5 : id du groupe propri&eacute;taire</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&egrave;s </simpara></listitem>
     <listitem><simpara>9 : date de la derni&egrave;re modification </simpara></listitem>
     <listitem><simpara>10 : date du dernier changement </simpara></listitem>
     <listitem><simpara>11 : taille de bloc du syst&egrave;me pour les entr&eacute;es/sorties * </simpara></listitem>
     <listitem><simpara>12 : nombre de blocs allou&eacute;s</simpara></listitem>
    </itemizedlist>
    * - uniquement sur les syst&egrave;mes qui supportent le type st_blksize.
    Les autres syst&egrave;mes (i.e. Windows) retournent -1.
   </para>
   <para>
    Les r&eacute;sultats de <function>lstat</function> sont mis en cache.
    Reportez-vous &agrave; la fonction <function>clearstatcache</function>
    pour plus de d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.realpath">
  <refnamediv>
   <refname>realpath</refname>
   <refpurpose>Retourne le chemin canonique absolu.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>realpath</methodname>
     <methodparam><type>string</type><parameter>path</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>realpath</function> r&eacute;soud tous les liens symboliques, et
    remplace toutes les r&eacute;f&eacute;rences '/./', '/../' et  '/' de
    <parameter>path</parameter> puis retourne le chemin canonique absolu
    ainsi trouv&eacute;. Le r&eacute;sultat ne contient aucun lien symbolique,
    '/./' ou '/../'.
   </para>
   <para>
    <example>
     <title>Exemple <function>realpath</function></title>
     <programlisting role="php">
&lt;?php
  $real_path = realpath("../../index.php");
?&gt;
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.symlink">
  <refnamediv>
   <refname>symlink</refname>
   <refpurpose>Cr&eacute;e un lien symbolique.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>symlink</methodname>
     <methodparam><type>string</type><parameter>target</parameter></methodparam>
     <methodparam><type>string</type><parameter>link</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>symlink</function> cr&eacute;e un lien symbolique pour l'objet
    <parameter>target</parameter> avec le nom de <parameter>link</parameter>.
   </para>
   <para>
    Voir aussi
    <function>link</function> pour cr&eacute;er des liens durs et
    <function>readlink</function> ainsi que <function>linkinfo</function>.
   </para>
   <note>
    <simpara>
     <function>symlink</function> est inop&eacute;rante sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.tempnam">
  <refnamediv>
   <refname>tempnam</refname>
   <refpurpose>Cr&eacute;e un fichier avec un nom unique.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>tempnam</methodname>
     <methodparam><type>string</type><parameter>dir</parameter></methodparam>
     <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>tempnam</function> cr&eacute;e un fichier temporaire unique
    dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas,
    <function>tempnam</function> va g&eacute;n&eacute;rer un nom de fichier
    dans le dossier temporaire du syst&egrave;me.
   </para>
   <para>
    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
    la cha&icirc;ne &null; en cas d'&eacute;chec.
    <example>
     <title>Exemple avec <function>tempnam</function></title>
     <programlisting role="php">
&lt;?php
  $tmpfname = tempnam("/tmp", "FOO");
?&gt;
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.tmpfile">
  <refnamediv>
   <refname>tmpfile</refname>
   <refpurpose>Cr&eacute;e un fichier temporaire</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>tmpfile</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>tmpfile</function> cr&eacute;e un fichier temporaire
    avec un nom unique, ouvert en &eacute;criture, et retourne un
    pointeur de fichier, identique &agrave; ceux retourn&eacute;s par
    <function>fopen</function>.
    Ce fichier sera automatiquement effac&eacute; lorsqu'il sera
    ferm&eacute; (avec <function>fclose</function>), ou lorsque le script
    sera termin&eacute;.
   </para>
   <para>
    Pour plus de d&eacute;tails, consultez votre documentation syst&egrave;me
    sur la fonction <literal>tmpfile(3)</literal>, et sur
    <filename>stdio.h</filename>.
   </para>
   <para>
    Voir aussi
    <function>tempnam</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.touch">
  <refnamediv>
   <refname>touch</refname>
   <refpurpose>
    Affecte une nouvelle date de modification &agrave; un fichier.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>touch</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     <methodparam><type>int</type><parameter>time</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>touch</function> tente de forcer la date de modification du fichier
    nomm&eacute; <parameter>filename</parameter> &agrave; la date de
    <parameter>time</parameter>. Si <parameter>time</parameter> est omis,
    c'est l'heure courante qui est utilis&eacute;e.
   </para>
   <para>
    Si le fichier n'existe pas, il est cr&eacute;&eacute;.
   </para>
   <para>
    <function>touch</function> retourne &true; en cas de succ&egrave;s,
    et &false; sinon.
    <example>
     <title>Exemple avec <function>touch</function></title>
     <programlisting role="php">
if ( touch($NomDeFichier) ) {
  print "La date de modification de $NomDeFichier a &eacute;t&eacute; fix&eacute;e &agrave; maintenant";
} else {
  print "D&eacute;sol&eacute;, il est impossible de changer la date de modification de $NomDeFichier";
}
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.umask">
  <refnamediv>
   <refname>umask</refname>
   <refpurpose>Change le "umask" courant.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>umask</methodname>
     <methodparam><type>int</type><parameter>mask</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>umask</function> change le umask de PHP : mask &amp; 0777 et retourne le
    vieux umask. Lorsque PHP est utilis&eacute; comme module de serveur,
    le umask reprend sa valeur &agrave; la fin de chaque script.
   </para>
   <para>
    <function>umask</function> appel&eacute; sans argument retourne simplement le
    umask courant.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.unlink">
  <refnamediv>
   <refname>unlink</refname>
   <refpurpose>Efface un fichier.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>unlink</methodname>
     <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>unlink</function> efface <parameter>filename</parameter>.
    Identique &agrave; la fonction Unix C unlink().
   </para>
   <para>
    <function>unlink</function> retourne &false; en cas
    d'&eacute;chec.
   </para>
   <para>
    Voir aussi
    <function>rmdir</function> pour supprimer des dossiers.
   </para>
   <note>
    <simpara>
     <function>unlink</function> ne fonctionne pas sous Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->