cvs: phpdoc /fr/functions filesystem.xml
| From: | Damien Seguy | Date: | Mon, 07 May 2001 13:08:59 +0000 |
| Subject: | cvs: phpdoc /fr/functions filesystem.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969335197@lists.php.net to get a copy of this message | ||
dams Mon May 7 06:08:59 2001 EDT
Modified files:
/phpdoc/fr/functions filesystem.xml
Log:
Reinserting those pesky illegal char (Egon : -> e was the best guess, thanks).
Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.21 phpdoc/fr/functions/filesystem.xml:1.22 --- phpdoc/fr/functions/filesystem.xml:1.21 Mon May 7 01:37:54 2001 +++ phpdoc/fr/functions/filesystem.xml Mon May 7 06:08:58 2001 @@ -1,514 +1,515 @@ - <reference id="ref.filesystem"> - <title>Système de fichiers</title> - <titleabbrev>Système de fichiers</titleabbrev> - <refentry id="function.basename"> - <refnamediv> - <refname>basename</refname> - <refpurpose> - Sépare le nom du fichier et le nom du dossier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>basename</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>basename</function> prend en paramètre le chemin complet - d'un fichier et en extrait le nom du fichier. - </para> - <para> - Sous Windows, les caractères (<literal>/</literal>) et antislash - (<literal>\</literal>) sont utilisés comme séparateur de - dossier. Sous les autres OS, seul le caractère slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>basename</function></title> - <programlisting role="php"> +<reference id="ref.filesystem"> + <title>Système de fichiers</title> + <titleabbrev>Système de fichiers</titleabbrev> + <refentry id="function.basename"> + <refnamediv> + <refname>basename</refname> + <refpurpose> + Sépare le nom du fichier et le nom du dossier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>basename</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>basename</function> prend en paramètre le chemin complet + d'un fichier et en extrait le nom du fichier. + </para> + <para> + Sous Windows, les caractères (<literal>/</literal>) et antislash + (<literal>\</literal>) sont utilisés comme séparateur de + dossier. Sous les autres OS, seul le caractère slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>basename</function></title> + <programlisting role="php"> <?php $path = "/home/httpd/html/index.php3"; $file = basename($path); // $file est affecté avec "index.php3" ?> - </programlisting> - </example> - </para> - <para> - Voir aussi: <function>dirname</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.chgrp"> - <refnamediv> - <refname>chgrp</refname> - <refpurpose>Change le groupe possesseur du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chgrp</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>mixed <parameter>group</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chgrp</function> essaie de changer le groupe propriétaire - du fichier. Seul le superuser (root) peut changer le groupe propriétaire - d'un fichier arbitrairement. Les utilisateurs classiques ne peuvent changer - le groupe propriétaire d'un fichier que si l'utilisateur - propriétaire du fichier est membre du groupe. - </para> - <para> - <function>chgrp</function> renvoie <literal>TRUE</literal> en - cas de succès, sinon renvoie <literal>FALSE</literal>. - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chmod</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chmod</function> remplace le mode du fichier - <parameter>filename</parameter> par le mode <parameter>mode</parameter>. - </para> - <para> - Il est à noter que le mode <parameter>mode</parameter> est - considéré comme un nombre en notation octale. Afin de - vous en assurer, vous pouvez préfixer cette valeur par un - zéro (<parameter>mode</parameter>): - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi: <function>dirname</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.chgrp"> + <refnamediv> + <refname>chgrp</refname> + <refpurpose>Change le groupe possesseur du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chgrp</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>mixed <parameter>group</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chgrp</function> essaie de changer le groupe propriétaire + du fichier. Seul le superuser (root) peut changer le groupe propriétaire + d'un fichier arbitrairement. Les utilisateurs classiques ne peuvent changer + le groupe propriétaire d'un fichier que si l'utilisateur + propriétaire du fichier est membre du groupe. + </para> + <para> + <function>chgrp</function> renvoie <literal>TRUE</literal> en + cas de succès, sinon renvoie <literal>FALSE</literal>. + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chmod</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chmod</function> remplace le mode du fichier + <parameter>filename</parameter> par le mode <parameter>mode</parameter>. + </para> + <para> + Il est à noter que le mode <parameter>mode</parameter> est + considéré comme un nombre en notation octale. Afin de + vous en assurer, vous pouvez préfixer cette valeur par un + zéro (<parameter>mode</parameter>): + <informalexample> + <programlisting role="php"> <?php chmod( "/somedir/somefile", 755 ); // notation décimale; probablement <literal>FALSE</literal> chmod( "/somedir/somefile", 0755 ); // notation octale; valeur du mode correcte ?> - </programlisting> - </informalexample> - </para> - <para> - <function>chmod</function> renvoie <literal>TRUE</literal> - en cas de succès, <literal>FALSE</literal> sinon. - </para> - <para> - Voir aussi <function>chown</function> et <function>chgrp</function>. - </para> - <note> - <simpara> + </programlisting> + </informalexample> + </para> + <para> + <function>chmod</function> renvoie <literal>TRUE</literal> + en cas de succès, <literal>FALSE</literal> 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étaire du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chown</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>mixed <parameter>user</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chown</function> change le groupe propriétaire du fichier. - Seul le superutilisateur (root) peut changer le propriétaire d'un fichier. - </para> - <para> - <function>chown</function> renvoie <literal>TRUE</literal> - en cas de succès, "<literal>FALSE</literal>" sinon. - <note> - <simpara> - Sous Windows, ne fait rien et retourne <literal>TRUE</literal>. - </simpara> - </note> - </para> - <para> - Voir aussi - <function>chown</function> et - <function>chmod</function>. - </para> + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.chown"> + <refnamediv> + <refname>chown</refname> + <refpurpose>Change le groupe propriétaire du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chown</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>mixed <parameter>user</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chown</function> change le groupe propriétaire du fichier. + Seul le superutilisateur (root) peut changer le propriétaire d'un fichier. + </para> + <para> + <function>chown</function> renvoie <literal>TRUE</literal> + en cas de succès, "<literal>FALSE</literal>" sinon. <note> <simpara> - <function>chown</function> est inopérante sous Windows. + Sous Windows, <function>chown</function> ne fait rien et + retourne <literal>TRUE</literal>. </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> - <funcsynopsis> - <funcdef>void <function>clearstatcache</function></funcdef> - <paramdef>void</paramdef> - </funcsynopsis> - <para> - L'appel à la fonction <systemitem>stat</systemitem> ou - <systemitem>lstat</systemitem> est relativement coûteux en terme de - temps d'exécution. Pour cela, le résultat du dernier - appel à l'une des fonctions de statut, (voir la liste ci-dessous), est - sauvegardé pour ré-utilisation ultérieure. Si vous voulez - forcer la vérification du statut d'un fichier, dans le cas ooúugrave; le - fichier aurait pu être modifié ou aurait disparu, vous - devez utiliser la fonction <function>clearstatcache</function> - afin d'effacer de la mémoire les résultats du dernier - appel à la fonction. - </para> - <para> - La valeur du cache n'est valable que pour la durée d'une requête. - </para> - <para> - Les fonctions affecté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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>copy</function></funcdef> - <paramdef>string <parameter>source</parameter></paramdef> - <paramdef>string <parameter>dest</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>copy</function> fait une copie du fichier. Elle renvoie <literal>TRUE</literal> en - cas de succès, <literal>FALSE</literal> sinon. - <example> - <title>Exemple avec <function>copy</function></title> - <programlisting role="php"> + </para> + <para> + Voir aussi + <function>chown</function> et + <function>chmod</function>. + </para> + <note> + <simpara> + <function>chown</function> est inopé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> + <funcsynopsis> + <funcdef>void <function>clearstatcache</function></funcdef> + <paramdef>void</paramdef> + </funcsynopsis> + <para> + L'appel à la fonction <systemitem>stat</systemitem> ou + <systemitem>lstat</systemitem> est relativement coûteux en terme de + temps d'exécution. Pour cela, le résultat du dernier + appel à l'une des fonctions de statut, (voir la liste ci-dessous), est + sauvegardé pour ré-utilisation ultérieure. Si vous voulez + forcer la vérification du statut d'un fichier, dans le cas ooúugrave; le + fichier aurait pu être modifié ou aurait disparu, vous + devez utiliser la fonction <function>clearstatcache</function> + afin d'effacer de la mémoire les résultats du dernier + appel à la fonction. + </para> + <para> + La valeur du cache n'est valable que pour la durée d'une requête. + </para> + <para> + Les fonctions affecté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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>copy</function></funcdef> + <paramdef>string <parameter>source</parameter></paramdef> + <paramdef>string <parameter>dest</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>copy</function> fait une copie du fichier. Elle renvoie <literal>TRUE</literal> en + cas de succès, <literal>FALSE</literal> 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éussi...<br>\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> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>delete</function></funcdef> - <paramdef>string <parameter>file</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Ceci est une fausse entré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, - <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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dirname</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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és comme séparateurs - de dossier. Dans les autres environnements, seul le slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>dirname</function></title> - <programlisting role="php"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>delete</function></funcdef> + <paramdef>string <parameter>file</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Ceci est une fausse entré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, + <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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dirname</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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és comme séparateurs + de dossier. Dans les autres environnements, seul le slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>dirname</function></title> + <programlisting role="php"> <?php $path = "/etc/passwd"; $file = dirname($path); // $file contient "/etc" ?> - </programlisting> - </example> - </para> - <para> - Voir aussi: <function>basename</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.diskfreespace"> - <refnamediv> - <refname>diskfreespace</refname> - <refpurpose> - Renvoie l'espace disque disponible dans le répertoire. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>diskfreespace</function></funcdef> - <paramdef>string <parameter>directory</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>diskfreespace</function> retournera le nombre d'octets disponible sur - le disque correspondant contenant le dossier <parameter>directory</parameter>. - </para> - <para> - <example> - <title>Exemple avec <function>diskfreespace</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi: <function>basename</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.diskfreespace"> + <refnamediv> + <refname>diskfreespace</refname> + <refpurpose> + Renvoie l'espace disque disponible dans le répertoire. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>diskfreespace</function></funcdef> + <paramdef>string <parameter>directory</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>diskfreespace</function> retournera le nombre d'octets disponible sur + le disque correspondant contenant le dossier <parameter>directory</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>diskfreespace</function></title> + <programlisting role="php"> <?php $df = diskfreespace("/"); // $df contient le nombre d'octets libres sur "/" ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.fclose"> - <refnamediv> - <refname>fclose</refname> - <refpurpose>Ferme un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.fclose"> + <refnamediv> + <refname>fclose</refname> + <refpurpose>Ferme un fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>fclose</function></funcdef> <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fclose</function> ferme le fichier <parameter>fp</parameter>. - </para> - <para> - <function>fclose</function> retourne <literal>TRUE</literal> en cas de succès, - et <literal>FALSE</literal> en cas d'échec. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>feof</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>feof</function> retourne <literal>TRUE</literal> si le pointeur - <parameter>fp</parameter> est à la fin du fichier, ou si - une erreur survient, sinon, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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énéré dans un fichier - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fflush</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fflush</function> forces l'écriture de toutes les - données bufferisées dans le fichier désigné - par <parameter>fp</parameter>. <function>fflush</function> retourne - <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> - 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ère que pointe le pointeur du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgetc</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fgetc</function> retourne une chaîne contenant un - seul caractère, lu depuis le fichier pointé par - <parameter>fp</parameter>. <function>fgetc</function> retourne - <literal>FALSE</literal> à la fin du fichier - (tout comme <function>feof</function>). - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> + </funcprototype> + </funcsynopsis> + <para> + <function>fclose</function> ferme le fichier <parameter>fp</parameter>. + </para> + <para> + <function>fclose</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>feof</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>feof</function> retourne <literal>TRUE</literal> si le pointeur + <parameter>fp</parameter> est à la fin du fichier, ou si + une erreur survient, sinon, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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énéré dans un fichier + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fflush</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fflush</function> forces l'écriture de toutes les + données bufferisées dans le fichier désigné + par <parameter>fp</parameter>. <function>fflush</function> retourne + <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> + 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ère que pointe le pointeur du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgetc</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fgetc</function> retourne une chaîne contenant un + seul caractère, lu depuis le fichier pointé par + <parameter>fp</parameter>. <function>fgetc</function> retourne + <literal>FALSE</literal> à la fin du fichier + (tout comme <function>feof</function>). + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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 sur laquelle se trouve le pointeur du fichier et cherche dans le résultat les champs CSV - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>fgetcsv</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>string + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>fgetcsv</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter> - <optional>delimiter</optional> + <optional>delimiter</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Identique à <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élimiteur de champs - <parameter>delimiter</parameter> est la virgule, à moins que vous ne - fournissiez un troisième argument. - </simpara> - <simpara> - <parameter>fp</parameter> doit être un pointeur valide, et avoir - été correctement ouvert par <function>fopen</function>, - <function>popen</function>, ou <function>fsockopen</function>. - </simpara> - <simpara> - <parameter>length</parameter> doit être plus grand que la plus - grande ligne trouvée dans un fichier CSV (en comptant les - caractères de fin de ligne). - </simpara> - <simpara> - <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas d'erreur, ou en cas - de fin du fichier. - </simpara> - <simpara> - Note : une ligne vide dans un fichier CSV sera retournée dans le - tableau comme une chaîne vide, et ne sera pas traitée comme - une erreur. - </simpara> - <example> - <title> - Exemple avec <function>fgetcsv</function> une ligne vide dans un fichier - CSV sera retournée dans le tableau comme une chaîne vide, et - ne sera pas traitée comme une erreur. - </title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <simpara> + Identique à <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élimiteur de champs + <parameter>delimiter</parameter> est la virgule, à moins que vous ne + fournissiez un troisième argument. + </simpara> + <simpara> + <parameter>fp</parameter> doit être un pointeur valide, et avoir + été correctement ouvert par <function>fopen</function>, + <function>popen</function>, ou <function>fsockopen</function>. + </simpara> + <simpara> + <parameter>length</parameter> doit être plus grand que la plus + grande ligne trouvée dans un fichier CSV (en comptant les + caractères de fin de ligne). + </simpara> + <simpara> + <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas d'erreur, ou en cas + de fin du fichier. + </simpara> + <simpara> + Note : une ligne vide dans un fichier CSV sera retournée dans le + tableau comme une chaîne vide, et ne sera pas traitée comme + une erreur. + </simpara> + <example> + <title> + Exemple avec <function>fgetcsv</function> une ligne vide dans un fichier + CSV sera retournée dans le tableau comme une chaîne vide, et + ne sera pas traitée comme une erreur. + </title> + <programlisting role="php"> <?php $row = 1; $fp = fopen ("test.csv","r"); @@ -522,53 +523,53 @@ } fclose ($fp); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgets</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fgets</function> retourne la chaîne lue jusqu'à - la longueur <parameter>length</parameter> - 1 octets, ou bien la fin du - fichier, ou encore un retour chariot (le premier des trois qui sera - rencontré). - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Erreur courante : - </para> - <simpara> - Les programmeurs habitués à la programmation 'C' noteront que - <function>fgets</function> ne se comporte pas comme son équivalent C - lors de la rencontre de la fin du fichier. - </simpara> - <simpara> - <parameter>fp</parameter> doit être valide, et avoir été - 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"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgets</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fgets</function> retourne la chaîne lue jusqu'à + la longueur <parameter>length</parameter> - 1 octets, ou bien la fin du + fichier, ou encore un retour chariot (le premier des trois qui sera + rencontré). + </para> + <para> + Si une erreur survient, <function>fgets</function> retourne <literal>FALSE</literal>. + </para> + <para> + Erreur courante : + </para> + <simpara> + Les programmeurs habitués à la programmation 'C' noteront que + <function>fgets</function> ne se comporte pas comme son équivalent C + lors de la rencontre de la fin du fichier. + </simpara> + <simpara> + <parameter>fp</parameter> doit être valide, et avoir été + 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"> <?php $fd = fopen ("/tmp/inputfile.txt", "r"); while (!feof($fd)) { @@ -577,94 +578,94 @@ } fclose ($fd); ?> - </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 courant sur laquelle se trouve le pointeur du fichier et - élimine les balises HTML - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgetss</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>string + </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 courant sur laquelle se trouve le pointeur du fichier et + élimine les balises HTML + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgetss</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter> - <optional>allowable_tags</optional> + <optional>allowable_tags</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <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éciser les balises qui seront ignorées dans - le troisième paramètre, optionnel. - <note> - <para> - <parameter>allowable_tags</parameter> a été ajouté 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ésultat dans un tableau. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int + </funcprototype> + </funcsynopsis> + <para> + Identique à <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éciser les balises qui seront ignorées dans + le troisième paramètre, optionnel. + <note> + <para> + <parameter>allowable_tags</parameter> a été ajouté 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ésultat dans un tableau. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter><optional>use_include_path</optional></parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <function>readfile</function>, hormis le fait que - <function>file</function> retourne le fichier dans un tableau. Chaque - élément du tableau correspond à une ligne du fichier, - et les retour chariots sont placés en fin de ligne. - </para> - <para> - Vous pouvez utiliser l'option et en la mettant à "1", si vous voulez - rechercher aussi dans le dossier <link linkend="ini.include-path">include_path</link>. - </para> - <para> - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + Identique à <function>readfile</function>, hormis le fait que + <function>file</function> retourne le fichier dans un tableau. Chaque + élément du tableau correspond à une ligne du fichier, + et les retour chariots sont placés en fin de ligne. + </para> + <para> + Vous pouvez utiliser l'option et en la mettant à "1", si vous voulez + rechercher aussi dans le dossier <link linkend="ini.include-path">include_path</link>. + </para> + <para> + <informalexample> + <programlisting role="php"> <?php // Lire une page web dans un tableau, et l'afficher $fcontents = file( 'http://www.php.net' ); @@ -674,686 +675,686 @@ // lire une page web dans une chaîne $fcontents = join( '', file( 'http://www.php.net' ) ); ?> - </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érifie si un fichier existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>file_exists</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>file_exists</function> retourne <literal>TRUE</literal> si le fichier - <parameter>filename</parameter> existe, et <literal>FALSE</literal> sinon. - </simpara> - <simpara> - <function>file_exists</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <simpara> - Le résultat de <function>file_exists</function> est mis en cache. - Reportez-vous à <function>clearstatcache</function> pour - plus de détails. - </simpara> - </refsect1> - </refentry> - <refentry id="function.fileatime"> - <refnamediv> - <refname>fileatime</refname> - <refpurpose> - Renvoie la date à laquelle le fichier a été - accédé pour la dernière fois. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileatime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fileatime</function> renvoie la date à laquelle le fichier - a été accédé pour la dernière fois, ou - <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <simpara> - Le résultat de <function>fileatime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </simpara> - </refsect1> - </refentry> - <refentry id="function.filectime"> - <refnamediv> - <refname>filectime</refname> - <refpurpose> - Renvoie l'heure à laquelle l'inode a été - accédé pour la dernière fois. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filectime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filectime</function> renvoie l'heure à laquelle l'inode - <parameter>filename</parameter> a été accédé pour - la dernière fois, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Note: Sur la plus part des serveurs UNIX, un fichier est considéré - comme modifié si les données de sont inode sont modifiées. C'est à - dire lorsque les permissions (utilisateur, group ou autre) ont - été modifiées. Voyez aussi <function>filemtime</function> - (que vous pourrez utiliser lorsque vous créerez des indications - telles que "Dernière modification : " sur les pages web) et - <function>fileatime</function>. - </para> - <para> - Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier - texte est considéré comme sa date de création. Cela est faux! - Il n'y a pas de date de création de fichier sous la plus part - des systèmes UNIX. - </para> - <para> - Le résultat de <function>filectime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filegroup"> - <refnamediv> - <refname>filegroup</refname> - <refpurpose>Lire le nom du groupe</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filegroup</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filegroup</function> renvoie le groupe qui possède le fichier - <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur. - L'identifiant de groupe est retourné au format numérique, utilisez - <function>posix_getgrgid</function> pour retrouver le nom du groupe. - </para> - <simpara> - <function>filegroup</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filegroup</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <note> - <simpara> - <function>filegroup</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.fileinode"> - <refnamediv> - <refname>fileinode</refname> - <refpurpose>Renvoie le numéro d'inode du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileinode</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileinode</function> renvoie le numéro d'inode du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. - </para> - <para> - Le résultat de <function>fileinode</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>fileinode</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <note> - <simpara> - <function>fileinode</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.filemtime"> - <refnamediv> - <refname>filemtime</refname> - <refpurpose> - Renvoie la date de dernière modification du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filemtime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filemtime</function> renvoie la date de dernière - modification du fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> - en cas d'erreur. - </para> - <para> - Le résultat de <function>filemtime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>filemtime</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Note: <function>filemtime</function> retourne l'heure d'écriture - des blocs données d'un fichier. Utilisez <function>date</function> - sur ce résultat pour obtenir une date de modification humainement - lisible. - </para> - </refsect1> - </refentry> - <refentry id="function.fileowner"> - <refnamediv> - <refname>fileowner</refname> - <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileowner</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileowner</function> renvoie le nom du possesseur du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. - L'identification du possesseur de fichier est numé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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>fileowner</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <note> - <simpara> - <function>fileowner</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.fileperms"> - <refnamediv> - <refname>fileperms</refname> - <refpurpose> - Renvoie les permissions affectées au fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileperms</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileperms</function> renvoie les permissions affectées - au fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> - 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>fileperms</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filesize"> - <refnamediv> - <refname>filesize</refname> - <refpurpose>Renvoie la taille du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filesize</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filesize</function> renvoie la taille du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filesize</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus - de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filetype"> - <refnamediv> - <refname>filetype</refname> - <refpurpose>Retourne le type de fichier</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>filetype</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filetype</function> renvoie le type du fichier - <parameter>filename</parameter>. Les réponses possibles sont : - fifo, char, dir, block, link, file, et unknown. - </para> - <para> - <function>filetype</function> retourne <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filetype</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.flock"> - <refnamediv> - <refname>flock</refname> - <refpurpose>Verrouille le fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>flock</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>operation</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - PHP dispose d'un système complet de verrouillage de fichiers. - Tous les programmes qui accèdent au fichier doivent utiliser la - même méthode de verrouillage pour qu'il soit efficace. - </simpara> - <simpara> - <function>flock</function> agit sur le fichier <parameter>fp</parameter> - qui doit avoir été ouvert au pré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 (écriture), - <parameter>operation</parameter> = 2. - </simpara> - </listitem> - <listitem> - <simpara> - Libération d'un verrou (partagé 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 à <parameter>operation</parameter>. - </simpara> - </listitem> - </itemizedlist> - </para> - <simpara> - <function>flock</function> permet de réaliser un système simple de - verrous écriture / lecture, qui peut être utilisé sur - n'importe quelle plate-forme (Unix et Windows compris). - </simpara> - <simpara> - <function>flock</function> retourne <literal>TRUE</literal> en cas - de succès, et <literal>FALSE</literal> - sinon. (le verrou n'a pas pu être obtenu). - </simpara> - <warning> - <para> - Sur la plus part des OS, <function>flock</function> est implémenté - au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, - comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> - pour protéger vos fichiers contre des accès concurents du - mê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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fopen</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>int - <parameter> - <optional>use_include_path</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Si <parameter>filename</parameter> commence par "http://" (insensible à - la casse), une connexion HTTP 1.x est ouverte avec le serveur - spécifié, et un pointeur sur la réponse fournie est - retourné. - </simpara> - <simpara> - Attention, <function>fopen</function> ne gère pas les redirections, - ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "ftp://" (insensible à - la casse), une connexion FTP est ouverte avec le serveur spécifié, - et un pointeur sur la réponse fournie est retourné. Si le serveur - ne supporte par le mode FTP passif, <function>fopen</function> échouera. - Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture - seulement (le full duplex n'est pas supporté). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", - ou "php://stderr", le flot correspondant sera ouvert. (Cela a été - introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" - ou "/dev/fd/0" devaient être utilisés pour accéder à - ces flots). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP - tentera de lire ce fichier dans le système local, et un pointeur sur - le fichier ouvert sera retourné. - </simpara> - <simpara> - Si l'ouverture échoue, <function>fopen</function> retourne - <literal>FALSE</literal>. - </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ébut du fichier. - </simpara> - </listitem> - <listitem> - <simpara> - 'r+' - Ouvre en lecture et écriture, et place le pointeur de - fichier au début du fichier. - </simpara> - </listitem> - <listitem> - <simpara> - 'w' - Ouvre en écriture seule; place le pointeur de fichier au - début du fichier et réduit la taille du fichier à 0. - Si le fichier n'existe pas, on tente de le créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'w+' - Ouvre en lecture et écriture; place le pointeur de fichier - au début du fichier et réduit la taille du fichier à - 0. Si le fichier n'existe pas, on tente de le créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'a' - Ouvre en écriture seule; place le pointeur de fichier à - la fin du fichier file. Si le fichier n'existe pas, on tente de le - créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'a+' - Ouvre en lecture et écriture; place le pointeur de fichier - à la fin du fichier. Si le fichier n'existe pas, on tente de le - créer. - </simpara> - </listitem> - </itemizedlist> - De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option - n'est utile que sur les systèmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - Si il n'est pas nécessaire, il sera ignoré. - </para> - <para> - Vous pouvez utiliser le troisième paramètre optionnel - pour explorer le dossier <link linkend="ini.include-path">include_path</link>, - en le mettant à 1. - </para> - <para> - <example> - <title>Exemple avec <function>fopen</function></title> - <programlisting role="php"> -<?php -$fp = fopen("/home/rasmus/file.txt", "r"); -$fp = fopen("http://www.php.net/", "r"); -$fp = fopen("ftp://user:password@example.com/", "w"); -?> - </programlisting> - </example> - </para> - <simpara> - Si vous rencontrez des problèmes en lecture ou écriture - de fichier et que vous utilisez PHP en version module de serveur, - n'oubliez pas que les fichiers auxquels vous accédez ne sont - pas nécessairement accessibles au processus serveur. - </simpara> - <para> - Sous Windows, assurez-vous de bien échapper les anti-slash - utilisés dans le chemin du fichier, ou bien utilisez des slash. - <informalexample> - <programlisting role="php"> -<?php -$fp = fopen("c:\\data\\info.txt", "r"); -?> </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érifie si un fichier existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>file_exists</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> <simpara> - Voir aussi - <function>fclose</function>, - <function>fsockopen</function>, - <function>socket_set_timeout</function> et - <function>popen</function>. + <function>file_exists</function> retourne <literal>TRUE</literal> si le fichier + <parameter>filename</parameter> existe, et <literal>FALSE</literal> sinon. + </simpara> + <simpara> + <function>file_exists</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <simpara> + Le résultat de <function>file_exists</function> est mis en cache. + Reportez-vous à <function>clearstatcache</function> pour + plus de détails. </simpara> </refsect1> </refentry> - <refentry id="function.fpassthru"> - <refnamediv> - <refname>fpassthru</refname> - <refpurpose> - Affiche la partie du fichier située après le pointeur du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fpassthru</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fpassthru</function> lit tout le reste d'un fichier - jusqu'à la fin, et dirige le résultat vers la sortie standard. - </simpara> - <simpara> - Si une erreur survient, <function>fpassthru</function> retourne <literal>FALSE</literal>. - </simpara> + <refentry id="function.fileatime"> + <refnamediv> + <refname>fileatime</refname> + <refpurpose> + Renvoie la date à laquelle le fichier a été + accédé pour la dernière fois. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileatime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fileatime</function> renvoie la date à laquelle le fichier + a été accédé pour la dernière fois, ou + <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <simpara> + Le résultat de <function>fileatime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </simpara> + </refsect1> + </refentry> + <refentry id="function.filectime"> + <refnamediv> + <refname>filectime</refname> + <refpurpose> + Renvoie l'heure à laquelle l'inode a été + accédé pour la dernière fois. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filectime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filectime</function> renvoie l'heure à laquelle l'inode + <parameter>filename</parameter> a été accédé pour + la dernière fois, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Note: Sur la plus part des serveurs UNIX, un fichier est considéré + comme modifié si les données de sont inode sont modifiées. C'est à + dire lorsque les permissions (utilisateur, group ou autre) ont + été modifiées. Voyez aussi <function>filemtime</function> + (que vous pourrez utiliser lorsque vous créerez des indications + telles que "Dernière modification : " sur les pages web) et + <function>fileatime</function>. + </para> + <para> + Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier + texte est considéré comme sa date de création. Cela est faux! + Il n'y a pas de date de création de fichier sous la plus part + des systèmes UNIX. + </para> + <para> + Le résultat de <function>filectime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filegroup"> + <refnamediv> + <refname>filegroup</refname> + <refpurpose>Lire le nom du groupe</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filegroup</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filegroup</function> renvoie le groupe qui possède le fichier + <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur. + L'identifiant de groupe est retourné au format numérique, utilisez + <function>posix_getgrgid</function> pour retrouver le nom du groupe. + </para> + <simpara> + <function>filegroup</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filegroup</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <note> <simpara> - Le pointeur de fichier doit être valide, et doit avoir été - correctement ouvert par <function>fopen</function>, <function>popen</function>, - ou <function>fsockopen</function>. Après lecture, - <function>fpassthru</function> va fermer le fichier (le pointeur - <parameter>fp</parameter> sera alors invalide). + <function>filegroup</function> est inopérante sous Windows. </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.fileinode"> + <refnamediv> + <refname>fileinode</refname> + <refpurpose>Renvoie le numéro d'inode du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileinode</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileinode</function> renvoie le numéro d'inode du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Le résultat de <function>fileinode</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>fileinode</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <note> <simpara> - Si vous voulez simplement afficher le contenu d'un fichier, il - suffit d'utiliser <function>readfile</function>, ce qui épargnera - l'appel à <function>fopen</function>. + <function>fileinode</function> est inopérante sous Windows. </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.filemtime"> + <refnamediv> + <refname>filemtime</refname> + <refpurpose> + Renvoie la date de dernière modification du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filemtime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filemtime</function> renvoie la date de dernière + modification du fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> + en cas d'erreur. + </para> + <para> + Le résultat de <function>filemtime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>filemtime</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Note: <function>filemtime</function> retourne l'heure d'écriture + des blocs données d'un fichier. Utilisez <function>date</function> + sur ce résultat pour obtenir une date de modification humainement + lisible. + </para> + </refsect1> + </refentry> + <refentry id="function.fileowner"> + <refnamediv> + <refname>fileowner</refname> + <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileowner</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileowner</function> renvoie le nom du possesseur du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. + L'identification du possesseur de fichier est numé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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>fileowner</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <note> <simpara> - Voir aussi - <function>readfile</function>, - <function>fopen</function>, - <function>popen</function> et - <function>fsockopen</function>. + <function>fileowner</function> est inopérante sous Windows. </simpara> - </refsect1> - </refentry> - <refentry id="function.fputs"> - <refnamediv> - <refname>fputs</refname> - <refpurpose>Ecrit dans un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fputs</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>string <parameter>str</parameter></paramdef> - <paramdef>int + </note> + </refsect1> + </refentry> + <refentry id="function.fileperms"> + <refnamediv> + <refname>fileperms</refname> + <refpurpose> + Renvoie les permissions affectées au fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileperms</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileperms</function> renvoie les permissions affectées + au fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> + 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>fileperms</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filesize"> + <refnamediv> + <refname>filesize</refname> + <refpurpose>Renvoie la taille du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filesize</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filesize</function> renvoie la taille du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filesize</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus + de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filetype"> + <refnamediv> + <refname>filetype</refname> + <refpurpose>Retourne le type de fichier</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>filetype</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filetype</function> renvoie le type du fichier + <parameter>filename</parameter>. Les réponses possibles sont : + fifo, char, dir, block, link, file, et unknown. + </para> + <para> + <function>filetype</function> retourne <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filetype</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.flock"> + <refnamediv> + <refname>flock</refname> + <refpurpose>Verrouille le fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>flock</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>operation</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + PHP dispose d'un système complet de verrouillage de fichiers. + Tous les programmes qui accèdent au fichier doivent utiliser la + même méthode de verrouillage pour qu'il soit efficace. + </simpara> + <simpara> + <function>flock</function> agit sur le fichier <parameter>fp</parameter> + qui doit avoir été ouvert au pré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 (écriture), + <parameter>operation</parameter> = 2. + </simpara> + </listitem> + <listitem> + <simpara> + Libération d'un verrou (partagé 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 à <parameter>operation</parameter>. + </simpara> + </listitem> + </itemizedlist> + </para> + <simpara> + <function>flock</function> permet de réaliser un système simple de + verrous écriture / lecture, qui peut être utilisé sur + n'importe quelle plate-forme (Unix et Windows compris). + </simpara> + <simpara> + <function>flock</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> + sinon. (le verrou n'a pas pu être obtenu). + </simpara> + <warning> + <para> + Sur la plus part des OS, <function>flock</function> est implémenté + au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, + comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> + pour protéger vos fichiers contre des accès concurents du + mê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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fopen</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>int <parameter> - <optional>length</optional> + <optional>use_include_path</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <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ètre optionnel, - et si il n'est pas spécifié, toute la chaîne - est é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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fread</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fread</function> lit jusqu'à <parameter>length</parameter> - octets dans le fichier reférencé par <parameter>fp</parameter>. - La lecture s'arrête lorsque <parameter>length</parameter> octets - ont été 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"> + </funcprototype> + </funcsynopsis> + <simpara> + Si <parameter>filename</parameter> commence par "http://" (insensible à + la casse), une connexion HTTP 1.x est ouverte avec le serveur + spécifié, et un pointeur sur la réponse fournie est + retourné. + </simpara> + <simpara> + Attention, <function>fopen</function> ne gère pas les redirections, + ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par "ftp://" (insensible à + la casse), une connexion FTP est ouverte avec le serveur spécifié, + et un pointeur sur la réponse fournie est retourné. Si le serveur + ne supporte par le mode FTP passif, <function>fopen</function> échouera. + Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture + seulement (le full duplex n'est pas supporté). + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", + ou "php://stderr", le flot correspondant sera ouvert. (Cela a été + introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" + ou "/dev/fd/0" devaient être utilisés pour accéder à + ces flots). + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP + tentera de lire ce fichier dans le système local, et un pointeur sur + le fichier ouvert sera retourné. + </simpara> + <simpara> + Si l'ouverture échoue, <function>fopen</function> retourne + <literal>FALSE</literal>. + </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ébut du fichier. + </simpara> + </listitem> + <listitem> + <simpara> + 'r+' - Ouvre en lecture et écriture, et place le pointeur de + fichier au début du fichier. + </simpara> + </listitem> + <listitem> + <simpara> + 'w' - Ouvre en écriture seule; place le pointeur de fichier au + début du fichier et réduit la taille du fichier à 0. + Si le fichier n'existe pas, on tente de le créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'w+' - Ouvre en lecture et écriture; place le pointeur de fichier + au début du fichier et réduit la taille du fichier à + 0. Si le fichier n'existe pas, on tente de le créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'a' - Ouvre en écriture seule; place le pointeur de fichier à + la fin du fichier file. Si le fichier n'existe pas, on tente de le + créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'a+' - Ouvre en lecture et écriture; place le pointeur de fichier + à la fin du fichier. Si le fichier n'existe pas, on tente de le + créer. + </simpara> + </listitem> + </itemizedlist> + De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option + n'est utile que sur les systèmes qui font la différence entre + les fichiers binaires et les fichiers textes (en bref, c'est une + fonctionnalité Windows, totalement inutile sous Unix). + Si il n'est pas nécessaire, il sera ignoré. + </para> + <para> + Vous pouvez utiliser le troisième paramètre optionnel + pour explorer le dossier <link linkend="ini.include-path">include_path</link>, + en le mettant à 1. + </para> + <para> + <example> + <title>Exemple avec <function>fopen</function></title> + <programlisting role="php"> +<?php +$fp = fopen("/home/rasmus/file.txt", "r"); +$fp = fopen("http://www.php.net/", "r"); +$fp = fopen("ftp://user:password@example.com/", "w"); +?> + </programlisting> + </example> + </para> + <simpara> + Si vous rencontrez des problèmes en lecture ou écriture + de fichier et que vous utilisez PHP en version module de serveur, + n'oubliez pas que les fichiers auxquels vous accédez ne sont + pas nécessairement accessibles au processus serveur. + </simpara> + <para> + Sous Windows, assurez-vous de bien échapper les anti-slash + utilisés dans le chemin du fichier, ou bien utilisez des slash. + <informalexample> + <programlisting role="php"> +<?php +$fp = fopen("c:\\data\\info.txt", "r"); +?> + </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ée après le pointeur du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fpassthru</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fpassthru</function> lit tout le reste d'un fichier + jusqu'à la fin, et dirige le résultat vers la sortie standard. + </simpara> + <simpara> + Si une erreur survient, <function>fpassthru</function> retourne <literal>FALSE</literal>. + </simpara> + <simpara> + Le pointeur de fichier doit être valide, et doit avoir été + correctement ouvert par <function>fopen</function>, <function>popen</function>, + ou <function>fsockopen</function>. Aprè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 épargnera + l'appel à <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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fputs</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>int + <parameter> + <optional>length</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <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ètre optionnel, + et si il n'est pas spécifié, toute la chaîne + est é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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fread</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fread</function> lit jusqu'à <parameter>length</parameter> + octets dans le fichier reférencé par <parameter>fp</parameter>. + La lecture s'arrête lorsque <parameter>length</parameter> octets + ont été 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"> <?php // Lit un fichier, et le place dans une chaîne $filename = "/usr/local/quelquechose.txt"; @@ -1361,76 +1362,76 @@ $contents = fread($fd, filesize ($filename)); fclose($fd); ?> - </programlisting> - </informalexample> + </programlisting> + </informalexample> + </para> + <note> + <para> + Sur les systèmes qui différentient les fichiers + textes et binaires (i.e. Windows) le fichier doit être + ouvert avec la lettre 'b' ajoutée au paramètre + de mode de la fonction <function>fopen</function>. </para> - <note> - <para> - Sur les systèmes qui différentient les fichiers - textes et binaires (i.e. Windows) le fichier doit être - ouvert avec la lettre 'b' ajoutée au paramètre - de mode de la fonction <function>fopen</function>. - </para> - </note> - <note> - <para> - <informalexample> - <programlisting role="php"> + </note> + <note> + <para> + <informalexample> + <programlisting role="php"> <?php $filename = "c:\\fichiers\\uneimage.gif"; $fd = fopen($filename, "rb"); $contents = fread($fd, filesize ($filename)); fclose($fd); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>fscanf</function></funcdef> - <paramdef>int <parameter>handle</parameter></paramdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>string - <parameter><optional>var1</optional></parameter>... - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fscanf</function> est similaire à - <function>sscanf</function>, mais elle prend comme - entrée un fichier, associé à - <parameter>handle</parameter> et l'interprète en - fonction du format <parameter>format</parameter>. Si - seulement deux paramètres sont passés - à la fonction, les valeurs parsées seront - retournées sous forme de tableau. Si des arguments - optionnels sont passés, la fonction retournera le - nombre de valeurs assignées. Les options doivent - être passées par référence. - <example> - <title>Exemple <function>fscanf</function></title> - <programlisting role="php"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>fscanf</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>string + <parameter><optional>var1</optional></parameter>... + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fscanf</function> est similaire à + <function>sscanf</function>, mais elle prend comme + entrée un fichier, associé à + <parameter>handle</parameter> et l'interprète en + fonction du format <parameter>format</parameter>. Si + seulement deux paramètres sont passés + à la fonction, les valeurs parsées seront + retournées sous forme de tableau. Si des arguments + optionnels sont passés, la fonction retournera le + nombre de valeurs assignées. Les options doivent + être passées par référence. + <example> + <title>Exemple <function>fscanf</function></title> + <programlisting role="php"> <?php $fp = fopen ("users.txt","r"); while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { @@ -1439,275 +1440,275 @@ } fclose($fp); ?> - </programlisting> - </example> - <example> - <title>users.txt</title> - <programlisting role="txt"> + </programlisting> + </example> + <example> + <title>users.txt</title> + <programlisting role="txt"> janus argonaute gr rodin sculpteur fr som 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fseek</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>offset</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fseek</function> modifie le curseur de position - dans le fichier <parameter>fp</parameter>. La nouvelle position - mesurée en octets à partir du début du fichier, - est obtenue en additionnant la distance <parameter>offset</parameter> - à la position <parameter>whence</parameter>. Ce paramè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ée à <parameter>offset</parameter> octets. - </member> - <member> - SEEK_END - La position finale vaut la position courante par rapport à - la fin du fichier, ajoutée de <parameter>offset</parameter>. - </member> - </simplelist> - </para> - <para> - Si <parameter>whence</parameter> n'est pas spécifiée, il - vaut par défaut SEEK_SET. - </para> - <para> - <function>fseek</function> retourne <literal>TRUE</literal> en cas de - succès, et sinon -1. Notez que positionner le pointeur au - delà de la fin du fichier n'est pas une erreur. + </programlisting> + </example> </para> - <para> - Ne peut pas être utilisé sur les pointeurs - retournés par <function>fopen</function> s'ils sont - au format HTTP ou FTP. - </para> + <para> + Voir aussi + <function>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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fseek</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>offset</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fseek</function> modifie le curseur de position + dans le fichier <parameter>fp</parameter>. La nouvelle position + mesurée en octets à partir du début du fichier, + est obtenue en additionnant la distance <parameter>offset</parameter> + à la position <parameter>whence</parameter>. Ce paramè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ée à <parameter>offset</parameter> octets. + </member> + <member> + SEEK_END - La position finale vaut la position courante par rapport à + la fin du fichier, ajoutée de <parameter>offset</parameter>. + </member> + </simplelist> + </para> + <para> + Si <parameter>whence</parameter> n'est pas spécifiée, il + vaut par défaut SEEK_SET. + </para> + <para> + <function>fseek</function> retourne <literal>TRUE</literal> en cas de + succès, et sinon -1. Notez que positionner le pointeur au + delà de la fin du fichier n'est pas une erreur. + </para> + <para> + Ne peut pas être utilisé sur les pointeurs + retournés par <function>fopen</function> s'ils sont + au format HTTP ou FTP. + </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 à partir d'un pointeur de fichier + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>fstat</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fstat</function> rassemble les informations sur le fichier dont on + connaît le pointeur <parameter>fp</parameter>. <function>fstat</function> + est similaire à 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 élé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étaire </simpara></listitem> + <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>7 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>8 : taille en octets </simpara></listitem> + <listitem><simpara>9 : date du dernier accès </simpara></listitem> + <listitem><simpara>10 : date de la dernière modification </simpara></listitem> + <listitem><simpara>11 : date du dernier changement </simpara></listitem> + <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> + <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize + type les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>fstat</function> sont mis en cache. + Reportez-vous à la fonction <function>clearstatcache</function> + pour plus de dé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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ftell</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftell</function> retourne la position courante du pointeur dans le + fichier repéré par le pointeur <parameter>fp</parameter>, i.e., + son offset. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ftruncate</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftruncate</function> prend le pointeur de fichier + <parameter>fp</parameter> et le tronque à la taille de + <parameter>size</parameter>.<function>ftruncate</function> retourne + <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fwrite</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>string <parameter>string</parameter></paramdef> + <paramdef>int + <parameter> + <optional>length</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fwrite</function> écrit le contenu de la chaîne + <parameter>string</parameter> dans le fichier pointé par + <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> + est fournie, l'écriture s'arrêtera après + <parameter>length</parameter> octets, ou à la fin de la + chaî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ée, et les slash seront conservés. + </simpara> + <note> <para> - Voir aussi <function>ftell</function> et <function>rewind</function>. + De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option + n'est utile que sur les systèmes qui font la différence entre + les fichiers binaires et les fichiers textes (en bref, c'est une + fonctionnalité Windows, totalement inutile sous Unix). + Si il n'est pas nécessaire, il sera ignoré. </para> - </refsect1> - </refentry> - <refentry id="function.fstat"> - <refnamediv> - <refname>fstat</refname> - <refpurpose> - Lit les informations sur un fichier à partir d'un pointeur de fichier - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>fstat</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fstat</function> rassemble les informations sur le fichier dont on - connaît le pointeur <parameter>fp</parameter>. <function>fstat</function> - est similaire à la fonction <function>stat</function>, hormis - le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier. - </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>set_file_buffer</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>buffer</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + L'écriture de fichier avec <function>fwrite</function> utilise normalement + un buffer de 8K. Cela signifie que si deux processus essaie d'écrire + dans le même fichier, ils font une pause tous les 8ko pour laisser le temps + à l'autre d'écrire à son tour. + <function>set_file_buffer</function> permet de modifier la taille du buffer de + sortie pour le pointeur de fichier <parameter>fp</parameter> à + <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, + l'écriture se fera sans buffer. Cela force l'écriture de toutes + les données par un processus avant que les autres puisse accéder + au fichier. + </simpara> + <simpara> + <function>set_file_buffer</function> retourne 0 en cas de succès, ou + EOF si la requête ne peut pas être honorée. + </simpara> <para> - <function>fstat</function> retourne un tableau avec les élé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étaire </simpara></listitem> - <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>7 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>8 : taille en octets </simpara></listitem> - <listitem><simpara>9 : date du dernier accès </simpara></listitem> - <listitem><simpara>10 : date de la dernière modification </simpara></listitem> - <listitem><simpara>11 : date du dernier changement </simpara></listitem> - <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> - <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize - type les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>fstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de dé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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ftell</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ftell</function> retourne la position courante du pointeur dans le - fichier repéré par le pointeur <parameter>fp</parameter>, i.e., - son offset. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ftruncate</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>size</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ftruncate</function> prend le pointeur de fichier - <parameter>fp</parameter> et le tronque à la taille de - <parameter>size</parameter>. La fonction retourne - <literal>TRUE</literal> en cas de succès, et - <literal>FALSE</literal> 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fwrite</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>string <parameter>string</parameter></paramdef> - <paramdef>int - <parameter> - <optional>length</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fwrite</function> écrit le contenu de la chaîne - <parameter>string</parameter> dans le fichier pointé par - <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> - est fournie, l'écriture s'arrêtera après - <parameter>length</parameter> octets, ou à la fin de la - chaî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ée, et les slash seront conservés. - </simpara> - <note> - <para> - De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option - n'est utile que sur les systèmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - Si il n'est pas nécessaire, il sera ignoré. - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>set_file_buffer</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>buffer</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - L'écriture de fichier avec <function>fwrite</function> utilise normalement - un buffer de 8K. Cela signifie que si deux processus essaie d'écrire - dans le même fichier, ils font une pause tous les 8ko pour laisser le temps - à l'autre d'écrire à son tour. - <function>set_file_buffer</function> permet de modifier la taille du buffer de - sortie pour le pointeur de fichier <parameter>fp</parameter> à - <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, - l'écriture se fera sans buffer. Cela force l'écriture de toutes - les données par un processus avant que les autres puisse accéder - au fichier. - </simpara> - <simpara> - <function>set_file_buffer</function> retourne 0 en cas de succès, ou - EOF si la requête ne peut pas être honorée. - </simpara> - <para> - L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour créer un fichier - sans buffer. - <example> - <title>Exemple avec <function>set_file_buffer</function></title> - <programlisting role="php"> + L'exemple suivant montre comment utiliser la fonction + <function>set_file_buffer</function> pour créer un fichier + sans buffer. + <example> + <title>Exemple avec <function>set_file_buffer</function></title> + <programlisting role="php"> <?php $fp=fopen($file, "w"); if($fp){ @@ -1716,1081 +1717,1079 @@ fclose($fp); } ?> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>fopen</function> - <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> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_dir</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_dir</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un dossier. - </para> - <para> - Le résultat de <function>is_dir</function> est mis en cache. Voir la fonction - <function>clearstatcache</function> pour plus de détails. - </para> - <simpara> - <function>is_dir</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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écutable.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_executable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_executable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est exécutable. - </para> - <para> - Le résultat de <function>is_executable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_executable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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éritable fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_file</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un fichier - (et pas un dossier). - </para> - <para> - Le résultat de <function>is_file</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_file</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_link</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_link</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un lien symbolique. - </para> - <para> - Le résultat de <function>is_link</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>fopen</function> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_dir</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_dir</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un dossier. + </para> + <para> + Le résultat de <function>is_dir</function> est mis en cache. Voir la fonction + <function>clearstatcache</function> pour plus de détails. + </para> + <simpara> + <function>is_dir</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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écutable.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_executable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_executable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est exécutable. + </para> + <para> + Le résultat de <function>is_executable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_executable</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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éritable fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_file</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un fichier + (et pas un dossier). + </para> + <para> + Le résultat de <function>is_file</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_file</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_link</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_link</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un lien symbolique. + </para> + <para> + Le résultat de <function>is_link</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_link</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>is_link</function> est inopérante sous Windows. </simpara> - <para> - Voir aussi - <function>is_dir</function> et - <function>is_file</function>. - </para> - <note> - <simpara> - <function>is_link</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.is-readable"> - <refnamediv> - <refname>is_readable</refname> - <refpurpose>Indique un fichier est autorisé en lecture</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_readable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_readable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est accessible en lecture. - </para> - <para> - N'oubliez pas que PHP accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est 'nobody', personne). - </para> - <para> - Le résultat de <function>is_readable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + </note> + </refsect1> + </refentry> + <refentry id="function.is-readable"> + <refnamediv> + <refname>is_readable</refname> + <refpurpose>Indique un fichier est autorisé en lecture</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_readable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_readable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est accessible en lecture. + </para> + <para> + N'oubliez pas que PHP accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est 'nobody', personne). + </para> + <para> + Le résultat de <function>is_readable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_readable</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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é en écriture.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_writable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_writable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est accessible en écriture. + </para> + <para> + N'oubliez pas que PHP accède aux fichiers avec les mê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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>is_writable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + dé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é en écriture.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_writeable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 été téléchargé + par HTTP POST + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_uploaded_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_uploaded_file</function> est disponible à partir des + versions PHP 3.0.16 et 4.0.2. + </para> + <para> + <function>is_uploaded_file</function> retourne <literal>TRUE</literal> si le fichier + <varname>filename</varname> a été téléchargé + par HTTP POST. Cela est très utile pour vous assurer qu'un + utilisateur n'essaie pas d'accéder intentionnellement à + un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). + </para> + <para> + Ce type de vérification est spécialement important si il est + possible que les fichiers téléchargés + révélent leur contenu à l'utilisateur, ou + même aux utilisateurs du même système. + </para> + <para> + Voir aussi <function>move_uploaded_file</function>, et la section + <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ée un lien.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>link</function></funcdef> + <paramdef>string <parameter>target</parameter></paramdef> + <paramdef>string <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>link</function> crée un lien. + </para> + <para> + Voir aussi <function>symlink</function> pour créer des liens + symboliques et <function>readlink</function> avec <function>linkinfo</function>. + </para> + <note> <simpara> - <function>is_readable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>link</function> est inopérante sous Windows. </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é en écriture.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_writable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_writable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est accessible en écriture. - </para> - <para> - N'oubliez pas que PHP accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est 'nobody', personne). - </para> + </note> + </refsect1> + </refentry> + <refentry id="function.linkinfo"> + <refnamediv> + <refname>linkinfo</refname> + <refpurpose>Renvoie les informations à propos d'un lien.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>linkinfo</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>linkinfo</function> renvoie les informations à propos + d'un lien le champs st_dev de la structure d'information d' UNIX + (comme en langage C). <function>linkinfo</function> sert à vérifier + si un lien (repéré par <parameter>path</parameter>) + existe (en utilisant la même méthode que la macro + S_ISLNK de stat.h). <function>linkinfo</function> retourne + <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Voir aussi <function>symlink</function>, <function>link</function>, + et <function>readlink</function>. + </para> + <note> <simpara> - <function>is_writable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>linkinfo</function> est inopérante sous Windows. </simpara> - <para> - Le résultat de <function>is_writable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - dé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é en écriture.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_writeable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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 été téléchargé - par HTTP POST - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_uploaded_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_uploaded_file</function> est disponible à partir des - versions PHP 3.0.16 et 4.0.2. - </para> - <para> - <function>is_uploaded_file</function> retourne <literal>TRUE</literal> si le fichier - <varname>filename</varname> a été téléchargé - par HTTP POST. Cela est très utile pour vous assurer qu'un - utilisateur n'essaie pas d'accéder intentionnellement à - un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). - </para> - <para> - Ce type de vérification est spécialement important si il est - possible que les fichiers téléchargés - révélent leur contenu à l'utilisateur, ou - même aux utilisateurs du même système. - </para> - <para> - Voir aussi <function>move_uploaded_file</function>, et la section - <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ée un lien.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>link</function></funcdef> - <paramdef>string <parameter>target</parameter></paramdef> - <paramdef>string <parameter>link</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>link</function> crée un lien. - </para> - <para> - Voir aussi <function>symlink</function> pour créer des liens - symboliques et <function>readlink</function> avec <function>linkinfo</function>. - </para> - <note> - <simpara> - <function>link</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.linkinfo"> - <refnamediv> - <refname>linkinfo</refname> - <refpurpose>Renvoie les informations à propos d'un lien.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>linkinfo</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>linkinfo</function> renvoie les informations à propos - d'un lien le champs st_dev de la structure d'information d' UNIX - (comme en langage C). <function>linkinfo</function> sert à vérifier - si un lien (repéré par <parameter>path</parameter>) - existe (en utilisant la même méthode que la macro - S_ISLNK de stat.h). <function>linkinfo</function> retourne - <literal>FALSE</literal> 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érante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.mkdir"> - <refnamediv> - <refname>mkdir</refname> - <refpurpose>Crée un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mkdir</function></funcdef> - <paramdef>string <parameter>pathname</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>mkdir</function> tente de créer un dossier dans - le chemin <parameter>pathname</parameter>. - </para> - <para> - Notez que vous aurez à préciser le mode en base octale, - ce qui signifie que vous aurez probablement un 0 comme premier chiffre : - <informalexample> - <programlisting role="php"> + </note> + </refsect1> + </refentry> + <refentry id="function.mkdir"> + <refnamediv> + <refname>mkdir</refname> + <refpurpose>Crée un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mkdir</function></funcdef> + <paramdef>string <parameter>pathname</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>mkdir</function> tente de créer un dossier dans + le chemin <parameter>pathname</parameter>. + </para> + <para> + Notez que vous aurez à préciser le mode en base octale, + ce qui signifie que vous aurez probablement un 0 comme premier chiffre : + <informalexample> + <programlisting role="php"> <?php mkdir ("/chemin/de/mon/dossier", 0700); ?> - </programlisting> - </informalexample> - </para> - <para> - <function>mkdir</function> retourne <literal>TRUE</literal> en cas de - succès, et <literal>FALSE</literal> en cas d'é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éplace un fichier téléchargé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>move_uploaded_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>destination</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>move_uploaded_file</function> est disponible à 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éléchargé - par HTTP POST. Si le fichier est valide, il est déplacé - jusqu'à <parameter>destination</parameter>. - </para> - <para> - Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, - et <function>move_uploaded_file</function> retournera <literal>FALSE</literal>. - </para> - <para> - Si <parameter>filename</parameter> est un fichier - téléchargé, mais que pour une raison - quelconque, il ne peut être déplacé, rien ne se passe, - et <function>move_uploaded_file</function> retourne <literal>FALSE</literal>. - De plus, une alerte sera affichée. - </para> - <para> - Ce type de vérification est spécialement important s'il - est possible que les fichiers téléchargés - révélent leur contenu à l'utilisateur, - ou même aux utilisateurs du même système. - </para> - <para> - Voir aussi <function>move_uploaded_file</function>, et la section - <link linkend="features.file-upload">Chargement de fichier</link> - pour un exemple simple. - </para> - </refsect1> - </refentry> - <refentry id="function.pathinfo"> - <refnamediv> - <refname>pathinfo</refname> - <refpurpose>Retourne des informations sur un chemin système</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>pathinfo</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pathinfo</function> retourne un tableau associatif, - contenant les informations sur le chemin <parameter>path</parameter>. - Les elements de tableau suivants sont retourns : - <parameter>dirname</parameter>, <parameter>basename</parameter> - et <parameter>extension</parameter>. - </para> - <para> - <example> - <title>Exemple avec <function>pathinfo</function></title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + <function>mkdir</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'é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éplace un fichier téléchargé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>move_uploaded_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>destination</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>move_uploaded_file</function> est disponible à 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éléchargé + par HTTP POST. Si le fichier est valide, il est déplacé + jusqu'à <parameter>destination</parameter>. + </para> + <para> + Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, + et <function>move_uploaded_file</function> retournera <literal>FALSE</literal>. + </para> + <para> + Si <parameter>filename</parameter> est un fichier + téléchargé, mais que pour une raison + quelconque, il ne peut être déplacé, rien ne se passe, + et <function>move_uploaded_file</function> retourne <literal>FALSE</literal>. + De plus, une alerte sera affichée. + </para> + <para> + Ce type de vérification est spécialement important s'il + est possible que les fichiers téléchargés + révélent leur contenu à l'utilisateur, + ou même aux utilisateurs du même système. + </para> + <para> + Voir aussi <function>move_uploaded_file</function>, et la section + <link linkend="features.file-upload">Chargement de fichier</link> + pour un exemple simple. + </para> + </refsect1> + </refentry> + <refentry id="function.pathinfo"> + <refnamediv> + <refname>pathinfo</refname> + <refpurpose>Retourne des informations sur un chemin système</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>pathinfo</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pathinfo</function> retourne un tableau associatif, + contenant les informations sur le chemin <parameter>path</parameter>. + Les éléments suivants sont retournés : + <parameter>dirname</parameter>, <parameter>basename</parameter> + et <parameter>extension</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>pathinfo</function></title> + <programlisting role="php"> <?php - $path_parts = pathinfo("/www/htdocs/index.html"); - echo $path_parts["dirname"] . "\n"; echo $path_parts["basename"] . "\n"; echo $path_parts["extension"] . "\n"; - ?> - </programlisting> - </example> - </para> - <para> - Va afficher : - <informalexample> - <programlisting> + </programlisting> + </example> + </para> + <para> + Va afficher : + <informalexample> + <programlisting> /www/htdocs index.html html - </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>dirname</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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>pclose</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pclose</function> ferme un processus de pointeur de fichier ouvert par - <function>popen</function>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir - été ouvert correctement par <function>popen</function>. - </para> - <para> - <function>pclose</function> retourne le statut final du processus - exécuté. - </para> - <para> - Voir aussi <function>popen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.popen"> - <refnamediv> - <refname>popen</refname> - <refpurpose>Crée un processus de pointeur de fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>popen</function></funcdef> - <paramdef>string <parameter>commet</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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 à celui retourné par <function>fopen</function>, - hormis le fait qu'il sera unidirectionel (lecture seule, ou - écriture seule), et doit être terminé par - <function>pclose</function>. Ce pointeur peut être utilisé - avec <function>fgets</function>, <function>fgetss</function> et - <function>fputs</function>. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>dirname</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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pclose</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pclose</function> ferme un processus de pointeur de fichier ouvert par + <function>popen</function>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir + été ouvert correctement par <function>popen</function>. + </para> + <para> + <function>pclose</function> retourne le statut final du processus + exécuté. + </para> + <para> + Voir aussi <function>popen</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.popen"> + <refnamediv> + <refname>popen</refname> + <refpurpose>Crée un processus de pointeur de fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>popen</function></funcdef> + <paramdef>string <parameter>commet</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 à celui retourné par <function>fopen</function>, + hormis le fait qu'il sera unidirectionel (lecture seule, ou + écriture seule), et doit être terminé par + <function>pclose</function>. Ce pointeur peut être utilisé + avec <function>fgets</function>, <function>fgetss</function> et + <function>fputs</function>. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + <informalexample> + <programlisting role="php"> <?php $fp = popen ("/bin/ls", "r"); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>readfile</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>readfile</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter> - <optional>use_include_path</optional> + <optional>use_include_path</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>readfile</function> lit le fichier <parameter>filename</parameter> et - l'envoi à la sortie standard. - </para> - <para> - <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Si <parameter>filename</parameter> commence par "http://" (insensible - à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur - spécifié, et le texte de la réponse sera affiché - sur la sortie standard. - </para> - <para> - ATTENTION : PHP ne gère pas les redirections, donc il faut penser - à ajouter un "/" final pour les dossiers. - </para> - <para> - Si <parameter>filename</parameter> commence par "ftp://" (insensible - à la casse), une connexion FTP est ouverte avec l'hôte - spécifié et la réponse du serveur est affichée. - Si le serveur ne supporte les connexions passives, la requête - échouera. + </funcprototype> + </funcsynopsis> + <para> + <function>readfile</function> lit le fichier <parameter>filename</parameter> et + l'envoi à la sortie standard. </para> - <para> - Si <parameter>filename</parameter> ne commence par aucun des cas - précédents, le fichier sera ouvert sur l'hôte - local, et envoyé à la sortie standard. - </para> - <para> - Vous pouvez utiliser le deuxième paramè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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>readlink</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + <para> + <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Si <parameter>filename</parameter> commence par "http://" (insensible + à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur + spécifié, et le texte de la réponse sera affiché + sur la sortie standard. + </para> + <para> + ATTENTION : PHP ne gère pas les redirections, donc il faut penser + à ajouter un "/" final pour les dossiers. + </para> + <para> + Si <parameter>filename</parameter> commence par "ftp://" (insensible + à la casse), une connexion FTP est ouverte avec l'hôte + spécifié et la réponse du serveur est affichée. + Si le serveur ne supporte les connexions passives, la requête + échouera. + </para> + <para> + Si <parameter>filename</parameter> ne commence par aucun des cas + précédents, le fichier sera ouvert sur l'hôte + local, et envoyé à la sortie standard. + </para> + <para> + Vous pouvez utiliser le deuxième paramè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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>readlink</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> <function>readlink</function> fait la même chose que la fonction readlink en C : elle retourne le contenu du lien symbolique repéré par <parameter>path</parameter>, ou <literal>FALSE</literal> 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é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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rename</function></funcdef> - <paramdef>string <parameter>oldname</parameter></paramdef> - <paramdef>string <parameter>newname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rename</function> rente de renommer le fichier - <parameter>oldname</parameter> en <parameter>newname</parameter>. - </para> - <para> - <function>rename</function> retourne <literal>TRUE</literal> en cas de succès - et <literal>FALSE</literal> sinon. - </para> - </refsect1> - </refentry> - <refentry id="function.rewind"> - <refnamediv> - <refname>rewind</refname> - <refpurpose>Replace le pointeur de fichier au début.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rewind</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rewind</function> replace le pointeur du fichier - <parameter>fp</parameter> au début. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rmdir</function></funcdef> - <paramdef>string <parameter>dirname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rmdir</function> tente d'effacer le dossier dont le chemin est - <parameter>dirname</parameter>. Le dossier doit être vide, - et le script doit avoir les autorisations adéquates. - </para> - <para> - Si une erreur survient, <function>rmdir</function> retourne <literal>FALSE</literal>. - </para> - <para> - Voir aussi <function>mkdir</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.stat"> - <refnamediv> - <refname>stat</refname> - <refpurpose>Renvoie les informations à propos d'un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>stat</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>stat</function> renvoie les informations à propos du - fichier filename. - </para> - <para> - <function>stat</function> retourne un tableau avec les éléments suivants : - <itemizedlist> - <listitem><simpara>0 : volume </simpara></listitem> - <listitem><simpara>1 : inode</simpara></listitem> - <listitem> - <simpara> - 2 : droits d'accè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étaire </simpara></listitem> - <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>7 : taille en octets </simpara></listitem> - <listitem><simpara>8 : date du dernier accès </simpara></listitem> - <listitem><simpara>9 : date de la dernière modification </simpara></listitem> - <listitem><simpara>10 : date du dernier changement </simpara></listitem> - <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> - <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize type - les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>stat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> pour - plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.lstat"> - <refnamediv> - <refname>lstat</refname> - <refpurpose> - Renvoie les informations à propos d'un fichier ou d'un lien symbolique. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>lstat</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>lstat</function> est identique à <function>stat</function> - mais elle accepte aussi un lien symbolique comme argument. - </para> - <para> - <function>lstat</function> retourne un tableau avec les éléments suivants : - <itemizedlist> - <listitem><simpara>0 : volume </simpara></listitem> - <listitem><simpara>1 : inode</simpara></listitem> - <listitem> - <simpara> - 2 : droits d'accè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étaire </simpara></listitem> - <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>7 : taille en octets </simpara></listitem> - <listitem><simpara>8 : date du dernier accès </simpara></listitem> - <listitem><simpara>9 : date de la dernière modification </simpara></listitem> - <listitem><simpara>10 : date du dernier changement </simpara></listitem> - <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> - <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize type - les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>lstat</function> sont mis en cache. - Reportez vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.realpath"> - <refnamediv> - <refname>realpath</refname> - <refpurpose>Retourne le chemin canonique absolu.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>realpath</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>realpath</function> résoud tous les liens symboliques, et - remplace toutes les références '/./', '/../' et '/' de - <parameter>path</parameter> puis retourne le chemin canonique absolu - ainsi trouvé. Le résultat ne contient aucun lien symbolique, - '/./' ou '/../'. - </para> - <para> - <example> - <title>Exemple <function>realpath</function></title> - <programlisting role="php"> + </para> + <para> + Voir aussi <function>symlink</function>, <function>readlink</function> et + <function>linkinfo</function>. + </para> + <note> + <simpara> + <function>readlink</function> est inopé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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rename</function></funcdef> + <paramdef>string <parameter>oldname</parameter></paramdef> + <paramdef>string <parameter>newname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rename</function> rente de renommer le fichier + <parameter>oldname</parameter> en <parameter>newname</parameter>. + </para> + <para> + <function>rename</function> retourne <literal>TRUE</literal> en cas de succès + et <literal>FALSE</literal> sinon. + </para> + </refsect1> + </refentry> + <refentry id="function.rewind"> + <refnamediv> + <refname>rewind</refname> + <refpurpose>Replace le pointeur de fichier au début.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rewind</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rewind</function> replace le pointeur du fichier + <parameter>fp</parameter> au début. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rmdir</function></funcdef> + <paramdef>string <parameter>dirname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rmdir</function> tente d'effacer le dossier dont le chemin est + <parameter>dirname</parameter>. Le dossier doit être vide, + et le script doit avoir les autorisations adéquates. + </para> + <para> + Si une erreur survient, <function>rmdir</function> retourne <literal>FALSE</literal>. + </para> + <para> + Voir aussi <function>mkdir</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.stat"> + <refnamediv> + <refname>stat</refname> + <refpurpose>Renvoie les informations à propos d'un fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>stat</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>stat</function> renvoie les informations à propos du + fichier filename. + </para> + <para> + <function>stat</function> retourne un tableau avec les éléments suivants : + <itemizedlist> + <listitem><simpara>0 : volume </simpara></listitem> + <listitem><simpara>1 : inode</simpara></listitem> + <listitem> + <simpara> + 2 : droits d'accè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étaire </simpara></listitem> + <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>7 : taille en octets </simpara></listitem> + <listitem><simpara>8 : date du dernier accès </simpara></listitem> + <listitem><simpara>9 : date de la dernière modification </simpara></listitem> + <listitem><simpara>10 : date du dernier changement </simpara></listitem> + <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> + <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize type + les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>stat</function> sont mis en cache. + Reportez-vous à la fonction <function>clearstatcache</function> pour + plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.lstat"> + <refnamediv> + <refname>lstat</refname> + <refpurpose> + Renvoie les informations à propos d'un fichier ou d'un lien symbolique. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>lstat</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>lstat</function> est identique à <function>stat</function> + mais elle accepte aussi un lien symbolique comme argument. + </para> + <para> + <function>lstat</function> retourne un tableau avec les éléments suivants : + <itemizedlist> + <listitem><simpara>0 : volume </simpara></listitem> + <listitem><simpara>1 : inode</simpara></listitem> + <listitem> + <simpara> + 2 : droits d'accè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étaire </simpara></listitem> + <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>7 : taille en octets </simpara></listitem> + <listitem><simpara>8 : date du dernier accès </simpara></listitem> + <listitem><simpara>9 : date de la dernière modification </simpara></listitem> + <listitem><simpara>10 : date du dernier changement </simpara></listitem> + <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> + <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize type + les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>lstat</function> sont mis en cache. + Reportez vous à la fonction <function>clearstatcache</function> + pour plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.realpath"> + <refnamediv> + <refname>realpath</refname> + <refpurpose>Retourne le chemin canonique absolu.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>realpath</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>realpath</function> résoud tous les liens symboliques, et + remplace toutes les références '/./', '/../' et '/' de + <parameter>path</parameter> puis retourne le chemin canonique absolu + ainsi trouvé. Le résultat ne contient aucun lien symbolique, + '/./' ou '/../'. + </para> + <para> + <example> + <title>Exemple <function>realpath</function></title> + <programlisting role="php"> <?php $real_path = realpath ("../../index.php"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.symlink"> - <refnamediv> - <refname>symlink</refname> - <refpurpose>Crée un lien symbolique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>symlink</function></funcdef> - <paramdef>string <parameter>target</parameter></paramdef> - <paramdef>string <parameter>link</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>symlink</function> cré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éer des liens durs, - et <function>readlink</function> ainsi que <function>linkinfo</function>. - </para> - <note> - <simpara> - <function>symlink</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.tempnam"> - <refnamediv> - <refname>tempnam</refname> - <refpurpose>Crée un fichier avec un nom unique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>tempnam</function></funcdef> - <paramdef>string <parameter>dir</parameter></paramdef> - <paramdef>string <parameter>prefix</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tempnam</function> crée un fichier temporaire unique - dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, - <function>tempnam</function> va génèrer un nom de fichier - dans le dossier temporaire du système. - </para> - <para> - Le comportement de <function>tempnam</function> dépend du - système. Sous Windows, la variable d'environnement TMP sera - prioritaire par rapport au paramètre <parameter>dir</parameter>; - sous Linux la variable d'environnement TMPDIR aura la priorité, - tandis que l'OS SVR4 utilisera toujours le paramètre - <parameter>dir</parameter> si le dossier n'existe pas. Reportez - vous à la documentation de votre système(tempnam(3)). - </para> - <para> - <function>tempnam</function> retourne le nom du fichier temporaire, ou - la chaîne NULL en cas d'échec. - <example> - <title>Exemple avec <function>tempnam</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.symlink"> + <refnamediv> + <refname>symlink</refname> + <refpurpose>Crée un lien symbolique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>symlink</function></funcdef> + <paramdef>string <parameter>target</parameter></paramdef> + <paramdef>string <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>symlink</function> cré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éer des liens durs, + et <function>readlink</function> ainsi que <function>linkinfo</function>. + </para> + <note> + <simpara> + <function>symlink</function> est inopérante sous Windows. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.tempnam"> + <refnamediv> + <refname>tempnam</refname> + <refpurpose>Crée un fichier avec un nom unique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>tempnam</function></funcdef> + <paramdef>string <parameter>dir</parameter></paramdef> + <paramdef>string <parameter>prefix</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tempnam</function> crée un fichier temporaire unique + dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, + <function>tempnam</function> va génèrer un nom de fichier + dans le dossier temporaire du système. + </para> + <para> + Le comportement de <function>tempnam</function> dépend du + système. Sous Windows, la variable d'environnement TMP sera + prioritaire par rapport au paramètre <parameter>dir</parameter>; + sous Linux la variable d'environnement TMPDIR aura la priorité, + tandis que l'OS SVR4 utilisera toujours le paramètre + <parameter>dir</parameter> si le dossier n'existe pas. Reportez + vous à la documentation de votre système(tempnam(3)). + </para> + <para> + <function>tempnam</function> retourne le nom du fichier temporaire, ou + la chaîne NULL en cas d'échec. + <example> + <title>Exemple avec <function>tempnam</function></title> + <programlisting role="php"> <?php $tmpfname = tempnam ("/tmp", "FOO"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.tmpfile"> - <refnamediv> - <refname>tmpfile</refname> - <refpurpose>Crée un fichier temporaire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>tmpfile</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tmpfile</function> crée un fichier temporaire - avec un nom unique, ouvert en écriture, et retourne un - pointeur de fichier, identique à ceux retourné par - <function>fopen</function>. - Ce fichier sera automatiquement effacé lorsqu'il sera - fermé (avec <function>fclose</function>), ou lorsque le fichier - sera termniné. - </para> - <para> - Pour plus de détails, consultez votre documentation systè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 à un fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>touch</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>time</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>touch</function> tente de forcer la date de modification du fichier - nommé <parameter>filename</parameter> à la date de - <parameter>time</parameter>. Si <parameter>time</parameter> est omis, - c'est l'heure courante qui est utilisée. - </para> - <para> - Si le fichier n'existe pas, il est crée. - </para> - <para> - <function>touch</function> retourne <literal>TRUE</literal> en cas de succès, - et <literal>FALSE</literal> sinon. - <example> - <title>Exemple avec <function>touch</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.tmpfile"> + <refnamediv> + <refname>tmpfile</refname> + <refpurpose>Crée un fichier temporaire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>tmpfile</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tmpfile</function> crée un fichier temporaire + avec un nom unique, ouvert en écriture, et retourne un + pointeur de fichier, identique à ceux retourné par + <function>fopen</function>. + Ce fichier sera automatiquement effacé lorsqu'il sera + fermé (avec <function>fclose</function>), ou lorsque le fichier + sera termniné. + </para> + <para> + Pour plus de détails, consultez votre documentation systè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 à un fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>touch</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>time</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>touch</function> tente de forcer la date de modification du fichier + nommé <parameter>filename</parameter> à la date de + <parameter>time</parameter>. Si <parameter>time</parameter> est omis, + c'est l'heure courante qui est utilisée. + </para> + <para> + Si le fichier n'existe pas, il est crée. + </para> + <para> + <function>touch</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> sinon. + <example> + <title>Exemple avec <function>touch</function></title> + <programlisting role="php"> if ( touch($NomDeFichier) ) { print "La date de modification de $NomDeFichier a été fixée à maintenant"; } else { print "Désolé, 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>umask</function></funcdef> - <paramdef>int <parameter>mask</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>umask</function> change le umask de PHP : mask & 0777 et retourne le - vieux umask. Lorsque PHP est utilisé comme module de serveur, - le umask reprend sa valeur à la fin de chaque script. - </para> - <para> - <function>umask</function> appelé 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>unlink</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>unlink</function> efface <parameter>filename</parameter>. - Identique à la fonction Unix C unlink(). - </para> - <para> - <function>unlink</function> retourne <literal>FALSE</literal> en cas d'échec. - </para> - <para> - Voir aussi <function>rmdir</function> pour supprimer des dossiers. - </para> - <note> - <simpara> - <function>unlink</function> peut ne pas fonctionner sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.umask"> + <refnamediv> + <refname>umask</refname> + <refpurpose>Change le "umask" courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>umask</function></funcdef> + <paramdef>int <parameter>mask</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>umask</function> change le umask de PHP : mask & 0777 et retourne le + vieux umask. Lorsque PHP est utilisé comme module de serveur, + le umask reprend sa valeur à la fin de chaque script. + </para> + <para> + <function>umask</function> appelé 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>unlink</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>unlink</function> efface <parameter>filename</parameter>. + Identique à la fonction Unix C unlink(). + </para> + <para> + <function>unlink</function> retourne <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Voir aussi + <function>rmdir</function> pour supprimer des dossiers. + </para> + <note> + <simpara> + <function>unlink</function> peut ne pas fonctionner sous Windows. + </simpara> + </note> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/fr/functions/filesystem.xml diff -u phpdoc/fr/functions/filesystem.xml:1.21 phpdoc/fr/functions/filesystem.xml:1.22 --- phpdoc/fr/functions/filesystem.xml:1.21 Mon May 7 01:37:54 2001 +++ phpdoc/fr/functions/filesystem.xml Mon May 7 06:08:58 2001 @@ -1,514 +1,515 @@ - <reference id="ref.filesystem"> - <title>Système de fichiers</title> - <titleabbrev>Système de fichiers</titleabbrev> - <refentry id="function.basename"> - <refnamediv> - <refname>basename</refname> - <refpurpose> - Sépare le nom du fichier et le nom du dossier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>basename</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>basename</function> prend en paramètre le chemin complet - d'un fichier et en extrait le nom du fichier. - </para> - <para> - Sous Windows, les caractères (<literal>/</literal>) et antislash - (<literal>\</literal>) sont utilisés comme séparateur de - dossier. Sous les autres OS, seul le caractère slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>basename</function></title> - <programlisting role="php"> +<reference id="ref.filesystem"> + <title>Système de fichiers</title> + <titleabbrev>Système de fichiers</titleabbrev> + <refentry id="function.basename"> + <refnamediv> + <refname>basename</refname> + <refpurpose> + Sépare le nom du fichier et le nom du dossier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>basename</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>basename</function> prend en paramètre le chemin complet + d'un fichier et en extrait le nom du fichier. + </para> + <para> + Sous Windows, les caractères (<literal>/</literal>) et antislash + (<literal>\</literal>) sont utilisés comme séparateur de + dossier. Sous les autres OS, seul le caractère slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>basename</function></title> + <programlisting role="php"> <?php $path = "/home/httpd/html/index.php3"; $file = basename($path); // $file est affecté avec "index.php3" ?> - </programlisting> - </example> - </para> - <para> - Voir aussi: <function>dirname</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.chgrp"> - <refnamediv> - <refname>chgrp</refname> - <refpurpose>Change le groupe possesseur du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chgrp</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>mixed <parameter>group</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chgrp</function> essaie de changer le groupe propriétaire - du fichier. Seul le superuser (root) peut changer le groupe propriétaire - d'un fichier arbitrairement. Les utilisateurs classiques ne peuvent changer - le groupe propriétaire d'un fichier que si l'utilisateur - propriétaire du fichier est membre du groupe. - </para> - <para> - <function>chgrp</function> renvoie <literal>TRUE</literal> en - cas de succès, sinon renvoie <literal>FALSE</literal>. - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chmod</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chmod</function> remplace le mode du fichier - <parameter>filename</parameter> par le mode <parameter>mode</parameter>. - </para> - <para> - Il est à noter que le mode <parameter>mode</parameter> est - considéré comme un nombre en notation octale. Afin de - vous en assurer, vous pouvez préfixer cette valeur par un - zéro (<parameter>mode</parameter>): - <informalexample> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi: <function>dirname</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.chgrp"> + <refnamediv> + <refname>chgrp</refname> + <refpurpose>Change le groupe possesseur du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chgrp</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>mixed <parameter>group</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chgrp</function> essaie de changer le groupe propriétaire + du fichier. Seul le superuser (root) peut changer le groupe propriétaire + d'un fichier arbitrairement. Les utilisateurs classiques ne peuvent changer + le groupe propriétaire d'un fichier que si l'utilisateur + propriétaire du fichier est membre du groupe. + </para> + <para> + <function>chgrp</function> renvoie <literal>TRUE</literal> en + cas de succès, sinon renvoie <literal>FALSE</literal>. + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chmod</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chmod</function> remplace le mode du fichier + <parameter>filename</parameter> par le mode <parameter>mode</parameter>. + </para> + <para> + Il est à noter que le mode <parameter>mode</parameter> est + considéré comme un nombre en notation octale. Afin de + vous en assurer, vous pouvez préfixer cette valeur par un + zéro (<parameter>mode</parameter>): + <informalexample> + <programlisting role="php"> <?php chmod( "/somedir/somefile", 755 ); // notation décimale; probablement <literal>FALSE</literal> chmod( "/somedir/somefile", 0755 ); // notation octale; valeur du mode correcte ?> - </programlisting> - </informalexample> - </para> - <para> - <function>chmod</function> renvoie <literal>TRUE</literal> - en cas de succès, <literal>FALSE</literal> sinon. - </para> - <para> - Voir aussi <function>chown</function> et <function>chgrp</function>. - </para> - <note> - <simpara> + </programlisting> + </informalexample> + </para> + <para> + <function>chmod</function> renvoie <literal>TRUE</literal> + en cas de succès, <literal>FALSE</literal> 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étaire du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>chown</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>mixed <parameter>user</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>chown</function> change le groupe propriétaire du fichier. - Seul le superutilisateur (root) peut changer le propriétaire d'un fichier. - </para> - <para> - <function>chown</function> renvoie <literal>TRUE</literal> - en cas de succès, "<literal>FALSE</literal>" sinon. - <note> - <simpara> - Sous Windows, ne fait rien et retourne <literal>TRUE</literal>. - </simpara> - </note> - </para> - <para> - Voir aussi - <function>chown</function> et - <function>chmod</function>. - </para> + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.chown"> + <refnamediv> + <refname>chown</refname> + <refpurpose>Change le groupe propriétaire du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>chown</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>mixed <parameter>user</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>chown</function> change le groupe propriétaire du fichier. + Seul le superutilisateur (root) peut changer le propriétaire d'un fichier. + </para> + <para> + <function>chown</function> renvoie <literal>TRUE</literal> + en cas de succès, "<literal>FALSE</literal>" sinon. <note> <simpara> - <function>chown</function> est inopérante sous Windows. + Sous Windows, <function>chown</function> ne fait rien et + retourne <literal>TRUE</literal>. </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> - <funcsynopsis> - <funcdef>void <function>clearstatcache</function></funcdef> - <paramdef>void</paramdef> - </funcsynopsis> - <para> - L'appel à la fonction <systemitem>stat</systemitem> ou - <systemitem>lstat</systemitem> est relativement coûteux en terme de - temps d'exécution. Pour cela, le résultat du dernier - appel à l'une des fonctions de statut, (voir la liste ci-dessous), est - sauvegardé pour ré-utilisation ultérieure. Si vous voulez - forcer la vérification du statut d'un fichier, dans le cas ooúugrave; le - fichier aurait pu être modifié ou aurait disparu, vous - devez utiliser la fonction <function>clearstatcache</function> - afin d'effacer de la mémoire les résultats du dernier - appel à la fonction. - </para> - <para> - La valeur du cache n'est valable que pour la durée d'une requête. - </para> - <para> - Les fonctions affecté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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>copy</function></funcdef> - <paramdef>string <parameter>source</parameter></paramdef> - <paramdef>string <parameter>dest</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>copy</function> fait une copie du fichier. Elle renvoie <literal>TRUE</literal> en - cas de succès, <literal>FALSE</literal> sinon. - <example> - <title>Exemple avec <function>copy</function></title> - <programlisting role="php"> + </para> + <para> + Voir aussi + <function>chown</function> et + <function>chmod</function>. + </para> + <note> + <simpara> + <function>chown</function> est inopé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> + <funcsynopsis> + <funcdef>void <function>clearstatcache</function></funcdef> + <paramdef>void</paramdef> + </funcsynopsis> + <para> + L'appel à la fonction <systemitem>stat</systemitem> ou + <systemitem>lstat</systemitem> est relativement coûteux en terme de + temps d'exécution. Pour cela, le résultat du dernier + appel à l'une des fonctions de statut, (voir la liste ci-dessous), est + sauvegardé pour ré-utilisation ultérieure. Si vous voulez + forcer la vérification du statut d'un fichier, dans le cas ooúugrave; le + fichier aurait pu être modifié ou aurait disparu, vous + devez utiliser la fonction <function>clearstatcache</function> + afin d'effacer de la mémoire les résultats du dernier + appel à la fonction. + </para> + <para> + La valeur du cache n'est valable que pour la durée d'une requête. + </para> + <para> + Les fonctions affecté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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>copy</function></funcdef> + <paramdef>string <parameter>source</parameter></paramdef> + <paramdef>string <parameter>dest</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>copy</function> fait une copie du fichier. Elle renvoie <literal>TRUE</literal> en + cas de succès, <literal>FALSE</literal> 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éussi...<br>\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> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>delete</function></funcdef> - <paramdef>string <parameter>file</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Ceci est une fausse entré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, - <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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dirname</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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és comme séparateurs - de dossier. Dans les autres environnements, seul le slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>dirname</function></title> - <programlisting role="php"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>delete</function></funcdef> + <paramdef>string <parameter>file</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Ceci est une fausse entré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, + <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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dirname</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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és comme séparateurs + de dossier. Dans les autres environnements, seul le slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>dirname</function></title> + <programlisting role="php"> <?php $path = "/etc/passwd"; $file = dirname($path); // $file contient "/etc" ?> - </programlisting> - </example> - </para> - <para> - Voir aussi: <function>basename</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.diskfreespace"> - <refnamediv> - <refname>diskfreespace</refname> - <refpurpose> - Renvoie l'espace disque disponible dans le répertoire. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>diskfreespace</function></funcdef> - <paramdef>string <parameter>directory</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>diskfreespace</function> retournera le nombre d'octets disponible sur - le disque correspondant contenant le dossier <parameter>directory</parameter>. - </para> - <para> - <example> - <title>Exemple avec <function>diskfreespace</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Voir aussi: <function>basename</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.diskfreespace"> + <refnamediv> + <refname>diskfreespace</refname> + <refpurpose> + Renvoie l'espace disque disponible dans le répertoire. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>diskfreespace</function></funcdef> + <paramdef>string <parameter>directory</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>diskfreespace</function> retournera le nombre d'octets disponible sur + le disque correspondant contenant le dossier <parameter>directory</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>diskfreespace</function></title> + <programlisting role="php"> <?php $df = diskfreespace("/"); // $df contient le nombre d'octets libres sur "/" ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.fclose"> - <refnamediv> - <refname>fclose</refname> - <refpurpose>Ferme un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.fclose"> + <refnamediv> + <refname>fclose</refname> + <refpurpose>Ferme un fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> <funcdef>int <function>fclose</function></funcdef> <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fclose</function> ferme le fichier <parameter>fp</parameter>. - </para> - <para> - <function>fclose</function> retourne <literal>TRUE</literal> en cas de succès, - et <literal>FALSE</literal> en cas d'échec. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>feof</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>feof</function> retourne <literal>TRUE</literal> si le pointeur - <parameter>fp</parameter> est à la fin du fichier, ou si - une erreur survient, sinon, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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énéré dans un fichier - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fflush</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fflush</function> forces l'écriture de toutes les - données bufferisées dans le fichier désigné - par <parameter>fp</parameter>. <function>fflush</function> retourne - <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> - 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ère que pointe le pointeur du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgetc</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fgetc</function> retourne une chaîne contenant un - seul caractère, lu depuis le fichier pointé par - <parameter>fp</parameter>. <function>fgetc</function> retourne - <literal>FALSE</literal> à la fin du fichier - (tout comme <function>feof</function>). - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> + </funcprototype> + </funcsynopsis> + <para> + <function>fclose</function> ferme le fichier <parameter>fp</parameter>. + </para> + <para> + <function>fclose</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>feof</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>feof</function> retourne <literal>TRUE</literal> si le pointeur + <parameter>fp</parameter> est à la fin du fichier, ou si + une erreur survient, sinon, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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énéré dans un fichier + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fflush</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fflush</function> forces l'écriture de toutes les + données bufferisées dans le fichier désigné + par <parameter>fp</parameter>. <function>fflush</function> retourne + <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> + 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ère que pointe le pointeur du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgetc</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fgetc</function> retourne une chaîne contenant un + seul caractère, lu depuis le fichier pointé par + <parameter>fp</parameter>. <function>fgetc</function> retourne + <literal>FALSE</literal> à la fin du fichier + (tout comme <function>feof</function>). + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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 sur laquelle se trouve le pointeur du fichier et cherche dans le résultat les champs CSV - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>fgetcsv</function></funcdef> - <paramdef>resource <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>string + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>fgetcsv</function></funcdef> + <paramdef>resource <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter> - <optional>delimiter</optional> + <optional>delimiter</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Identique à <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élimiteur de champs - <parameter>delimiter</parameter> est la virgule, à moins que vous ne - fournissiez un troisième argument. - </simpara> - <simpara> - <parameter>fp</parameter> doit être un pointeur valide, et avoir - été correctement ouvert par <function>fopen</function>, - <function>popen</function>, ou <function>fsockopen</function>. - </simpara> - <simpara> - <parameter>length</parameter> doit être plus grand que la plus - grande ligne trouvée dans un fichier CSV (en comptant les - caractères de fin de ligne). - </simpara> - <simpara> - <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas d'erreur, ou en cas - de fin du fichier. - </simpara> - <simpara> - Note : une ligne vide dans un fichier CSV sera retournée dans le - tableau comme une chaîne vide, et ne sera pas traitée comme - une erreur. - </simpara> - <example> - <title> - Exemple avec <function>fgetcsv</function> une ligne vide dans un fichier - CSV sera retournée dans le tableau comme une chaîne vide, et - ne sera pas traitée comme une erreur. - </title> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <simpara> + Identique à <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élimiteur de champs + <parameter>delimiter</parameter> est la virgule, à moins que vous ne + fournissiez un troisième argument. + </simpara> + <simpara> + <parameter>fp</parameter> doit être un pointeur valide, et avoir + été correctement ouvert par <function>fopen</function>, + <function>popen</function>, ou <function>fsockopen</function>. + </simpara> + <simpara> + <parameter>length</parameter> doit être plus grand que la plus + grande ligne trouvée dans un fichier CSV (en comptant les + caractères de fin de ligne). + </simpara> + <simpara> + <function>fgetcsv</function> retourne <literal>FALSE</literal> en cas d'erreur, ou en cas + de fin du fichier. + </simpara> + <simpara> + Note : une ligne vide dans un fichier CSV sera retournée dans le + tableau comme une chaîne vide, et ne sera pas traitée comme + une erreur. + </simpara> + <example> + <title> + Exemple avec <function>fgetcsv</function> une ligne vide dans un fichier + CSV sera retournée dans le tableau comme une chaîne vide, et + ne sera pas traitée comme une erreur. + </title> + <programlisting role="php"> <?php $row = 1; $fp = fopen ("test.csv","r"); @@ -522,53 +523,53 @@ } fclose ($fp); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgets</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fgets</function> retourne la chaîne lue jusqu'à - la longueur <parameter>length</parameter> - 1 octets, ou bien la fin du - fichier, ou encore un retour chariot (le premier des trois qui sera - rencontré). - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Erreur courante : - </para> - <simpara> - Les programmeurs habitués à la programmation 'C' noteront que - <function>fgets</function> ne se comporte pas comme son équivalent C - lors de la rencontre de la fin du fichier. - </simpara> - <simpara> - <parameter>fp</parameter> doit être valide, et avoir été - 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"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgets</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fgets</function> retourne la chaîne lue jusqu'à + la longueur <parameter>length</parameter> - 1 octets, ou bien la fin du + fichier, ou encore un retour chariot (le premier des trois qui sera + rencontré). + </para> + <para> + Si une erreur survient, <function>fgets</function> retourne <literal>FALSE</literal>. + </para> + <para> + Erreur courante : + </para> + <simpara> + Les programmeurs habitués à la programmation 'C' noteront que + <function>fgets</function> ne se comporte pas comme son équivalent C + lors de la rencontre de la fin du fichier. + </simpara> + <simpara> + <parameter>fp</parameter> doit être valide, et avoir été + 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"> <?php $fd = fopen ("/tmp/inputfile.txt", "r"); while (!feof($fd)) { @@ -577,94 +578,94 @@ } fclose ($fd); ?> - </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 courant sur laquelle se trouve le pointeur du fichier et - élimine les balises HTML - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fgetss</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - <paramdef>string + </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 courant sur laquelle se trouve le pointeur du fichier et + élimine les balises HTML + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fgetss</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + <paramdef>string <parameter> - <optional>allowable_tags</optional> + <optional>allowable_tags</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <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éciser les balises qui seront ignorées dans - le troisième paramètre, optionnel. - <note> - <para> - <parameter>allowable_tags</parameter> a été ajouté 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ésultat dans un tableau. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int + </funcprototype> + </funcsynopsis> + <para> + Identique à <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éciser les balises qui seront ignorées dans + le troisième paramètre, optionnel. + <note> + <para> + <parameter>allowable_tags</parameter> a été ajouté 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ésultat dans un tableau. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter><optional>use_include_path</optional></parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Identique à <function>readfile</function>, hormis le fait que - <function>file</function> retourne le fichier dans un tableau. Chaque - élément du tableau correspond à une ligne du fichier, - et les retour chariots sont placés en fin de ligne. - </para> - <para> - Vous pouvez utiliser l'option et en la mettant à "1", si vous voulez - rechercher aussi dans le dossier <link linkend="ini.include-path">include_path</link>. - </para> - <para> - <informalexample> - <programlisting role="php"> + </funcprototype> + </funcsynopsis> + <para> + Identique à <function>readfile</function>, hormis le fait que + <function>file</function> retourne le fichier dans un tableau. Chaque + élément du tableau correspond à une ligne du fichier, + et les retour chariots sont placés en fin de ligne. + </para> + <para> + Vous pouvez utiliser l'option et en la mettant à "1", si vous voulez + rechercher aussi dans le dossier <link linkend="ini.include-path">include_path</link>. + </para> + <para> + <informalexample> + <programlisting role="php"> <?php // Lire une page web dans un tableau, et l'afficher $fcontents = file( 'http://www.php.net' ); @@ -674,686 +675,686 @@ // lire une page web dans une chaîne $fcontents = join( '', file( 'http://www.php.net' ) ); ?> - </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érifie si un fichier existe.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>file_exists</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>file_exists</function> retourne <literal>TRUE</literal> si le fichier - <parameter>filename</parameter> existe, et <literal>FALSE</literal> sinon. - </simpara> - <simpara> - <function>file_exists</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <simpara> - Le résultat de <function>file_exists</function> est mis en cache. - Reportez-vous à <function>clearstatcache</function> pour - plus de détails. - </simpara> - </refsect1> - </refentry> - <refentry id="function.fileatime"> - <refnamediv> - <refname>fileatime</refname> - <refpurpose> - Renvoie la date à laquelle le fichier a été - accédé pour la dernière fois. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileatime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fileatime</function> renvoie la date à laquelle le fichier - a été accédé pour la dernière fois, ou - <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <simpara> - Le résultat de <function>fileatime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </simpara> - </refsect1> - </refentry> - <refentry id="function.filectime"> - <refnamediv> - <refname>filectime</refname> - <refpurpose> - Renvoie l'heure à laquelle l'inode a été - accédé pour la dernière fois. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filectime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filectime</function> renvoie l'heure à laquelle l'inode - <parameter>filename</parameter> a été accédé pour - la dernière fois, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Note: Sur la plus part des serveurs UNIX, un fichier est considéré - comme modifié si les données de sont inode sont modifiées. C'est à - dire lorsque les permissions (utilisateur, group ou autre) ont - été modifiées. Voyez aussi <function>filemtime</function> - (que vous pourrez utiliser lorsque vous créerez des indications - telles que "Dernière modification : " sur les pages web) et - <function>fileatime</function>. - </para> - <para> - Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier - texte est considéré comme sa date de création. Cela est faux! - Il n'y a pas de date de création de fichier sous la plus part - des systèmes UNIX. - </para> - <para> - Le résultat de <function>filectime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filegroup"> - <refnamediv> - <refname>filegroup</refname> - <refpurpose>Lire le nom du groupe</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filegroup</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filegroup</function> renvoie le groupe qui possède le fichier - <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur. - L'identifiant de groupe est retourné au format numérique, utilisez - <function>posix_getgrgid</function> pour retrouver le nom du groupe. - </para> - <simpara> - <function>filegroup</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filegroup</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <note> - <simpara> - <function>filegroup</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.fileinode"> - <refnamediv> - <refname>fileinode</refname> - <refpurpose>Renvoie le numéro d'inode du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileinode</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileinode</function> renvoie le numéro d'inode du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. - </para> - <para> - Le résultat de <function>fileinode</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>fileinode</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <note> - <simpara> - <function>fileinode</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.filemtime"> - <refnamediv> - <refname>filemtime</refname> - <refpurpose> - Renvoie la date de dernière modification du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filemtime</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filemtime</function> renvoie la date de dernière - modification du fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> - en cas d'erreur. - </para> - <para> - Le résultat de <function>filemtime</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>filemtime</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Note: <function>filemtime</function> retourne l'heure d'écriture - des blocs données d'un fichier. Utilisez <function>date</function> - sur ce résultat pour obtenir une date de modification humainement - lisible. - </para> - </refsect1> - </refentry> - <refentry id="function.fileowner"> - <refnamediv> - <refname>fileowner</refname> - <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileowner</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileowner</function> renvoie le nom du possesseur du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. - L'identification du possesseur de fichier est numé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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>fileowner</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - <note> - <simpara> - <function>fileowner</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.fileperms"> - <refnamediv> - <refname>fileperms</refname> - <refpurpose> - Renvoie les permissions affectées au fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fileperms</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fileperms</function> renvoie les permissions affectées - au fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> - 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>fileperms</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filesize"> - <refnamediv> - <refname>filesize</refname> - <refpurpose>Renvoie la taille du fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>filesize</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filesize</function> renvoie la taille du fichier - <parameter>filename</parameter>, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filesize</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus - de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.filetype"> - <refnamediv> - <refname>filetype</refname> - <refpurpose>Retourne le type de fichier</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>filetype</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>filetype</function> renvoie le type du fichier - <parameter>filename</parameter>. Les réponses possibles sont : - fifo, char, dir, block, link, file, et unknown. - </para> - <para> - <function>filetype</function> retourne <literal>FALSE</literal> 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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>filetype</function> est mis en cache. - Reportez vous à <function>clearstatcache</function> pour plus de - détails. - </para> - </refsect1> - </refentry> - <refentry id="function.flock"> - <refnamediv> - <refname>flock</refname> - <refpurpose>Verrouille le fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>flock</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>operation</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - PHP dispose d'un système complet de verrouillage de fichiers. - Tous les programmes qui accèdent au fichier doivent utiliser la - même méthode de verrouillage pour qu'il soit efficace. - </simpara> - <simpara> - <function>flock</function> agit sur le fichier <parameter>fp</parameter> - qui doit avoir été ouvert au pré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 (écriture), - <parameter>operation</parameter> = 2. - </simpara> - </listitem> - <listitem> - <simpara> - Libération d'un verrou (partagé 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 à <parameter>operation</parameter>. - </simpara> - </listitem> - </itemizedlist> - </para> - <simpara> - <function>flock</function> permet de réaliser un système simple de - verrous écriture / lecture, qui peut être utilisé sur - n'importe quelle plate-forme (Unix et Windows compris). - </simpara> - <simpara> - <function>flock</function> retourne <literal>TRUE</literal> en cas - de succès, et <literal>FALSE</literal> - sinon. (le verrou n'a pas pu être obtenu). - </simpara> - <warning> - <para> - Sur la plus part des OS, <function>flock</function> est implémenté - au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, - comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> - pour protéger vos fichiers contre des accès concurents du - mê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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fopen</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>int - <parameter> - <optional>use_include_path</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Si <parameter>filename</parameter> commence par "http://" (insensible à - la casse), une connexion HTTP 1.x est ouverte avec le serveur - spécifié, et un pointeur sur la réponse fournie est - retourné. - </simpara> - <simpara> - Attention, <function>fopen</function> ne gère pas les redirections, - ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "ftp://" (insensible à - la casse), une connexion FTP est ouverte avec le serveur spécifié, - et un pointeur sur la réponse fournie est retourné. Si le serveur - ne supporte par le mode FTP passif, <function>fopen</function> échouera. - Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture - seulement (le full duplex n'est pas supporté). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", - ou "php://stderr", le flot correspondant sera ouvert. (Cela a été - introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" - ou "/dev/fd/0" devaient être utilisés pour accéder à - ces flots). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP - tentera de lire ce fichier dans le système local, et un pointeur sur - le fichier ouvert sera retourné. - </simpara> - <simpara> - Si l'ouverture échoue, <function>fopen</function> retourne - <literal>FALSE</literal>. - </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ébut du fichier. - </simpara> - </listitem> - <listitem> - <simpara> - 'r+' - Ouvre en lecture et écriture, et place le pointeur de - fichier au début du fichier. - </simpara> - </listitem> - <listitem> - <simpara> - 'w' - Ouvre en écriture seule; place le pointeur de fichier au - début du fichier et réduit la taille du fichier à 0. - Si le fichier n'existe pas, on tente de le créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'w+' - Ouvre en lecture et écriture; place le pointeur de fichier - au début du fichier et réduit la taille du fichier à - 0. Si le fichier n'existe pas, on tente de le créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'a' - Ouvre en écriture seule; place le pointeur de fichier à - la fin du fichier file. Si le fichier n'existe pas, on tente de le - créer. - </simpara> - </listitem> - <listitem> - <simpara> - 'a+' - Ouvre en lecture et écriture; place le pointeur de fichier - à la fin du fichier. Si le fichier n'existe pas, on tente de le - créer. - </simpara> - </listitem> - </itemizedlist> - De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option - n'est utile que sur les systèmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - Si il n'est pas nécessaire, il sera ignoré. - </para> - <para> - Vous pouvez utiliser le troisième paramètre optionnel - pour explorer le dossier <link linkend="ini.include-path">include_path</link>, - en le mettant à 1. - </para> - <para> - <example> - <title>Exemple avec <function>fopen</function></title> - <programlisting role="php"> -<?php -$fp = fopen("/home/rasmus/file.txt", "r"); -$fp = fopen("http://www.php.net/", "r"); -$fp = fopen("ftp://user:password@example.com/", "w"); -?> - </programlisting> - </example> - </para> - <simpara> - Si vous rencontrez des problèmes en lecture ou écriture - de fichier et que vous utilisez PHP en version module de serveur, - n'oubliez pas que les fichiers auxquels vous accédez ne sont - pas nécessairement accessibles au processus serveur. - </simpara> - <para> - Sous Windows, assurez-vous de bien échapper les anti-slash - utilisés dans le chemin du fichier, ou bien utilisez des slash. - <informalexample> - <programlisting role="php"> -<?php -$fp = fopen("c:\\data\\info.txt", "r"); -?> </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érifie si un fichier existe.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>file_exists</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> <simpara> - Voir aussi - <function>fclose</function>, - <function>fsockopen</function>, - <function>socket_set_timeout</function> et - <function>popen</function>. + <function>file_exists</function> retourne <literal>TRUE</literal> si le fichier + <parameter>filename</parameter> existe, et <literal>FALSE</literal> sinon. + </simpara> + <simpara> + <function>file_exists</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <simpara> + Le résultat de <function>file_exists</function> est mis en cache. + Reportez-vous à <function>clearstatcache</function> pour + plus de détails. </simpara> </refsect1> </refentry> - <refentry id="function.fpassthru"> - <refnamediv> - <refname>fpassthru</refname> - <refpurpose> - Affiche la partie du fichier située après le pointeur du fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fpassthru</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fpassthru</function> lit tout le reste d'un fichier - jusqu'à la fin, et dirige le résultat vers la sortie standard. - </simpara> - <simpara> - Si une erreur survient, <function>fpassthru</function> retourne <literal>FALSE</literal>. - </simpara> + <refentry id="function.fileatime"> + <refnamediv> + <refname>fileatime</refname> + <refpurpose> + Renvoie la date à laquelle le fichier a été + accédé pour la dernière fois. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileatime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fileatime</function> renvoie la date à laquelle le fichier + a été accédé pour la dernière fois, ou + <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <simpara> + Le résultat de <function>fileatime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </simpara> + </refsect1> + </refentry> + <refentry id="function.filectime"> + <refnamediv> + <refname>filectime</refname> + <refpurpose> + Renvoie l'heure à laquelle l'inode a été + accédé pour la dernière fois. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filectime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filectime</function> renvoie l'heure à laquelle l'inode + <parameter>filename</parameter> a été accédé pour + la dernière fois, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Note: Sur la plus part des serveurs UNIX, un fichier est considéré + comme modifié si les données de sont inode sont modifiées. C'est à + dire lorsque les permissions (utilisateur, group ou autre) ont + été modifiées. Voyez aussi <function>filemtime</function> + (que vous pourrez utiliser lorsque vous créerez des indications + telles que "Dernière modification : " sur les pages web) et + <function>fileatime</function>. + </para> + <para> + Notea aussi que sur certains systèmes UNIX, le ctime d'un fichier + texte est considéré comme sa date de création. Cela est faux! + Il n'y a pas de date de création de fichier sous la plus part + des systèmes UNIX. + </para> + <para> + Le résultat de <function>filectime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filegroup"> + <refnamediv> + <refname>filegroup</refname> + <refpurpose>Lire le nom du groupe</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filegroup</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filegroup</function> renvoie le groupe qui possède le fichier + <parameter>filename</parameter> ou <literal>FALSE</literal> en cas d'erreur. + L'identifiant de groupe est retourné au format numérique, utilisez + <function>posix_getgrgid</function> pour retrouver le nom du groupe. + </para> + <simpara> + <function>filegroup</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filegroup</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <note> <simpara> - Le pointeur de fichier doit être valide, et doit avoir été - correctement ouvert par <function>fopen</function>, <function>popen</function>, - ou <function>fsockopen</function>. Après lecture, - <function>fpassthru</function> va fermer le fichier (le pointeur - <parameter>fp</parameter> sera alors invalide). + <function>filegroup</function> est inopérante sous Windows. </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.fileinode"> + <refnamediv> + <refname>fileinode</refname> + <refpurpose>Renvoie le numéro d'inode du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileinode</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileinode</function> renvoie le numéro d'inode du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Le résultat de <function>fileinode</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>fileinode</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <note> <simpara> - Si vous voulez simplement afficher le contenu d'un fichier, il - suffit d'utiliser <function>readfile</function>, ce qui épargnera - l'appel à <function>fopen</function>. + <function>fileinode</function> est inopérante sous Windows. </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.filemtime"> + <refnamediv> + <refname>filemtime</refname> + <refpurpose> + Renvoie la date de dernière modification du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filemtime</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filemtime</function> renvoie la date de dernière + modification du fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> + en cas d'erreur. + </para> + <para> + Le résultat de <function>filemtime</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>filemtime</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Note: <function>filemtime</function> retourne l'heure d'écriture + des blocs données d'un fichier. Utilisez <function>date</function> + sur ce résultat pour obtenir une date de modification humainement + lisible. + </para> + </refsect1> + </refentry> + <refentry id="function.fileowner"> + <refnamediv> + <refname>fileowner</refname> + <refpurpose>Renvoie le nom du possesseur du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileowner</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileowner</function> renvoie le nom du possesseur du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> en cas d'erreur. + L'identification du possesseur de fichier est numé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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>fileowner</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + <note> <simpara> - Voir aussi - <function>readfile</function>, - <function>fopen</function>, - <function>popen</function> et - <function>fsockopen</function>. + <function>fileowner</function> est inopérante sous Windows. </simpara> - </refsect1> - </refentry> - <refentry id="function.fputs"> - <refnamediv> - <refname>fputs</refname> - <refpurpose>Ecrit dans un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fputs</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>string <parameter>str</parameter></paramdef> - <paramdef>int + </note> + </refsect1> + </refentry> + <refentry id="function.fileperms"> + <refnamediv> + <refname>fileperms</refname> + <refpurpose> + Renvoie les permissions affectées au fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fileperms</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fileperms</function> renvoie les permissions affectées + au fichier <parameter>filename</parameter>, ou <literal>FALSE</literal> + 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>fileperms</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filesize"> + <refnamediv> + <refname>filesize</refname> + <refpurpose>Renvoie la taille du fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>filesize</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filesize</function> renvoie la taille du fichier + <parameter>filename</parameter>, ou <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filesize</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus + de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.filetype"> + <refnamediv> + <refname>filetype</refname> + <refpurpose>Retourne le type de fichier</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>filetype</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>filetype</function> renvoie le type du fichier + <parameter>filename</parameter>. Les réponses possibles sont : + fifo, char, dir, block, link, file, et unknown. + </para> + <para> + <function>filetype</function> retourne <literal>FALSE</literal> 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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>filetype</function> est mis en cache. + Reportez vous à <function>clearstatcache</function> pour plus de + détails. + </para> + </refsect1> + </refentry> + <refentry id="function.flock"> + <refnamediv> + <refname>flock</refname> + <refpurpose>Verrouille le fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>flock</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>operation</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + PHP dispose d'un système complet de verrouillage de fichiers. + Tous les programmes qui accèdent au fichier doivent utiliser la + même méthode de verrouillage pour qu'il soit efficace. + </simpara> + <simpara> + <function>flock</function> agit sur le fichier <parameter>fp</parameter> + qui doit avoir été ouvert au pré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 (écriture), + <parameter>operation</parameter> = 2. + </simpara> + </listitem> + <listitem> + <simpara> + Libération d'un verrou (partagé 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 à <parameter>operation</parameter>. + </simpara> + </listitem> + </itemizedlist> + </para> + <simpara> + <function>flock</function> permet de réaliser un système simple de + verrous écriture / lecture, qui peut être utilisé sur + n'importe quelle plate-forme (Unix et Windows compris). + </simpara> + <simpara> + <function>flock</function> retourne <literal>TRUE</literal> en cas + de succès, et <literal>FALSE</literal> + sinon. (le verrou n'a pas pu être obtenu). + </simpara> + <warning> + <para> + Sur la plus part des OS, <function>flock</function> est implémenté + au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, + comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> + pour protéger vos fichiers contre des accès concurents du + mê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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fopen</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + <paramdef>int <parameter> - <optional>length</optional> + <optional>use_include_path</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <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ètre optionnel, - et si il n'est pas spécifié, toute la chaîne - est é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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>fread</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>length</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fread</function> lit jusqu'à <parameter>length</parameter> - octets dans le fichier reférencé par <parameter>fp</parameter>. - La lecture s'arrête lorsque <parameter>length</parameter> octets - ont été 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"> + </funcprototype> + </funcsynopsis> + <simpara> + Si <parameter>filename</parameter> commence par "http://" (insensible à + la casse), une connexion HTTP 1.x est ouverte avec le serveur + spécifié, et un pointeur sur la réponse fournie est + retourné. + </simpara> + <simpara> + Attention, <function>fopen</function> ne gère pas les redirections, + ce qui oblige à ajouter les slash " / " finaux pour indiquer un dossier. + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par "ftp://" (insensible à + la casse), une connexion FTP est ouverte avec le serveur spécifié, + et un pointeur sur la réponse fournie est retourné. Si le serveur + ne supporte par le mode FTP passif, <function>fopen</function> échouera. + Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture + seulement (le full duplex n'est pas supporté). + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", + ou "php://stderr", le flot correspondant sera ouvert. (Cela a été + introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" + ou "/dev/fd/0" devaient être utilisés pour accéder à + ces flots). + </simpara> + <simpara> + Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP + tentera de lire ce fichier dans le système local, et un pointeur sur + le fichier ouvert sera retourné. + </simpara> + <simpara> + Si l'ouverture échoue, <function>fopen</function> retourne + <literal>FALSE</literal>. + </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ébut du fichier. + </simpara> + </listitem> + <listitem> + <simpara> + 'r+' - Ouvre en lecture et écriture, et place le pointeur de + fichier au début du fichier. + </simpara> + </listitem> + <listitem> + <simpara> + 'w' - Ouvre en écriture seule; place le pointeur de fichier au + début du fichier et réduit la taille du fichier à 0. + Si le fichier n'existe pas, on tente de le créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'w+' - Ouvre en lecture et écriture; place le pointeur de fichier + au début du fichier et réduit la taille du fichier à + 0. Si le fichier n'existe pas, on tente de le créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'a' - Ouvre en écriture seule; place le pointeur de fichier à + la fin du fichier file. Si le fichier n'existe pas, on tente de le + créer. + </simpara> + </listitem> + <listitem> + <simpara> + 'a+' - Ouvre en lecture et écriture; place le pointeur de fichier + à la fin du fichier. Si le fichier n'existe pas, on tente de le + créer. + </simpara> + </listitem> + </itemizedlist> + De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option + n'est utile que sur les systèmes qui font la différence entre + les fichiers binaires et les fichiers textes (en bref, c'est une + fonctionnalité Windows, totalement inutile sous Unix). + Si il n'est pas nécessaire, il sera ignoré. + </para> + <para> + Vous pouvez utiliser le troisième paramètre optionnel + pour explorer le dossier <link linkend="ini.include-path">include_path</link>, + en le mettant à 1. + </para> + <para> + <example> + <title>Exemple avec <function>fopen</function></title> + <programlisting role="php"> +<?php +$fp = fopen("/home/rasmus/file.txt", "r"); +$fp = fopen("http://www.php.net/", "r"); +$fp = fopen("ftp://user:password@example.com/", "w"); +?> + </programlisting> + </example> + </para> + <simpara> + Si vous rencontrez des problèmes en lecture ou écriture + de fichier et que vous utilisez PHP en version module de serveur, + n'oubliez pas que les fichiers auxquels vous accédez ne sont + pas nécessairement accessibles au processus serveur. + </simpara> + <para> + Sous Windows, assurez-vous de bien échapper les anti-slash + utilisés dans le chemin du fichier, ou bien utilisez des slash. + <informalexample> + <programlisting role="php"> +<?php +$fp = fopen("c:\\data\\info.txt", "r"); +?> + </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ée après le pointeur du fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fpassthru</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fpassthru</function> lit tout le reste d'un fichier + jusqu'à la fin, et dirige le résultat vers la sortie standard. + </simpara> + <simpara> + Si une erreur survient, <function>fpassthru</function> retourne <literal>FALSE</literal>. + </simpara> + <simpara> + Le pointeur de fichier doit être valide, et doit avoir été + correctement ouvert par <function>fopen</function>, <function>popen</function>, + ou <function>fsockopen</function>. Aprè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 épargnera + l'appel à <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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fputs</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>string <parameter>str</parameter></paramdef> + <paramdef>int + <parameter> + <optional>length</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <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ètre optionnel, + et si il n'est pas spécifié, toute la chaîne + est é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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>fread</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fread</function> lit jusqu'à <parameter>length</parameter> + octets dans le fichier reférencé par <parameter>fp</parameter>. + La lecture s'arrête lorsque <parameter>length</parameter> octets + ont été 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"> <?php // Lit un fichier, et le place dans une chaîne $filename = "/usr/local/quelquechose.txt"; @@ -1361,76 +1362,76 @@ $contents = fread($fd, filesize ($filename)); fclose($fd); ?> - </programlisting> - </informalexample> + </programlisting> + </informalexample> + </para> + <note> + <para> + Sur les systèmes qui différentient les fichiers + textes et binaires (i.e. Windows) le fichier doit être + ouvert avec la lettre 'b' ajoutée au paramètre + de mode de la fonction <function>fopen</function>. </para> - <note> - <para> - Sur les systèmes qui différentient les fichiers - textes et binaires (i.e. Windows) le fichier doit être - ouvert avec la lettre 'b' ajoutée au paramètre - de mode de la fonction <function>fopen</function>. - </para> - </note> - <note> - <para> - <informalexample> - <programlisting role="php"> + </note> + <note> + <para> + <informalexample> + <programlisting role="php"> <?php $filename = "c:\\fichiers\\uneimage.gif"; $fd = fopen($filename, "rb"); $contents = fread($fd, filesize ($filename)); fclose($fd); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>fscanf</function></funcdef> - <paramdef>int <parameter>handle</parameter></paramdef> - <paramdef>string <parameter>format</parameter></paramdef> - <paramdef>string - <parameter><optional>var1</optional></parameter>... - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fscanf</function> est similaire à - <function>sscanf</function>, mais elle prend comme - entrée un fichier, associé à - <parameter>handle</parameter> et l'interprète en - fonction du format <parameter>format</parameter>. Si - seulement deux paramètres sont passés - à la fonction, les valeurs parsées seront - retournées sous forme de tableau. Si des arguments - optionnels sont passés, la fonction retournera le - nombre de valeurs assignées. Les options doivent - être passées par référence. - <example> - <title>Exemple <function>fscanf</function></title> - <programlisting role="php"> + </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> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>fscanf</function></funcdef> + <paramdef>int <parameter>handle</parameter></paramdef> + <paramdef>string <parameter>format</parameter></paramdef> + <paramdef>string + <parameter><optional>var1</optional></parameter>... + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fscanf</function> est similaire à + <function>sscanf</function>, mais elle prend comme + entrée un fichier, associé à + <parameter>handle</parameter> et l'interprète en + fonction du format <parameter>format</parameter>. Si + seulement deux paramètres sont passés + à la fonction, les valeurs parsées seront + retournées sous forme de tableau. Si des arguments + optionnels sont passés, la fonction retournera le + nombre de valeurs assignées. Les options doivent + être passées par référence. + <example> + <title>Exemple <function>fscanf</function></title> + <programlisting role="php"> <?php $fp = fopen ("users.txt","r"); while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { @@ -1439,275 +1440,275 @@ } fclose($fp); ?> - </programlisting> - </example> - <example> - <title>users.txt</title> - <programlisting role="txt"> + </programlisting> + </example> + <example> + <title>users.txt</title> + <programlisting role="txt"> janus argonaute gr rodin sculpteur fr som 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fseek</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>offset</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fseek</function> modifie le curseur de position - dans le fichier <parameter>fp</parameter>. La nouvelle position - mesurée en octets à partir du début du fichier, - est obtenue en additionnant la distance <parameter>offset</parameter> - à la position <parameter>whence</parameter>. Ce paramè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ée à <parameter>offset</parameter> octets. - </member> - <member> - SEEK_END - La position finale vaut la position courante par rapport à - la fin du fichier, ajoutée de <parameter>offset</parameter>. - </member> - </simplelist> - </para> - <para> - Si <parameter>whence</parameter> n'est pas spécifiée, il - vaut par défaut SEEK_SET. - </para> - <para> - <function>fseek</function> retourne <literal>TRUE</literal> en cas de - succès, et sinon -1. Notez que positionner le pointeur au - delà de la fin du fichier n'est pas une erreur. + </programlisting> + </example> </para> - <para> - Ne peut pas être utilisé sur les pointeurs - retournés par <function>fopen</function> s'ils sont - au format HTTP ou FTP. - </para> + <para> + Voir aussi + <function>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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fseek</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>offset</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fseek</function> modifie le curseur de position + dans le fichier <parameter>fp</parameter>. La nouvelle position + mesurée en octets à partir du début du fichier, + est obtenue en additionnant la distance <parameter>offset</parameter> + à la position <parameter>whence</parameter>. Ce paramè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ée à <parameter>offset</parameter> octets. + </member> + <member> + SEEK_END - La position finale vaut la position courante par rapport à + la fin du fichier, ajoutée de <parameter>offset</parameter>. + </member> + </simplelist> + </para> + <para> + Si <parameter>whence</parameter> n'est pas spécifiée, il + vaut par défaut SEEK_SET. + </para> + <para> + <function>fseek</function> retourne <literal>TRUE</literal> en cas de + succès, et sinon -1. Notez que positionner le pointeur au + delà de la fin du fichier n'est pas une erreur. + </para> + <para> + Ne peut pas être utilisé sur les pointeurs + retournés par <function>fopen</function> s'ils sont + au format HTTP ou FTP. + </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 à partir d'un pointeur de fichier + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>fstat</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>fstat</function> rassemble les informations sur le fichier dont on + connaît le pointeur <parameter>fp</parameter>. <function>fstat</function> + est similaire à 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 élé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étaire </simpara></listitem> + <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>7 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>8 : taille en octets </simpara></listitem> + <listitem><simpara>9 : date du dernier accès </simpara></listitem> + <listitem><simpara>10 : date de la dernière modification </simpara></listitem> + <listitem><simpara>11 : date du dernier changement </simpara></listitem> + <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> + <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize + type les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>fstat</function> sont mis en cache. + Reportez-vous à la fonction <function>clearstatcache</function> + pour plus de dé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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ftell</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftell</function> retourne la position courante du pointeur dans le + fichier repéré par le pointeur <parameter>fp</parameter>, i.e., + son offset. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ftruncate</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>size</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>ftruncate</function> prend le pointeur de fichier + <parameter>fp</parameter> et le tronque à la taille de + <parameter>size</parameter>.<function>ftruncate</function> retourne + <literal>TRUE</literal> en cas de succès, et + <literal>FALSE</literal> 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>fwrite</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>string <parameter>string</parameter></paramdef> + <paramdef>int + <parameter> + <optional>length</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>fwrite</function> écrit le contenu de la chaîne + <parameter>string</parameter> dans le fichier pointé par + <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> + est fournie, l'écriture s'arrêtera après + <parameter>length</parameter> octets, ou à la fin de la + chaî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ée, et les slash seront conservés. + </simpara> + <note> <para> - Voir aussi <function>ftell</function> et <function>rewind</function>. + De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option + n'est utile que sur les systèmes qui font la différence entre + les fichiers binaires et les fichiers textes (en bref, c'est une + fonctionnalité Windows, totalement inutile sous Unix). + Si il n'est pas nécessaire, il sera ignoré. </para> - </refsect1> - </refentry> - <refentry id="function.fstat"> - <refnamediv> - <refname>fstat</refname> - <refpurpose> - Lit les informations sur un fichier à partir d'un pointeur de fichier - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>fstat</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>fstat</function> rassemble les informations sur le fichier dont on - connaît le pointeur <parameter>fp</parameter>. <function>fstat</function> - est similaire à la fonction <function>stat</function>, hormis - le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier. - </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>set_file_buffer</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + <paramdef>int <parameter>buffer</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + L'écriture de fichier avec <function>fwrite</function> utilise normalement + un buffer de 8K. Cela signifie que si deux processus essaie d'écrire + dans le même fichier, ils font une pause tous les 8ko pour laisser le temps + à l'autre d'écrire à son tour. + <function>set_file_buffer</function> permet de modifier la taille du buffer de + sortie pour le pointeur de fichier <parameter>fp</parameter> à + <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, + l'écriture se fera sans buffer. Cela force l'écriture de toutes + les données par un processus avant que les autres puisse accéder + au fichier. + </simpara> + <simpara> + <function>set_file_buffer</function> retourne 0 en cas de succès, ou + EOF si la requête ne peut pas être honorée. + </simpara> <para> - <function>fstat</function> retourne un tableau avec les élé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étaire </simpara></listitem> - <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>7 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>8 : taille en octets </simpara></listitem> - <listitem><simpara>9 : date du dernier accès </simpara></listitem> - <listitem><simpara>10 : date de la dernière modification </simpara></listitem> - <listitem><simpara>11 : date du dernier changement </simpara></listitem> - <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> - <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize - type les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>fstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de dé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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ftell</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ftell</function> retourne la position courante du pointeur dans le - fichier repéré par le pointeur <parameter>fp</parameter>, i.e., - son offset. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ftruncate</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>size</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>ftruncate</function> prend le pointeur de fichier - <parameter>fp</parameter> et le tronque à la taille de - <parameter>size</parameter>. La fonction retourne - <literal>TRUE</literal> en cas de succès, et - <literal>FALSE</literal> 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>fwrite</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>string <parameter>string</parameter></paramdef> - <paramdef>int - <parameter> - <optional>length</optional> - </parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - <function>fwrite</function> écrit le contenu de la chaîne - <parameter>string</parameter> dans le fichier pointé par - <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> - est fournie, l'écriture s'arrêtera après - <parameter>length</parameter> octets, ou à la fin de la - chaî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ée, et les slash seront conservés. - </simpara> - <note> - <para> - De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option - n'est utile que sur les systèmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - Si il n'est pas nécessaire, il sera ignoré. - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>set_file_buffer</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - <paramdef>int <parameter>buffer</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - L'écriture de fichier avec <function>fwrite</function> utilise normalement - un buffer de 8K. Cela signifie que si deux processus essaie d'écrire - dans le même fichier, ils font une pause tous les 8ko pour laisser le temps - à l'autre d'écrire à son tour. - <function>set_file_buffer</function> permet de modifier la taille du buffer de - sortie pour le pointeur de fichier <parameter>fp</parameter> à - <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, - l'écriture se fera sans buffer. Cela force l'écriture de toutes - les données par un processus avant que les autres puisse accéder - au fichier. - </simpara> - <simpara> - <function>set_file_buffer</function> retourne 0 en cas de succès, ou - EOF si la requête ne peut pas être honorée. - </simpara> - <para> - L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour créer un fichier - sans buffer. - <example> - <title>Exemple avec <function>set_file_buffer</function></title> - <programlisting role="php"> + L'exemple suivant montre comment utiliser la fonction + <function>set_file_buffer</function> pour créer un fichier + sans buffer. + <example> + <title>Exemple avec <function>set_file_buffer</function></title> + <programlisting role="php"> <?php $fp=fopen($file, "w"); if($fp){ @@ -1716,1081 +1717,1079 @@ fclose($fp); } ?> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>fopen</function> - <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> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_dir</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_dir</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un dossier. - </para> - <para> - Le résultat de <function>is_dir</function> est mis en cache. Voir la fonction - <function>clearstatcache</function> pour plus de détails. - </para> - <simpara> - <function>is_dir</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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écutable.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_executable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_executable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est exécutable. - </para> - <para> - Le résultat de <function>is_executable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_executable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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éritable fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_file</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un fichier - (et pas un dossier). - </para> - <para> - Le résultat de <function>is_file</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_file</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le systè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> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_link</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_link</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est un lien symbolique. - </para> - <para> - Le résultat de <function>is_link</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>fopen</function> + <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> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_dir</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_dir</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un dossier. + </para> + <para> + Le résultat de <function>is_dir</function> est mis en cache. Voir la fonction + <function>clearstatcache</function> pour plus de détails. + </para> + <simpara> + <function>is_dir</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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écutable.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_executable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_executable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est exécutable. + </para> + <para> + Le résultat de <function>is_executable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_executable</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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éritable fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_file</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un fichier + (et pas un dossier). + </para> + <para> + Le résultat de <function>is_file</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_file</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_link</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_link</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est un lien symbolique. + </para> + <para> + Le résultat de <function>is_link</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_link</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>is_link</function> est inopérante sous Windows. </simpara> - <para> - Voir aussi - <function>is_dir</function> et - <function>is_file</function>. - </para> - <note> - <simpara> - <function>is_link</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.is-readable"> - <refnamediv> - <refname>is_readable</refname> - <refpurpose>Indique un fichier est autorisé en lecture</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_readable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_readable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est accessible en lecture. - </para> - <para> - N'oubliez pas que PHP accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est 'nobody', personne). - </para> - <para> - Le résultat de <function>is_readable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + </note> + </refsect1> + </refentry> + <refentry id="function.is-readable"> + <refnamediv> + <refname>is_readable</refname> + <refpurpose>Indique un fichier est autorisé en lecture</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_readable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_readable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est accessible en lecture. + </para> + <para> + N'oubliez pas que PHP accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est 'nobody', personne). + </para> + <para> + Le résultat de <function>is_readable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + détails. + </para> + <simpara> + <function>is_readable</function> ne fonctionne pas sur les + <link linkend="features.remote-files">fichiers distants</link>. + Les fichiers doivent être accessibles par le systè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é en écriture.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_writable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_writable</function> retourne <literal>TRUE</literal> si + <parameter>filename</parameter> existe et est accessible en écriture. + </para> + <para> + N'oubliez pas que PHP accède aux fichiers avec les mê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 être accessibles par le système de fichier + du serveur. + </simpara> + <para> + Le résultat de <function>is_writable</function> est mis en cache. + Voir la fonction <function>clearstatcache</function> pour plus de + dé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é en écriture.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_writeable</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 été téléchargé + par HTTP POST + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>is_uploaded_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>is_uploaded_file</function> est disponible à partir des + versions PHP 3.0.16 et 4.0.2. + </para> + <para> + <function>is_uploaded_file</function> retourne <literal>TRUE</literal> si le fichier + <varname>filename</varname> a été téléchargé + par HTTP POST. Cela est très utile pour vous assurer qu'un + utilisateur n'essaie pas d'accéder intentionnellement à + un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). + </para> + <para> + Ce type de vérification est spécialement important si il est + possible que les fichiers téléchargés + révélent leur contenu à l'utilisateur, ou + même aux utilisateurs du même système. + </para> + <para> + Voir aussi <function>move_uploaded_file</function>, et la section + <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ée un lien.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>link</function></funcdef> + <paramdef>string <parameter>target</parameter></paramdef> + <paramdef>string <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>link</function> crée un lien. + </para> + <para> + Voir aussi <function>symlink</function> pour créer des liens + symboliques et <function>readlink</function> avec <function>linkinfo</function>. + </para> + <note> <simpara> - <function>is_readable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>link</function> est inopérante sous Windows. </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é en écriture.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_writable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_writable</function> retourne <literal>TRUE</literal> si - <parameter>filename</parameter> existe et est accessible en écriture. - </para> - <para> - N'oubliez pas que PHP accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est 'nobody', personne). - </para> + </note> + </refsect1> + </refentry> + <refentry id="function.linkinfo"> + <refnamediv> + <refname>linkinfo</refname> + <refpurpose>Renvoie les informations à propos d'un lien.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>linkinfo</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>linkinfo</function> renvoie les informations à propos + d'un lien le champs st_dev de la structure d'information d' UNIX + (comme en langage C). <function>linkinfo</function> sert à vérifier + si un lien (repéré par <parameter>path</parameter>) + existe (en utilisant la même méthode que la macro + S_ISLNK de stat.h). <function>linkinfo</function> retourne + <literal>FALSE</literal> en cas d'erreur. + </para> + <para> + Voir aussi <function>symlink</function>, <function>link</function>, + et <function>readlink</function>. + </para> + <note> <simpara> - <function>is_writable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. + <function>linkinfo</function> est inopérante sous Windows. </simpara> - <para> - Le résultat de <function>is_writable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - dé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é en écriture.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_writeable</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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 été téléchargé - par HTTP POST - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>is_uploaded_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>is_uploaded_file</function> est disponible à partir des - versions PHP 3.0.16 et 4.0.2. - </para> - <para> - <function>is_uploaded_file</function> retourne <literal>TRUE</literal> si le fichier - <varname>filename</varname> a été téléchargé - par HTTP POST. Cela est très utile pour vous assurer qu'un - utilisateur n'essaie pas d'accéder intentionnellement à - un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). - </para> - <para> - Ce type de vérification est spécialement important si il est - possible que les fichiers téléchargés - révélent leur contenu à l'utilisateur, ou - même aux utilisateurs du même système. - </para> - <para> - Voir aussi <function>move_uploaded_file</function>, et la section - <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ée un lien.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>link</function></funcdef> - <paramdef>string <parameter>target</parameter></paramdef> - <paramdef>string <parameter>link</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>link</function> crée un lien. - </para> - <para> - Voir aussi <function>symlink</function> pour créer des liens - symboliques et <function>readlink</function> avec <function>linkinfo</function>. - </para> - <note> - <simpara> - <function>link</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.linkinfo"> - <refnamediv> - <refname>linkinfo</refname> - <refpurpose>Renvoie les informations à propos d'un lien.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>linkinfo</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>linkinfo</function> renvoie les informations à propos - d'un lien le champs st_dev de la structure d'information d' UNIX - (comme en langage C). <function>linkinfo</function> sert à vérifier - si un lien (repéré par <parameter>path</parameter>) - existe (en utilisant la même méthode que la macro - S_ISLNK de stat.h). <function>linkinfo</function> retourne - <literal>FALSE</literal> 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érante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.mkdir"> - <refnamediv> - <refname>mkdir</refname> - <refpurpose>Crée un dossier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mkdir</function></funcdef> - <paramdef>string <parameter>pathname</parameter></paramdef> - <paramdef>int <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>mkdir</function> tente de créer un dossier dans - le chemin <parameter>pathname</parameter>. - </para> - <para> - Notez que vous aurez à préciser le mode en base octale, - ce qui signifie que vous aurez probablement un 0 comme premier chiffre : - <informalexample> - <programlisting role="php"> + </note> + </refsect1> + </refentry> + <refentry id="function.mkdir"> + <refnamediv> + <refname>mkdir</refname> + <refpurpose>Crée un dossier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mkdir</function></funcdef> + <paramdef>string <parameter>pathname</parameter></paramdef> + <paramdef>int <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>mkdir</function> tente de créer un dossier dans + le chemin <parameter>pathname</parameter>. + </para> + <para> + Notez que vous aurez à préciser le mode en base octale, + ce qui signifie que vous aurez probablement un 0 comme premier chiffre : + <informalexample> + <programlisting role="php"> <?php mkdir ("/chemin/de/mon/dossier", 0700); ?> - </programlisting> - </informalexample> - </para> - <para> - <function>mkdir</function> retourne <literal>TRUE</literal> en cas de - succès, et <literal>FALSE</literal> en cas d'é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éplace un fichier téléchargé.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>bool <function>move_uploaded_file</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>string <parameter>destination</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>move_uploaded_file</function> est disponible à 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éléchargé - par HTTP POST. Si le fichier est valide, il est déplacé - jusqu'à <parameter>destination</parameter>. - </para> - <para> - Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, - et <function>move_uploaded_file</function> retournera <literal>FALSE</literal>. - </para> - <para> - Si <parameter>filename</parameter> est un fichier - téléchargé, mais que pour une raison - quelconque, il ne peut être déplacé, rien ne se passe, - et <function>move_uploaded_file</function> retourne <literal>FALSE</literal>. - De plus, une alerte sera affichée. - </para> - <para> - Ce type de vérification est spécialement important s'il - est possible que les fichiers téléchargés - révélent leur contenu à l'utilisateur, - ou même aux utilisateurs du même système. - </para> - <para> - Voir aussi <function>move_uploaded_file</function>, et la section - <link linkend="features.file-upload">Chargement de fichier</link> - pour un exemple simple. - </para> - </refsect1> - </refentry> - <refentry id="function.pathinfo"> - <refnamediv> - <refname>pathinfo</refname> - <refpurpose>Retourne des informations sur un chemin système</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>pathinfo</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pathinfo</function> retourne un tableau associatif, - contenant les informations sur le chemin <parameter>path</parameter>. - Les elements de tableau suivants sont retourns : - <parameter>dirname</parameter>, <parameter>basename</parameter> - et <parameter>extension</parameter>. - </para> - <para> - <example> - <title>Exemple avec <function>pathinfo</function></title> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + <function>mkdir</function> retourne <literal>TRUE</literal> en cas de + succès, et <literal>FALSE</literal> en cas d'é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éplace un fichier téléchargé.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>move_uploaded_file</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>string <parameter>destination</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>move_uploaded_file</function> est disponible à 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éléchargé + par HTTP POST. Si le fichier est valide, il est déplacé + jusqu'à <parameter>destination</parameter>. + </para> + <para> + Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, + et <function>move_uploaded_file</function> retournera <literal>FALSE</literal>. + </para> + <para> + Si <parameter>filename</parameter> est un fichier + téléchargé, mais que pour une raison + quelconque, il ne peut être déplacé, rien ne se passe, + et <function>move_uploaded_file</function> retourne <literal>FALSE</literal>. + De plus, une alerte sera affichée. + </para> + <para> + Ce type de vérification est spécialement important s'il + est possible que les fichiers téléchargés + révélent leur contenu à l'utilisateur, + ou même aux utilisateurs du même système. + </para> + <para> + Voir aussi <function>move_uploaded_file</function>, et la section + <link linkend="features.file-upload">Chargement de fichier</link> + pour un exemple simple. + </para> + </refsect1> + </refentry> + <refentry id="function.pathinfo"> + <refnamediv> + <refname>pathinfo</refname> + <refpurpose>Retourne des informations sur un chemin système</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>pathinfo</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pathinfo</function> retourne un tableau associatif, + contenant les informations sur le chemin <parameter>path</parameter>. + Les éléments suivants sont retournés : + <parameter>dirname</parameter>, <parameter>basename</parameter> + et <parameter>extension</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>pathinfo</function></title> + <programlisting role="php"> <?php - $path_parts = pathinfo("/www/htdocs/index.html"); - echo $path_parts["dirname"] . "\n"; echo $path_parts["basename"] . "\n"; echo $path_parts["extension"] . "\n"; - ?> - </programlisting> - </example> - </para> - <para> - Va afficher : - <informalexample> - <programlisting> + </programlisting> + </example> + </para> + <para> + Va afficher : + <informalexample> + <programlisting> /www/htdocs index.html html - </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>dirname</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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>pclose</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>pclose</function> ferme un processus de pointeur de fichier ouvert par - <function>popen</function>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir - été ouvert correctement par <function>popen</function>. - </para> - <para> - <function>pclose</function> retourne le statut final du processus - exécuté. - </para> - <para> - Voir aussi <function>popen</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.popen"> - <refnamediv> - <refname>popen</refname> - <refpurpose>Crée un processus de pointeur de fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>popen</function></funcdef> - <paramdef>string <parameter>commet</parameter></paramdef> - <paramdef>string <parameter>mode</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <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 à celui retourné par <function>fopen</function>, - hormis le fait qu'il sera unidirectionel (lecture seule, ou - écriture seule), et doit être terminé par - <function>pclose</function>. Ce pointeur peut être utilisé - avec <function>fgets</function>, <function>fgetss</function> et - <function>fputs</function>. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + Voir aussi + <function>dirname</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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pclose</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pclose</function> ferme un processus de pointeur de fichier ouvert par + <function>popen</function>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir + été ouvert correctement par <function>popen</function>. + </para> + <para> + <function>pclose</function> retourne le statut final du processus + exécuté. + </para> + <para> + Voir aussi <function>popen</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.popen"> + <refnamediv> + <refname>popen</refname> + <refpurpose>Crée un processus de pointeur de fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>popen</function></funcdef> + <paramdef>string <parameter>commet</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <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 à celui retourné par <function>fopen</function>, + hormis le fait qu'il sera unidirectionel (lecture seule, ou + écriture seule), et doit être terminé par + <function>pclose</function>. Ce pointeur peut être utilisé + avec <function>fgets</function>, <function>fgetss</function> et + <function>fputs</function>. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + <informalexample> + <programlisting role="php"> <?php $fp = popen ("/bin/ls", "r"); ?> - </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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>readfile</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int + </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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>readfile</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter> - <optional>use_include_path</optional> + <optional>use_include_path</optional> </parameter> </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>readfile</function> lit le fichier <parameter>filename</parameter> et - l'envoi à la sortie standard. - </para> - <para> - <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Si <parameter>filename</parameter> commence par "http://" (insensible - à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur - spécifié, et le texte de la réponse sera affiché - sur la sortie standard. - </para> - <para> - ATTENTION : PHP ne gère pas les redirections, donc il faut penser - à ajouter un "/" final pour les dossiers. - </para> - <para> - Si <parameter>filename</parameter> commence par "ftp://" (insensible - à la casse), une connexion FTP est ouverte avec l'hôte - spécifié et la réponse du serveur est affichée. - Si le serveur ne supporte les connexions passives, la requête - échouera. + </funcprototype> + </funcsynopsis> + <para> + <function>readfile</function> lit le fichier <parameter>filename</parameter> et + l'envoi à la sortie standard. </para> - <para> - Si <parameter>filename</parameter> ne commence par aucun des cas - précédents, le fichier sera ouvert sur l'hôte - local, et envoyé à la sortie standard. - </para> - <para> - Vous pouvez utiliser le deuxième paramè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> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>readlink</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + <para> + <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Si <parameter>filename</parameter> commence par "http://" (insensible + à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur + spécifié, et le texte de la réponse sera affiché + sur la sortie standard. + </para> + <para> + ATTENTION : PHP ne gère pas les redirections, donc il faut penser + à ajouter un "/" final pour les dossiers. + </para> + <para> + Si <parameter>filename</parameter> commence par "ftp://" (insensible + à la casse), une connexion FTP est ouverte avec l'hôte + spécifié et la réponse du serveur est affichée. + Si le serveur ne supporte les connexions passives, la requête + échouera. + </para> + <para> + Si <parameter>filename</parameter> ne commence par aucun des cas + précédents, le fichier sera ouvert sur l'hôte + local, et envoyé à la sortie standard. + </para> + <para> + Vous pouvez utiliser le deuxième paramè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> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>readlink</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> <function>readlink</function> fait la même chose que la fonction readlink en C : elle retourne le contenu du lien symbolique repéré par <parameter>path</parameter>, ou <literal>FALSE</literal> 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é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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rename</function></funcdef> - <paramdef>string <parameter>oldname</parameter></paramdef> - <paramdef>string <parameter>newname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rename</function> rente de renommer le fichier - <parameter>oldname</parameter> en <parameter>newname</parameter>. - </para> - <para> - <function>rename</function> retourne <literal>TRUE</literal> en cas de succès - et <literal>FALSE</literal> sinon. - </para> - </refsect1> - </refentry> - <refentry id="function.rewind"> - <refnamediv> - <refname>rewind</refname> - <refpurpose>Replace le pointeur de fichier au début.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rewind</function></funcdef> - <paramdef>int <parameter>fp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rewind</function> replace le pointeur du fichier - <parameter>fp</parameter> au début. - </para> - <para> - Si une erreur survient, retourne <literal>FALSE</literal>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rmdir</function></funcdef> - <paramdef>string <parameter>dirname</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>rmdir</function> tente d'effacer le dossier dont le chemin est - <parameter>dirname</parameter>. Le dossier doit être vide, - et le script doit avoir les autorisations adéquates. - </para> - <para> - Si une erreur survient, <function>rmdir</function> retourne <literal>FALSE</literal>. - </para> - <para> - Voir aussi <function>mkdir</function>. - </para> - </refsect1> - </refentry> - <refentry id="function.stat"> - <refnamediv> - <refname>stat</refname> - <refpurpose>Renvoie les informations à propos d'un fichier.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>stat</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>stat</function> renvoie les informations à propos du - fichier filename. - </para> - <para> - <function>stat</function> retourne un tableau avec les éléments suivants : - <itemizedlist> - <listitem><simpara>0 : volume </simpara></listitem> - <listitem><simpara>1 : inode</simpara></listitem> - <listitem> - <simpara> - 2 : droits d'accè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étaire </simpara></listitem> - <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>7 : taille en octets </simpara></listitem> - <listitem><simpara>8 : date du dernier accès </simpara></listitem> - <listitem><simpara>9 : date de la dernière modification </simpara></listitem> - <listitem><simpara>10 : date du dernier changement </simpara></listitem> - <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> - <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize type - les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>stat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> pour - plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.lstat"> - <refnamediv> - <refname>lstat</refname> - <refpurpose> - Renvoie les informations à propos d'un fichier ou d'un lien symbolique. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>array <function>lstat</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>lstat</function> est identique à <function>stat</function> - mais elle accepte aussi un lien symbolique comme argument. - </para> - <para> - <function>lstat</function> retourne un tableau avec les éléments suivants : - <itemizedlist> - <listitem><simpara>0 : volume </simpara></listitem> - <listitem><simpara>1 : inode</simpara></listitem> - <listitem> - <simpara> - 2 : droits d'accè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étaire </simpara></listitem> - <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> - <listitem><simpara>7 : taille en octets </simpara></listitem> - <listitem><simpara>8 : date du dernier accès </simpara></listitem> - <listitem><simpara>9 : date de la dernière modification </simpara></listitem> - <listitem><simpara>10 : date du dernier changement </simpara></listitem> - <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> - <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> - </itemizedlist> - * - uniquement sur les systèmes qui supporte le type st_blksize type - les autres systèmes (i.e. Windows) retourne -1. - </para> - <para> - Les résultats de <function>lstat</function> sont mis en cache. - Reportez vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> - </refsect1> - </refentry> - <refentry id="function.realpath"> - <refnamediv> - <refname>realpath</refname> - <refpurpose>Retourne le chemin canonique absolu.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>realpath</function></funcdef> - <paramdef>string <parameter>path</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>realpath</function> résoud tous les liens symboliques, et - remplace toutes les références '/./', '/../' et '/' de - <parameter>path</parameter> puis retourne le chemin canonique absolu - ainsi trouvé. Le résultat ne contient aucun lien symbolique, - '/./' ou '/../'. - </para> - <para> - <example> - <title>Exemple <function>realpath</function></title> - <programlisting role="php"> + </para> + <para> + Voir aussi <function>symlink</function>, <function>readlink</function> et + <function>linkinfo</function>. + </para> + <note> + <simpara> + <function>readlink</function> est inopé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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rename</function></funcdef> + <paramdef>string <parameter>oldname</parameter></paramdef> + <paramdef>string <parameter>newname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rename</function> rente de renommer le fichier + <parameter>oldname</parameter> en <parameter>newname</parameter>. + </para> + <para> + <function>rename</function> retourne <literal>TRUE</literal> en cas de succès + et <literal>FALSE</literal> sinon. + </para> + </refsect1> + </refentry> + <refentry id="function.rewind"> + <refnamediv> + <refname>rewind</refname> + <refpurpose>Replace le pointeur de fichier au début.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rewind</function></funcdef> + <paramdef>int <parameter>fp</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rewind</function> replace le pointeur du fichier + <parameter>fp</parameter> au début. + </para> + <para> + Si une erreur survient, retourne <literal>FALSE</literal>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rmdir</function></funcdef> + <paramdef>string <parameter>dirname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>rmdir</function> tente d'effacer le dossier dont le chemin est + <parameter>dirname</parameter>. Le dossier doit être vide, + et le script doit avoir les autorisations adéquates. + </para> + <para> + Si une erreur survient, <function>rmdir</function> retourne <literal>FALSE</literal>. + </para> + <para> + Voir aussi <function>mkdir</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.stat"> + <refnamediv> + <refname>stat</refname> + <refpurpose>Renvoie les informations à propos d'un fichier.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>stat</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>stat</function> renvoie les informations à propos du + fichier filename. + </para> + <para> + <function>stat</function> retourne un tableau avec les éléments suivants : + <itemizedlist> + <listitem><simpara>0 : volume </simpara></listitem> + <listitem><simpara>1 : inode</simpara></listitem> + <listitem> + <simpara> + 2 : droits d'accè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étaire </simpara></listitem> + <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>7 : taille en octets </simpara></listitem> + <listitem><simpara>8 : date du dernier accès </simpara></listitem> + <listitem><simpara>9 : date de la dernière modification </simpara></listitem> + <listitem><simpara>10 : date du dernier changement </simpara></listitem> + <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> + <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize type + les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>stat</function> sont mis en cache. + Reportez-vous à la fonction <function>clearstatcache</function> pour + plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.lstat"> + <refnamediv> + <refname>lstat</refname> + <refpurpose> + Renvoie les informations à propos d'un fichier ou d'un lien symbolique. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>lstat</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>lstat</function> est identique à <function>stat</function> + mais elle accepte aussi un lien symbolique comme argument. + </para> + <para> + <function>lstat</function> retourne un tableau avec les éléments suivants : + <itemizedlist> + <listitem><simpara>0 : volume </simpara></listitem> + <listitem><simpara>1 : inode</simpara></listitem> + <listitem> + <simpara> + 2 : droits d'accè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étaire </simpara></listitem> + <listitem><simpara>5 : id du groupe propriétaire</simpara></listitem> + <listitem><simpara>6 : type du volume de l' inode * </simpara></listitem> + <listitem><simpara>7 : taille en octets </simpara></listitem> + <listitem><simpara>8 : date du dernier accès </simpara></listitem> + <listitem><simpara>9 : date de la dernière modification </simpara></listitem> + <listitem><simpara>10 : date du dernier changement </simpara></listitem> + <listitem><simpara>11 : taille de bloc du système pour les entrées/sorties * </simpara></listitem> + <listitem><simpara>12 : nombre de blocs alloués</simpara></listitem> + </itemizedlist> + * - uniquement sur les systèmes qui supporte le type st_blksize type + les autres systèmes (i.e. Windows) retourne -1. + </para> + <para> + Les résultats de <function>lstat</function> sont mis en cache. + Reportez vous à la fonction <function>clearstatcache</function> + pour plus de détails. + </para> + </refsect1> + </refentry> + <refentry id="function.realpath"> + <refnamediv> + <refname>realpath</refname> + <refpurpose>Retourne le chemin canonique absolu.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>realpath</function></funcdef> + <paramdef>string <parameter>path</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>realpath</function> résoud tous les liens symboliques, et + remplace toutes les références '/./', '/../' et '/' de + <parameter>path</parameter> puis retourne le chemin canonique absolu + ainsi trouvé. Le résultat ne contient aucun lien symbolique, + '/./' ou '/../'. + </para> + <para> + <example> + <title>Exemple <function>realpath</function></title> + <programlisting role="php"> <?php $real_path = realpath ("../../index.php"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.symlink"> - <refnamediv> - <refname>symlink</refname> - <refpurpose>Crée un lien symbolique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>symlink</function></funcdef> - <paramdef>string <parameter>target</parameter></paramdef> - <paramdef>string <parameter>link</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>symlink</function> cré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éer des liens durs, - et <function>readlink</function> ainsi que <function>linkinfo</function>. - </para> - <note> - <simpara> - <function>symlink</function> est inopérante sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - <refentry id="function.tempnam"> - <refnamediv> - <refname>tempnam</refname> - <refpurpose>Crée un fichier avec un nom unique.</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>tempnam</function></funcdef> - <paramdef>string <parameter>dir</parameter></paramdef> - <paramdef>string <parameter>prefix</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tempnam</function> crée un fichier temporaire unique - dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, - <function>tempnam</function> va génèrer un nom de fichier - dans le dossier temporaire du système. - </para> - <para> - Le comportement de <function>tempnam</function> dépend du - système. Sous Windows, la variable d'environnement TMP sera - prioritaire par rapport au paramètre <parameter>dir</parameter>; - sous Linux la variable d'environnement TMPDIR aura la priorité, - tandis que l'OS SVR4 utilisera toujours le paramètre - <parameter>dir</parameter> si le dossier n'existe pas. Reportez - vous à la documentation de votre système(tempnam(3)). - </para> - <para> - <function>tempnam</function> retourne le nom du fichier temporaire, ou - la chaîne NULL en cas d'échec. - <example> - <title>Exemple avec <function>tempnam</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.symlink"> + <refnamediv> + <refname>symlink</refname> + <refpurpose>Crée un lien symbolique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>symlink</function></funcdef> + <paramdef>string <parameter>target</parameter></paramdef> + <paramdef>string <parameter>link</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>symlink</function> cré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éer des liens durs, + et <function>readlink</function> ainsi que <function>linkinfo</function>. + </para> + <note> + <simpara> + <function>symlink</function> est inopérante sous Windows. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.tempnam"> + <refnamediv> + <refname>tempnam</refname> + <refpurpose>Crée un fichier avec un nom unique.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>tempnam</function></funcdef> + <paramdef>string <parameter>dir</parameter></paramdef> + <paramdef>string <parameter>prefix</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tempnam</function> crée un fichier temporaire unique + dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, + <function>tempnam</function> va génèrer un nom de fichier + dans le dossier temporaire du système. + </para> + <para> + Le comportement de <function>tempnam</function> dépend du + système. Sous Windows, la variable d'environnement TMP sera + prioritaire par rapport au paramètre <parameter>dir</parameter>; + sous Linux la variable d'environnement TMPDIR aura la priorité, + tandis que l'OS SVR4 utilisera toujours le paramètre + <parameter>dir</parameter> si le dossier n'existe pas. Reportez + vous à la documentation de votre système(tempnam(3)). + </para> + <para> + <function>tempnam</function> retourne le nom du fichier temporaire, ou + la chaîne NULL en cas d'échec. + <example> + <title>Exemple avec <function>tempnam</function></title> + <programlisting role="php"> <?php $tmpfname = tempnam ("/tmp", "FOO"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.tmpfile"> - <refnamediv> - <refname>tmpfile</refname> - <refpurpose>Crée un fichier temporaire</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>tmpfile</function></funcdef> - <paramdef>void</paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>tmpfile</function> crée un fichier temporaire - avec un nom unique, ouvert en écriture, et retourne un - pointeur de fichier, identique à ceux retourné par - <function>fopen</function>. - Ce fichier sera automatiquement effacé lorsqu'il sera - fermé (avec <function>fclose</function>), ou lorsque le fichier - sera termniné. - </para> - <para> - Pour plus de détails, consultez votre documentation systè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 à un fichier. - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>touch</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter>time</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>touch</function> tente de forcer la date de modification du fichier - nommé <parameter>filename</parameter> à la date de - <parameter>time</parameter>. Si <parameter>time</parameter> est omis, - c'est l'heure courante qui est utilisée. - </para> - <para> - Si le fichier n'existe pas, il est crée. - </para> - <para> - <function>touch</function> retourne <literal>TRUE</literal> en cas de succès, - et <literal>FALSE</literal> sinon. - <example> - <title>Exemple avec <function>touch</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.tmpfile"> + <refnamediv> + <refname>tmpfile</refname> + <refpurpose>Crée un fichier temporaire</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>tmpfile</function></funcdef> + <paramdef>void</paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>tmpfile</function> crée un fichier temporaire + avec un nom unique, ouvert en écriture, et retourne un + pointeur de fichier, identique à ceux retourné par + <function>fopen</function>. + Ce fichier sera automatiquement effacé lorsqu'il sera + fermé (avec <function>fclose</function>), ou lorsque le fichier + sera termniné. + </para> + <para> + Pour plus de détails, consultez votre documentation systè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 à un fichier. + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>touch</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + <paramdef>int <parameter>time</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>touch</function> tente de forcer la date de modification du fichier + nommé <parameter>filename</parameter> à la date de + <parameter>time</parameter>. Si <parameter>time</parameter> est omis, + c'est l'heure courante qui est utilisée. + </para> + <para> + Si le fichier n'existe pas, il est crée. + </para> + <para> + <function>touch</function> retourne <literal>TRUE</literal> en cas de succès, + et <literal>FALSE</literal> sinon. + <example> + <title>Exemple avec <function>touch</function></title> + <programlisting role="php"> if ( touch($NomDeFichier) ) { print "La date de modification de $NomDeFichier a été fixée à maintenant"; } else { print "Désolé, 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>umask</function></funcdef> - <paramdef>int <parameter>mask</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>umask</function> change le umask de PHP : mask & 0777 et retourne le - vieux umask. Lorsque PHP est utilisé comme module de serveur, - le umask reprend sa valeur à la fin de chaque script. - </para> - <para> - <function>umask</function> appelé 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> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>unlink</function></funcdef> - <paramdef>string <parameter>filename</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>unlink</function> efface <parameter>filename</parameter>. - Identique à la fonction Unix C unlink(). - </para> - <para> - <function>unlink</function> retourne <literal>FALSE</literal> en cas d'échec. - </para> - <para> - Voir aussi <function>rmdir</function> pour supprimer des dossiers. - </para> - <note> - <simpara> - <function>unlink</function> peut ne pas fonctionner sous Windows. - </simpara> - </note> - </refsect1> - </refentry> - </reference> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.umask"> + <refnamediv> + <refname>umask</refname> + <refpurpose>Change le "umask" courant.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>umask</function></funcdef> + <paramdef>int <parameter>mask</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>umask</function> change le umask de PHP : mask & 0777 et retourne le + vieux umask. Lorsque PHP est utilisé comme module de serveur, + le umask reprend sa valeur à la fin de chaque script. + </para> + <para> + <function>umask</function> appelé 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> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>unlink</function></funcdef> + <paramdef>string <parameter>filename</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>unlink</function> efface <parameter>filename</parameter>. + Identique à la fonction Unix C unlink(). + </para> + <para> + <function>unlink</function> retourne <literal>FALSE</literal> en cas d'échec. + </para> + <para> + Voir aussi + <function>rmdir</function> pour supprimer des dossiers. + </para> + <note> + <simpara> + <function>unlink</function> peut ne pas fonctionner sous Windows. + </simpara> + </note> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml