cvs: phpdoc /fr/functions filesystem.xml

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