cvs: phpdoc-fr /reference/filesystem/functions basename.xml chgrp.xml chmod.xml chown.xml copy.xml dirname.xml disk-free-space.xml
disk-total-space.xml fclose.xml feof.xml fflush.xml fgetcsv.xml fgets.xml fgetss.xml file-exists.xml file-get-contents.xml file-put-contents.xml
file.xml fileatime.xml filectime.xml filegroup.xml fileinode.xml filemtime.xml fileowner.xml fileperms.xml filesize.xml filetype.xml flock.xml
fnmatch.xml fopen.xml fpassthru.xml fputs.xml fread.xml fscanf.xml fseek.xml fstat.xml ftell.xml ftruncate.xml fwrite.xml glob.xml is-dir.xml
is-executable.xml is-file.xml is-link.xml is-readable.xml is-uploaded-file.xml is-writable.xml is-writeable.xml link.xml linkinfo.xml lstat.xml
mkdir.xml move-uploaded-file.xml parse-ini-file.xml pathinfo.xml pclose.xml popen.xml readfile.xml readlink.xml realpath.xml rename.xml rewind.xml
rmdir.xml set-file-buffer.xml stat.xml symlink.xml tempnam.xml tmpfile.xml touch.xml umask.xml

From: Date: Sat, 03 May 2003 22:36:53 +0000
Subject: cvs: phpdoc-fr /reference/filesystem/functions basename.xml chgrp.xml chmod.xml chown.xml copy.xml dirname.xml disk-free-space.xml
disk-total-space.xml fclose.xml feof.xml fflush.xml fgetcsv.xml fgets.xml fgetss.xml file-exists.xml file-get-contents.xml file-put-contents.xml
file.xml fileatime.xml filectime.xml filegroup.xml fileinode.xml filemtime.xml fileowner.xml fileperms.xml filesize.xml filetype.xml flock.xml
fnmatch.xml fopen.xml fpassthru.xml fputs.xml fread.xml fscanf.xml fseek.xml fstat.xml ftell.xml ftruncate.xml fwrite.xml glob.xml is-dir.xml
is-executable.xml is-file.xml is-link.xml is-readable.xml is-uploaded-file.xml is-writable.xml is-writeable.xml link.xml linkinfo.xml lstat.xml
mkdir.xml move-uploaded-file.xml parse-ini-file.xml pathinfo.xml pclose.xml popen.xml readfile.xml readlink.xml realpath.xml rename.xml rewind.xml
rmdir.xml set-file-buffer.xml stat.xml symlink.xml tempnam.xml tmpfile.xml touch.xml umask.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-344@lists.php.net to get a copy of this message
dams Sat May 3 18:36:53 2003 EDT Added files: /phpdoc-fr/reference/filesystem/functions file-put-contents.xml fnmatch.xml glob.xml Modified files: /phpdoc-fr/reference/filesystem/functions basename.xml chgrp.xml chmod.xml chown.xml copy.xml dirname.xml disk-free-space.xml disk-total-space.xml fclose.xml feof.xml fflush.xml fgetcsv.xml fgets.xml fgetss.xml file-exists.xml file-get-contents.xml file.xml fileatime.xml filectime.xml filegroup.xml fileinode.xml filemtime.xml fileowner.xml fileperms.xml filesize.xml filetype.xml flock.xml fopen.xml fpassthru.xml fputs.xml fread.xml fscanf.xml fseek.xml fstat.xml ftell.xml ftruncate.xml fwrite.xml is-dir.xml is-executable.xml is-file.xml is-link.xml is-readable.xml is-uploaded-file.xml is-writable.xml is-writeable.xml link.xml linkinfo.xml lstat.xml mkdir.xml move-uploaded-file.xml parse-ini-file.xml pathinfo.xml pclose.xml popen.xml readfile.xml readlink.xml realpath.xml rename.xml rewind.xml rmdir.xml set-file-buffer.xml stat.xml symlink.xml tempnam.xml tmpfile.xml touch.xml umask.xml Log: keeping up with cvs

Index: phpdoc-fr/reference/filesystem/functions/basename.xml diff -u phpdoc-fr/reference/filesystem/functions/basename.xml:1.1 phpdoc-fr/reference/filesystem/functions/basename.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/basename.xml:1.1 Sun Apr 14 20:27:59 2002 +++ phpdoc-fr/reference/filesystem/functions/basename.xml Sat May 3 18:36:52 2003 @@ -10,11 +10,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>basename</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>suffix</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>basename</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>suffix</parameter></methodparam> + </methodsynopsis> <para> <function>basename</function> prend en param&egrave;tre le chemin complet d'un fichier et en extrait le nom du fichier. Si <optional>suffix</optional> @@ -30,11 +30,13 @@ <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; +<![CDATA[ +<?php + $path = "/home/httpd/html/index.php"; + $file = basename ($path); // $file is set to "index.php" + $file = basename ($path,".php"); // $file is set to "index" +?> +]]> </programlisting> </example> </para> @@ -42,11 +44,6 @@ Voir aussi <function>dirname</function>. </para> - <note> - <para> - <parameter>suffix</parameter> a &eacute;t&eacute; ajout&eacute; en PHP 4.1.0. - </para> - </note> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/chgrp.xml diff -u phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.1 phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.1 Sun Apr 14 20:27:59 2002 +++ phpdoc-fr/reference/filesystem/functions/chgrp.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.chgrp"> <refnamediv> <refname>chgrp</refname> - <refpurpose>Change le groupe possesseur du fichier.</refpurpose> + <refpurpose>Change le groupe propri&eacute;taire d'un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,27 +14,22 @@ <methodparam><type>mixed</type><parameter>group</parameter></methodparam> </methodsynopsis> <para> - <function>chgrp</function> essaie de changer le groupe propri&eacute;taire - du fichier. Seul le super-utilisateur (root) peut changer le groupe + <function>chgrp</function> essaie de remplacer le groupe propri&eacute;taire + courant du fichier <parameter>filename</parameter> par <parameter>group</parameter>. + Seul le super-utilisateur (root) peut changer le groupe propri&eacute;taire d'un fichier arbitrairement. Les utilisateurs - classiques ne peuvent changer - le groupe propri&eacute;taire d'un fichier que si l'utilisateur - propri&eacute;taire du fichier est membre du groupe. + classiques ne peuvent changer le groupe propri&eacute;taire d'un + fichier que si l'utilisateur propri&eacute;taire du fichier est + membre du groupe. </para> <para> - <function>chgrp</function> renvoie &true; en - cas de succ&egrave;s, sinon renvoie &false;. + &return.success; </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> Index: phpdoc-fr/reference/filesystem/functions/chmod.xml diff -u phpdoc-fr/reference/filesystem/functions/chmod.xml:1.1 phpdoc-fr/reference/filesystem/functions/chmod.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/chmod.xml:1.1 Sun Apr 14 20:27:59 2002 +++ phpdoc-fr/reference/filesystem/functions/chmod.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.chmod"> <refnamediv> <refname>chmod</refname> - <refpurpose>Change le mode du fichier.</refpurpose> + <refpurpose>Change le mode du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -22,31 +22,65 @@ 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> + <example> + <title>Comment utiliser <function>chmod</function></title> <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; +<![CDATA[ +chmod ("/somedir/somefile", 755); +// notation d&eacute;cimale : probablement faux +chmod ("/somedir/somefile", "u+rwx,go+rx"); +// cha&icirc;ne : incorrect +chmod ("/somedir/somefile", 0755); +// notation octale : valeur du mode correcte +]]> </programlisting> - </informalexample> + </example> </para> + <para> + Le param&egrave;tre <parameter>mode</parameter> est constitu&eacute; de trois + valeurs octacles qui sp&eacute;cifient les droits pour le propri&eacute;taire, + le group du propri&eacute;taire et les autres, respectivement. Chaque + composant peut &ecirc;tre calcul&eacute; en ajoutant les droits d&eacute;sir&eacute;s. + Le chiffre 1 donne les droits d'&eacute;x&eacute;cution, le chiffre 2 les droits + d'&eacute;criture et le chiffre 4 les droits de lecture. Ajoutez simplement + ces nombres pour sp&eacute;cifier les droits voulus. Vous pouvez aussi + lire le manuel des syst&egrave;mes Unix avec 'man 1 chmod' et 'man 2 chmod'. + <informalexample> + <programlisting role="php"> +<![CDATA[ +// Lecture et &eacute;criture pour le propri&eacute;taire, rien pour les autres +chmod ("/un_dossier/un_fichier", 0600); + +// Lecture et &eacute;criture pour le propri&eacute;taire, &eacute;criture pour les autres +chmod ("/un_dossier/un_fichier", 0644); + +// Tous pour le propri&eacute;taire, lecture et &eacute;criture pour les autres +chmod ("/un_dossier/un_fichier", 0755); + +// Tout pour le propri&eacute;taire, lecture ex&eacute;cution pour le groupe, rien pour les autres +chmod ("/un_dossier/un_fichier", 0750); +]]> + </programlisting> + </informalexample> + </para> + <para> + <note> + <para> + L'utilisateur courant est l'utilisateur avec lequel &php; fonctionne. + Il est probablement diff&eacute;rent de l'utilisateur que vous utilisez + en mode shell ou FTP. + </para> + </note> + </para> <para> - <function>chmod</function> renvoie &true; - en cas de succ&egrave;s, &false; sinon. + &return.success; </para> + &note.no-remote; <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> Index: phpdoc-fr/reference/filesystem/functions/chown.xml diff -u phpdoc-fr/reference/filesystem/functions/chown.xml:1.1 phpdoc-fr/reference/filesystem/functions/chown.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/chown.xml:1.1 Sun Apr 14 20:28:00 2002 +++ phpdoc-fr/reference/filesystem/functions/chown.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.chown"> <refnamediv> <refname>chown</refname> - <refpurpose>Change le groupe propri&eacute;taire du fichier.</refpurpose> + <refpurpose>Change le groupe propri&eacute;taire du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -19,25 +19,13 @@ arbitrairement d'un fichier. </para> <para> - <function>chown</function> renvoie &true; - en cas de succ&egrave;s, "&false;" sinon. - <note> - <simpara> - Sous Windows, <function>chown</function> ne fait rien et - retourne &true;. - </simpara> - </note> + &return.success; </para> + &note.no-remote; <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> Index: phpdoc-fr/reference/filesystem/functions/copy.xml diff -u phpdoc-fr/reference/filesystem/functions/copy.xml:1.1 phpdoc-fr/reference/filesystem/functions/copy.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/copy.xml:1.1 Sun Apr 14 20:28:00 2002 +++ phpdoc-fr/reference/filesystem/functions/copy.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.copy"> <refnamediv> <refname>copy</refname> - <refpurpose>Copie un fichier.</refpurpose> + <refpurpose>Copie un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,21 +14,43 @@ <methodparam><type>string</type><parameter>dest</parameter></methodparam> </methodsynopsis> <para> - <function>copy</function> fait une copie du fichier. Elle renvoie &true; en - cas de succ&egrave;s, &false; sinon. + <function>copy</function> fait une copie du fichier <parameter>source</parameter> + vers le fichier <parameter>dest</parameter>. &return.success; <example> <title>Exemple avec <function>copy</function></title> <programlisting role="php"> -if ( !copy($file, $file.'.bak') ) { - print("La copie du fichier $file n'a pas r&eacute;ussi...&lt;br&gt;\n"); -} +<![CDATA[ +<?php + if (!copy($file, $file.'.bak')) { + print("La copie du fichier $file n'a pas r&eacute;ussi...<BR>\n"); + } +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>rename</function>. - </para> + <note> + <para> + Depuis &php; 4.3.0, les deux param&egrave;tres <parameter>source</parameter> et + <parameter>dest</parameter> peuvent &ecirc;tre des URL si les gestionnaires + d'URL ont &eacute;t&eacute; activ&eacute;s ("fopen wrappers"). Voyez la fonction + <function>fopen</function> pour plus de d&eacute;tails. + Si <parameter>dest</parameter> est une URL, la copie peut &eacute;chouer si + ce protocole ne supporte pas l'&eacute;crasement de fichiers existants. + </para> + </note> + <warning> + <para> + Si le fichier de destination <parameter>dest</parameter> existe d&eacute;j&agrave;, + il sera &eacute;cras&eacute;. + </para> + </warning> + <para> + Voir aussi + <function>move_uploaded_file</function>, + <function>rename</function> et + la section sur les <link linkend="features.file-upload">t&eacute;l&eacute;chargements de fichiers</link>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/dirname.xml diff -u phpdoc-fr/reference/filesystem/functions/dirname.xml:1.1 phpdoc-fr/reference/filesystem/functions/dirname.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/dirname.xml:1.1 Sun Apr 14 20:28:01 2002 +++ phpdoc-fr/reference/filesystem/functions/dirname.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.dirname"> <refnamediv> <refname>dirname</refname> - <refpurpose>Renvoie le nom du dossier.</refpurpose> + <refpurpose>Renvoie le nom du dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,8 +13,8 @@ <methodparam><type>string</type><parameter>path</parameter></methodparam> </methodsynopsis> <para> - Si <parameter>path</parameter> contient le chemin d'un fichier ou dossier, - <function>dirname</function> retournera le nom du dossier qui le contient. + <function>dirname</function> retourne le nom du dossier qui contient le + fichier ou dossier <parameter>path</parameter>. </para> <para> Sous Windows, les slash (<literal>/</literal>) et anti-slash @@ -26,18 +26,37 @@ <example> <title>Exemple avec <function>dirname</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $path = "/etc/passwd"; - $file = dirname($path); // $file contient "/etc" -?&gt; + $file = dirname ($path); +// $file vaut "/etc" +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>basename</function>. - </para> - </refsect1> + <note> + <para> + En &php; 4.0.3, <function>dirname</function> a &eacute;t&eacute; modifi&eacute; pour &ecirc;tre + compatible POSIX. Cela signifie notamment que si il n'y a pas + de slash dans le param&egrave;tre <parameter>path</parameter>, un + point ('<literal>.</literal>') est retourn&eacute;, indiquant le + dossier courant. Sinon, la cha&icirc;ne retourn&eacute;e est + <parameter>path</parameter> avec le composant final + <literal>/composant</literal> supprim&eacute;. Notez que cela signifie + que vous allez obtenir un slash ou un point l&agrave; ou l'ancien + comportement de <function>dirname</function> retournait une + cha&icirc;ne vide. + </para> + </note> + <para> + Voir aussi + <function>basename</function>, + <function>pathinfo</function> et + <function>realpath</function>. + </para> + </refsect1> </refentry> <!-- Keep this comment at the end of the file Index: phpdoc-fr/reference/filesystem/functions/disk-free-space.xml diff -u phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.1 phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.1 Sun Apr 14 20:28:01 2002 +++ phpdoc-fr/reference/filesystem/functions/disk-free-space.xml Sat May 3 18:36:52 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./fr/functions/filesystem.xml, last change in rev 1.27 --> <!-- last change to 'disk-free-space' in en/ tree in rev 1.86 --> - <refentry id="function.disk_free_space"> + <refentry id="function.disk-free-space"> <refnamediv> <refname>disk_free_space</refname> <refpurpose> @@ -22,13 +22,16 @@ <example> <title>Exemple avec <function>disk_free_space</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $df = disk_free_space("/"); // $df contient le nombre d'octets libres sur "/" -?&gt; +?> +]]> </programlisting> </example> </para> + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/disk-total-space.xml diff -u phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.1 phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.1 Sun Apr 14 20:28:02 2002 +++ phpdoc-fr/reference/filesystem/functions/disk-total-space.xml Sat May 3 18:36:52 2003 @@ -22,14 +22,16 @@ <example> <title>Exemple avec <function>disk_total_space</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $df = disk_total_space("/"); // $df contient le nombre d'octets libres - // dans le dossier "/" -?&gt; + // dans le dossier "/" +?> +]]> </programlisting> </example> </para> - &note.sm.uidcheck; + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fclose.xml diff -u phpdoc-fr/reference/filesystem/functions/fclose.xml:1.2 phpdoc-fr/reference/filesystem/functions/fclose.xml:1.3 --- phpdoc-fr/reference/filesystem/functions/fclose.xml:1.2 Thu Feb 6 18:05:32 2003 +++ phpdoc-fr/reference/filesystem/functions/fclose.xml Sat May 3 18:36:52 2003 @@ -4,26 +4,41 @@ <refentry id="function.fclose"> <refnamediv> <refname>fclose</refname> - <refpurpose>Ferme un fichier.</refpurpose> + <refpurpose>Ferme un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>fclose</methodname> - <methodparam><type>resource</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>fclose</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> - <function>fclose</function> ferme le fichier <parameter>fp</parameter>. + <function>fclose</function> ferme le fichier <parameter>handle</parameter>. </para> <para> - <function>fclose</function> retourne &true; en cas de succ&egrave;s, - et &false; en cas d'&eacute;chec. + &return.success; </para> <para> Le pointeur de fichier doit &ecirc;tre valide et doit avoir &eacute;t&eacute; correctement ouvert par <function>fopen</function> ou <function>fsockopen</function>. </para> + <para> + <example> + <title>Exemple avec <function>fclose</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + + $handle = fopen('un_fichier.txt', 'r'); + + fclose($handle); + +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/feof.xml diff -u phpdoc-fr/reference/filesystem/functions/feof.xml:1.1 phpdoc-fr/reference/filesystem/functions/feof.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/feof.xml:1.1 Sun Apr 14 20:28:04 2002 +++ phpdoc-fr/reference/filesystem/functions/feof.xml Sat May 3 18:36:52 2003 @@ -4,17 +4,17 @@ <refentry id="function.feof"> <refnamediv> <refname>feof</refname> - <refpurpose>Teste la fin du fichier.</refpurpose> + <refpurpose>Teste la fin du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>feof</methodname> - <methodparam><type>resource</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>feof</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>feof</function> retourne &true; si le pointeur - <parameter>fp</parameter> est &agrave; la fin du fichier, ou si + <parameter>handle</parameter> est &agrave; la fin du fichier, ou si une erreur survient, sinon, retourne &false;. </para> <para> Index: phpdoc-fr/reference/filesystem/functions/fflush.xml diff -u phpdoc-fr/reference/filesystem/functions/fflush.xml:1.1 phpdoc-fr/reference/filesystem/functions/fflush.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fflush.xml:1.1 Sun Apr 14 20:28:04 2002 +++ phpdoc-fr/reference/filesystem/functions/fflush.xml Sat May 3 18:36:52 2003 @@ -10,19 +10,19 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fflush</methodname> - <methodparam><type>resource</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>fflush</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>fflush</function> force l'&eacute;criture de toutes les donn&eacute;es bufferis&eacute;es dans le fichier d&eacute;sign&eacute; - par <parameter>fp</parameter>. <function>fflush</function> retourne + par <parameter>handle</parameter>. <function>fflush</function> retourne &true; en cas de succ&egrave;s, et &false; sinon. </para> <para> - <parameter>fp</parameter> est un pointeur de fichier ouvert + <parameter>handle</parameter> est un pointeur de fichier ouvert avec <function>fopen</function>, <function>popen</function>, ou <function>fsockopen</function>. </para> Index: phpdoc-fr/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.1 phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.1 Sun Apr 14 20:28:06 2002 +++ phpdoc-fr/reference/filesystem/functions/fgetcsv.xml Sat May 3 18:36:52 2003 @@ -4,29 +4,32 @@ <refentry id="function.fgetcsv"> <refnamediv> <refname>fgetcsv</refname> - <refpurpose> - Renvoie la ligne courante et cherche les champs CSV - </refpurpose> + <refpurpose>Renvoie la ligne courante et cherche les champs CSV</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>fgetcsv</methodname> - <methodparam><type>resource</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - delimiter - </parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>fgetcsv</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam> + </methodsynopsis> <simpara> - Identique &agrave; <function>fgets</function> mais <function>fgetcsv</function> + <function>fgetcsv</function> est 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> + <note> + <simpara> + Le param&egrave;tre <parameter>enclosure</parameter> a &eacute;t&eacute; ajout&eacute; en PHP 4.3.0. + </simpara> + </note> <simpara> - <parameter>fp</parameter> doit &ecirc;tre un pointeur valide, et avoir + <parameter>handle</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> @@ -39,31 +42,41 @@ <function>fgetcsv</function> retourne &false; en cas d'erreur, ou en cas de fin du fichier. </simpara> - <simpara> - Note : une ligne vide dans un fichier CSV sera retourn&eacute;e dans le - tableau comme une cha&icirc;ne vide, et ne sera pas trait&eacute;e comme - une erreur. - </simpara> + <note> + <simpara> + Une ligne vide dans un fichier CSV sera retourn&eacute;e sous la + forme d'un tableau contenant la valeur &null; et ne sera pas trait&eacute;e + comme une erreur. + </simpara> + </note> <example> <title> - Exemple avec <function>fgetcsv</function> + Lit et affiche le contenu d'un fichier CSV avec <function>fgetcsv</function> </title> <programlisting role="php"> -&lt;?php - $row = 1; - $fp = fopen ("test.csv","r"); - while ($data = fgetcsv ($fp, 1000, ",")) { +<![CDATA[ +<?php +$row = 1; +$fp = fopen ("test.csv","r"); +while ($data = fgetcsv ($fp, 1000, ",")) { $num = count ($data); - print "&lt;p> $num champs dans la ligne $row: &lt;br&gt;"; + print "<p> $num champs dans la ligne $row: <br>\n"; $row++; - for ($c=0; $c&lt;$num; $c++) { - print $data[$c] . "&lt;br&gt;"; + for ($c=0; $c < $num; $c++) { + print $data[$c] . "<br>\n"; } - } - fclose ($fp); -?&gt; +} +fclose ($fp); +?> +]]> </programlisting> </example> + <para> + Voir aussi + <function>explode</function>, + <function>file</function> et + <function>pack</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fgets.xml diff -u phpdoc-fr/reference/filesystem/functions/fgets.xml:1.1 phpdoc-fr/reference/filesystem/functions/fgets.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fgets.xml:1.1 Sun Apr 14 20:28:06 2002 +++ phpdoc-fr/reference/filesystem/functions/fgets.xml Sat May 3 18:36:52 2003 @@ -10,11 +10,11 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>fgets</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>fgets</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> <para> <function>fgets</function> retourne la cha&icirc;ne lue jusqu'&agrave; la longueur <parameter>length</parameter> - 1 octet, ou bien la fin du @@ -33,7 +33,7 @@ lors de la rencontre de la fin du fichier. </simpara> <simpara> - <parameter>fp</parameter> doit &ecirc;tre valide, et avoir &eacute;t&eacute; + <parameter>handle</parameter> doit &ecirc;tre valide, et avoir &eacute;t&eacute; correctement ouvert par <function>fopen</function>, <function>popen</function>, ou <function>fsockopen</function>. </simpara> @@ -42,26 +42,46 @@ <example> <title>Lecture d'un fichier ligne par ligne</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $fd = fopen ("/tmp/inputfile.txt", "r"); - while (!feof($fd)) { + while (!feof ($fd)) { $buffer = fgets($fd, 4096); echo $buffer; } fclose ($fd); -?&gt; +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>fread</function>, - <function>fopen</function>, - <function>popen</function>, - <function>fgetc</function>, - <function>fsockopen</function> et - <function>socket_set_timeout</function>. - </para> + <note> + <simpara> + Le param&egrave;tre <parameter>length</parameter> est devenu optionnel depuis + &php; 4.2.0. Si il est omis, il prend la valeur par d&eacute;faut de 1024. + Depuis &php; 4.3.0, omettre le param&egrave;tre <parameter>length</parameter> fait + que la fonction va continuer &agrave; lire le fl&ocirc;t jusqu'&agrave; ce que la ligne + s'ach&egrave;be. Si la majorit&eacute; des lignes du fichier d&eacute;passent les 8 ko, + il est plus efficace pour votre script de sp&eacute;cifier ce param&egrave;tre. + </simpara> + </note> + <note> + <simpara> + <function>fgets</function> est compatible avec les donn&eacute;es binaires depuis + &php; 4.3. Les versions plus anciennes ne le sont pas. + </simpara> + </note> + &note.line-endings; + <para> + Voir aussi + <function>fread</function>, + <function>fopen</function>, + <function>popen</function>, + <function>fgetc</function>, + <function>stream_get_line</function>, + <function>fsockopen</function> et + <function>socket_set_timeout</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fgetss.xml diff -u phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.1 phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.1 Sun Apr 14 20:28:06 2002 +++ phpdoc-fr/reference/filesystem/functions/fgetss.xml Sat May 3 18:36:52 2003 @@ -11,16 +11,15 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>fgetss</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter> - allowable_tags - </parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>fgetss</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam> + </methodsynopsis> <para> - Identique &agrave; <function>fgets</function>, mais <function>fgetss</function> + <function>fgetss</function> est 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> @@ -28,16 +27,17 @@ 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. + <parameter>allowable_tags</parameter> a &eacute;t&eacute; ajout&eacute; en + PHP 3.0.13 et PHP 4.0.0. </para> </note> </para> + &note.line-endings; <para> Voir aussi - <function>fgets</function>, + <function>fgets</function>, <function>fopen</function>, - <function>fsockopen</function>, + <function>fsockopen</function>, <function>popen</function> et <function>strip_tags</function>. </para> Index: phpdoc-fr/reference/filesystem/functions/file-exists.xml diff -u phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.1 phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.1 Sun Apr 14 20:28:07 2002 +++ phpdoc-fr/reference/filesystem/functions/file-exists.xml Sat May 3 18:36:52 2003 @@ -4,14 +4,14 @@ <refentry id="function.file-exists"> <refnamediv> <refname>file_exists</refname> - <refpurpose>V&eacute;rifie si un fichier existe.</refpurpose> + <refpurpose>V&eacute;rifie si un fichier existe</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>file_exists</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>file_exists</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> <simpara> <function>file_exists</function> retourne &true; si le fichier <parameter>filename</parameter> existe, et &false; sinon. @@ -27,6 +27,43 @@ Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </simpara> + <note> + <title>Utilisation des dossiers partag&eacute;s Windows</title> + <para> + Sous Windows, utilisez le format de chemin + <filename>//computername/share/filename</filename> ou + <filename>\\\\computername\share\filename</filename> pour v&eacute;rifier qu'un + fichier est disponible sur le partage r&eacute;seau. + </para> + </note> + <para> + <example> + <title>Test d'existence d'un fichier</title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = '/chemin/jusqu/a/fichier.txt'; + +if (file_exists($filename)) { + print "Le fichier $filename existe"; +} else { + print "Le fichier $filename n'existe pas"; +} +?> +]]> + </programlisting> + </example> + </para> + &note.clearstatcache; + + &note.no-remote; + <para> + Voir aussi + <function>is_readable</function>, + <function>is_writable</function>, + <function>is_file</function> et + <function>file</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/file-get-contents.xml diff -u phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.1 phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.1 Thu Sep 19 21:01:50 2002 +++ phpdoc-fr/reference/filesystem/functions/file-get-contents.xml Sat May 3 18:36:52 2003 @@ -1 +1 @@ -<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.1 $ --><!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.130 --> <refentry id="function.file-get-contents"> <refnamediv> <refname>file_get_contents</refname> <refpurpose>Lit tout un fichier dans une cha&icirc;ne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>file_get_contents</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> <function>file_get_contents</function> est identique &agrave; la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une cha&icirc;ne. </para> <note> <para> Cette fonction a &eacute;t&eacute; introduite en PHP 4.3.0. </para> </note> &note.bin-safe; &tip.fopen-wrapper; <simpara> Voir aussi <function>fgets</function>, <function>file</function>, <function>fread</function>, <function>include</function> et <function>readfile</function>. </simpara> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file +<?xml version="1.0" encoding="iso-8859-1"?><!-- $Revision: 1.2 $ --><!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.130 --> <refentry id="function.file-get-contents"> <refnamediv> <refname>file_get_contents</refname> <refpurpose>Lit tout un fichier dans une cha&icirc;ne</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>string</type><methodname>file_get_contents</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> </methodsynopsis> <para> <function>file_get_contents</function> est identique &agrave; la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une cha&icirc;ne. </para> <note> <para> Cette fonction a &eacute;t&eacute; introduite en PHP 4.3.0. </para> </note> &note.bin-safe; &tip.fopen-wrapper; <note> <simpara> Le support de l'argument <parameter>context</parameter> sera ajout&eacute; en &php; 5.0. </simpara> </note> <simpara> Voir aussi <function>fgets</function>, <function>file</function>, <function>fread</function>, <function>include</function> et <function>readfile</function>. </simpara> </refsect1> </refentry><!-- Keep this comment at the end of the fileLocal variables:mode: sgmlsgml-omittag:tsgml-shorttag:tsgml-minimize-attributes:nilsgml-always-quote-attributes:tsgml-indent-step:1sgml-indent-data:tindent-tabs-mode:nilsgml-parent-document:nilsgml-default-dtd-file:"../../../../manual.ced"sgml-exposed-tags:nilsgml-local-catalogs:nilsgml-local-ecat-files:nilEnd:vim600: syn=xml fen fdm=syntax fdl=2 sivim: et tw=78 syn=sgmlvi: ts=1 sw=1--> \ No newline at end of file Index: phpdoc-fr/reference/filesystem/functions/file.xml diff -u phpdoc-fr/reference/filesystem/functions/file.xml:1.1 phpdoc-fr/reference/filesystem/functions/file.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/file.xml:1.1 Sun Apr 14 20:28:07 2002 +++ phpdoc-fr/reference/filesystem/functions/file.xml Sat May 3 18:36:52 2003 @@ -5,49 +5,78 @@ <refnamediv> <refname>file</refname> <refpurpose> - Lit le fichier et renvoie le r&eacute;sultat dans un tableau. + Lit le fichier et renvoie le r&eacute;sultat dans un tableau </refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> <para> - Identique &agrave; <function>readfile</function>, hormis le fait que + <function>file</function> est 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> + <note> + <para> + Chaque &eacute;l&eacute;ment du tableau r&eacute;sultat contiendra la nouvelle ligne de fin de cha&icirc;ne. + Il faudra donc utiliser <function>trim</function> sur cette valeur + pour le supprimer. + </para> + </note> + &note.line-endings; <para> Vous pouvez utiliser l'option <parameter>use_include_path</parameter> : en la mettant &agrave; "1", vous rechercherez aussi dans le dossier <link linkend="ini.include-path">include_path</link>. </para> <para> - <informalexample> + <example> + <title>Exemple avec <function>file</function></title> <programlisting role="php"> -&lt;?php -// Lire une page web dans un tableau, et l'afficher - $fcontents = file( 'http://www.php.net' ); - while ( list( $numero_ligne, $ligne ) = each( $fcontents ) ) { - echo "&lt;B&gt;Ligne $numero_ligne:&lt;/B&gt; ".htmlspecialchars( $ligne ) . "&lt;br&gt;\n"; - } -// lire une page web dans une cha&icirc;ne - $fcontents = join( '', file( 'http://www.php.net' ) ); -?&gt; +<![CDATA[ +<?php +// Lit une page web dans un tableau. +$lines = file ('http://www.exemple.com/'); + +// Affiche toutes les lignes du tableau comme code HTML, avec les num&eacute;ros de ligne +foreach ($lines as $line_num => $line) { + echo "Ligne No <b>$line_num</b> : " . htmlspecialchars($line) . "<br>\n"; +} + +// Un autre exemple, pour obtenir une page web dans une cha&icirc;ne. Voir aussi la fonction file_get_contents(). +$html = implode ('', file ('http://www.exemple.com/')); +?> +]]> </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>readfile</function>, - <function>fopen</function>, - <function>fsockopen</function> et - <function>popen</function>. + </example> </para> + <note> + <para> + Depuis PHP 4.3.0, vous pouvez utiliser <function>file_get_contents</function> + pour lire le contenu d'un fichier dans une cha&icirc;ne. + </para> + <para> + En PHP 4.3.0 <function>file</function> est d&eacute;sormais compatible avec les donn&eacute;es + binaires. + </para> + </note> + &tip.fopen-wrapper; + <para> + Voir aussi + <function>readfile</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function>, + <function>file_get_contents</function> et + <function>include</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fileatime.xml diff -u phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.1 phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.1 Sun Apr 14 20:28:08 2002 +++ phpdoc-fr/reference/filesystem/functions/fileatime.xml Sat May 3 18:36:52 2003 @@ -31,6 +31,9 @@ Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </simpara> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/filectime.xml diff -u phpdoc-fr/reference/filesystem/functions/filectime.xml:1.1 phpdoc-fr/reference/filesystem/functions/filectime.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/filectime.xml:1.1 Sun Apr 14 20:28:08 2002 +++ phpdoc-fr/reference/filesystem/functions/filectime.xml Sat May 3 18:36:52 2003 @@ -46,6 +46,9 @@ Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </para> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/filegroup.xml diff -u phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.1 phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.1 Sun Apr 14 20:28:08 2002 +++ phpdoc-fr/reference/filesystem/functions/filegroup.xml Sat May 3 18:36:52 2003 @@ -34,6 +34,9 @@ <function>filegroup</function> est inop&eacute;rante sous Windows. </simpara> </note> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fileinode.xml diff -u phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.1 phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.1 Sun Apr 14 20:28:08 2002 +++ phpdoc-fr/reference/filesystem/functions/fileinode.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.fileinode"> <refnamediv> <refname>fileinode</refname> - <refpurpose>Renvoie le num&eacute;ro d'inode du fichier.</refpurpose> + <refpurpose>Renvoie le num&eacute;ro d'inode du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -32,6 +32,9 @@ <function>fileinode</function> est inop&eacute;rante sous Windows. </simpara> </note> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/filemtime.xml diff -u phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.1 phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.1 Sun Apr 14 20:28:09 2002 +++ phpdoc-fr/reference/filesystem/functions/filemtime.xml Sat May 3 18:36:52 2003 @@ -36,6 +36,33 @@ sur ce r&eacute;sultat pour obtenir une date de modification humainement lisible. </para> + <para> + <example> + <title><function>filemtime</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// l'affichage sera : lefichier.txt a &eacute;t&eacute; modifi&eacute; le : December 29 2002 22:16:23. + +$filename = 'lefichier.txt'; +if (file_exists($filename)) { + echo "$filename a &eacute;t&eacute; modifi&eacute; le : " . date ("F d Y H:i:s.", filemtime($filename)); +} +?> +]]> + </programlisting> + </example> + </para> + &note.clearstatcache; + + &note.no-remote; + <para> + Voir aussi + <function>filectime</function>, + <function>stat</function>, + <function>touch</function> et + <function>getlastmod</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fileowner.xml diff -u phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.1 phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.1 Sun Apr 14 20:28:11 2002 +++ phpdoc-fr/reference/filesystem/functions/fileowner.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.fileowner"> <refnamediv> <refname>fileowner</refname> - <refpurpose>Renvoie le nom du propri&eacute;taire du fichier.</refpurpose> + <refpurpose>Renvoie le nom du propri&eacute;taire du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -34,6 +34,9 @@ <function>fileowner</function> est inop&eacute;rante sous Windows. </simpara> </note> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fileperms.xml diff -u phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.1 phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.1 Sun Apr 14 20:28:12 2002 +++ phpdoc-fr/reference/filesystem/functions/fileperms.xml Sat May 3 18:36:52 2003 @@ -30,6 +30,9 @@ Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </para> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/filesize.xml diff -u phpdoc-fr/reference/filesystem/functions/filesize.xml:1.1 phpdoc-fr/reference/filesystem/functions/filesize.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/filesize.xml:1.1 Sun Apr 14 20:28:12 2002 +++ phpdoc-fr/reference/filesystem/functions/filesize.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.filesize"> <refnamediv> <refname>filesize</refname> - <refpurpose>Renvoie la taille du fichier.</refpurpose> + <refpurpose>Renvoie la taille du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -27,6 +27,9 @@ Reportez-vous &agrave; <function>clearstatcache</function> pour plus de d&eacute;tails. </para> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/filetype.xml diff -u phpdoc-fr/reference/filesystem/functions/filetype.xml:1.1 phpdoc-fr/reference/filesystem/functions/filetype.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/filetype.xml:1.1 Sun Apr 14 20:28:12 2002 +++ phpdoc-fr/reference/filesystem/functions/filetype.xml Sat May 3 18:36:52 2003 @@ -26,11 +26,9 @@ 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> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/flock.xml diff -u phpdoc-fr/reference/filesystem/functions/flock.xml:1.1 phpdoc-fr/reference/filesystem/functions/flock.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/flock.xml:1.1 Sun Apr 14 20:28:12 2002 +++ phpdoc-fr/reference/filesystem/functions/flock.xml Sat May 3 18:36:52 2003 @@ -4,22 +4,23 @@ <refentry id="function.flock"> <refnamediv> <refname>flock</refname> - <refpurpose>Verrouille le fichier.</refpurpose> + <refpurpose>Verrouille le fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>boolean</type><methodname>flock</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>operation</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>flock</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>operation</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>&amp;wouldblock</parameter></methodparam> + </methodsynopsis> <simpara> PHP dispose d'un syst&egrave;me complet de verrouillage de fichiers. Tous les programmes qui acc&egrave;dent au fichier doivent utiliser la m&ecirc;me m&eacute;thode de verrouillage pour qu'il soit efficace. </simpara> <simpara> - <function>flock</function> agit sur le fichier <parameter>fp</parameter> + <function>flock</function> agit sur le fichier <parameter>handle</parameter> qui doit avoir &eacute;t&eacute; ouvert au pr&eacute;alable. <parameter>operation</parameter> est une des valeurs suivantes : </simpara> @@ -27,25 +28,31 @@ <itemizedlist> <listitem> <simpara> - Acquisition d'un verrou : <parameter>operation</parameter> = 1. + Acquisition d'un verrou en lecture : + <parameter>operation</parameter> = <constant>LOCK_SH</constant> + (valeur de 1 pour les versions plus anciennes que PHP 4.0.1). </simpara> </listitem> <listitem> <simpara> - Acquisition d'un verrou exclusif (&eacute;criture), - <parameter>operation</parameter> = 2. - </simpara> + Acquisition d'un verrou exclusif en &eacute;criture : + <parameter>operation</parameter> = <constant>LOCK_EX</constant> + (valeur de 2 pour les versions plus anciennes que PHP 4.0.1). + </simpara> </listitem> <listitem> <simpara> - Lib&eacute;ration d'un verrou (partag&eacute; ou exclusif), - <parameter>operation</parameter> = 3. + Lib&eacute;ration d'un verrou partag&eacute; ou exclusif, + <parameter>operation</parameter> = <constant>LOCK_UN</constant> + (valeur de 3 pour les versions plus anciennes que PHP 4.0.1). </simpara> </listitem> <listitem> <simpara> Si vous voulez que <function>flock</function> ne se bloque pas durant - le verrouillage, ajoutez 4 &agrave; <parameter>operation</parameter>. + le verrouillage, ajoutez <constant>LOCK_NB</constant> &agrave; + <parameter>operation</parameter> + (valeur de 4 pour les versions plus anciennes que PHP 4.0.1). </simpara> </listitem> </itemizedlist> @@ -53,22 +60,41 @@ <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). + n'importe quelle plate-forme (Unix et Windows compris). Le troisi&egrave;me + param&egrave;tre optionnel vaut par d&eacute;faut &true;, si le verrou doit bloquer le + script (condition d'erreur EWOULDBLOCK). </simpara> <simpara> - <function>flock</function> retourne &true; en cas - de succ&egrave;s, et &false; - sinon. (le verrou n'a pas pu &ecirc;tre obtenu). + &return.success; </simpara> - <warning> - <para> - Sur la plupart des OS, <function>flock</function> est impl&eacute;ment&eacute; - au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, - comme ISAPI, vous ne pouvez pas vous fier &agrave; <function>flock</function> - pour prot&eacute;ger vos fichiers contre des acc&egrave;s concurrents du - m&ecirc;me serveur. - </para> - </warning> + <note> + <para> + Comme <function>flock</function> requiert un pointeur de fichier, vous + aurez peut &ecirc;tre &agrave; utiliser un verrou sp&eacute;cial pour prot&eacute;ger l'acc&egrave;s au fichier + que vous voulez tronquer en l'ouvrant en mode d'&eacute;criture (avec "w" ou "w+" + comme argument de <function>fopen</function>). + </para> + </note> + <warning> + <para> + <function>flock</function> ne fonctionne pas sur NFS ou sur les autres + syst&egrave;mes de fichiers r&eacute;seaux. V&eacute;rifiez la documentation de votre + syst&egrave;me d'exploitation pour plus de d&eacute;tails. + </para> + <para> + Sur certains syst&egrave;mes d'exploitation, <function>flock</function> est impl&eacute;ment&eacute; + au niveau processus. Lorsque vous utilisez une API multi-thread comme + ISAPI, vous risquez de ne pas pouvoir avoir confiance en <function>flock</function> + pour prot&eacute;ger vos fichiers contre d'autres scripts &php; qui fonctionnent + en paralelle sur d'autres thread du m&ecirc;me serveur. + </para> + <para> + <function>flock</function> n'est pas support&eacute; sur les vieux syst&egrave;mes de fichiers + comme <literal>FAT</literal> et ses d&eacute;riv&eacute;s, et elle retournera forc&eacute;ment + &false; sous ces environnement (ceci est particuli&egrave;rement vrai pour les + utilisateurs de Windows 98). + </para> + </warning> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fopen.xml diff -u phpdoc-fr/reference/filesystem/functions/fopen.xml:1.1 phpdoc-fr/reference/filesystem/functions/fopen.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fopen.xml:1.1 Sun Apr 14 20:28:12 2002 +++ phpdoc-fr/reference/filesystem/functions/fopen.xml Sat May 3 18:36:52 2003 @@ -4,59 +4,49 @@ <refentry id="function.fopen"> <refnamediv> <refname>fopen</refname> - <refpurpose>Ouverture d'un fichier ou d'une URL.</refpurpose> + <refpurpose>Ouverture d'un fichier ou d'une URL</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fopen</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - use_include_path - </parameter></methodparam> - </methodsynopsis> - <simpara> - Si <parameter>filename</parameter> commence par "http://" (insensible &agrave; - la casse), une connexion HTTP 1.x est ouverte avec le serveur - sp&eacute;cifi&eacute;, et un pointeur sur la r&eacute;ponse fournie est - retourn&eacute;. Une en-t&ecirc;te '<literal>Host:</literal>' est envoy&eacute; avec la - requ&ecirc;te, afin de g&eacute;rer les virtual hosts bas&eacute;s sur les noms. + <methodsynopsis> + <type>resource</type><methodname>fopen</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>string</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam> + </methodsynopsis> + <simpara> + <function>fopen</function> cr&eacute;e une ressource nomm&eacute;e, sp&eacute;cifi&eacute;e par le + param&egrave;tre <parameter>filename</parameter>, sous la forme d'un fl&ocirc;t. + Si <parameter>filename</parameter> est de la forme "protocole://...", + <parameter>filename</parameter> est suppos&eacute; &ecirc;tre une URL, et &php; va + rechercher un gestionnaire de protocole adapt&eacute; pour lire ce fichier. + Si aucun gestionnaire pour ce protocole n'est disponible, &php; va &eacute;mettre + une alerte qui vous permettra de savoir que vous avez des probl&egrave;mes dans + votre script, et il tentera d'exploiter <parameter>filename</parameter> + comme un fichier classique. </simpara> <simpara> - Notez que le pointeur de fichier retourn&eacute; repr&eacute;sente le corps de la - r&eacute;ponse, et qu'il n'est pas possible d'acc&eacute;der aux en-t&ecirc;tes HTTP - avec cette fonction. - </simpara> - <simpara> - Les versions ant&eacute;rieures &agrave; PHP 4.0.6, ne g&egrave;re pas les - redirections automatiques, ce qui oblige &agrave; ajouter les slash finaux - "/" pour indiquer un dossier. - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "ftp://" (insensible &agrave; - la casse), une connexion FTP est ouverte avec le serveur sp&eacute;cifi&eacute;, - et un pointeur sur la r&eacute;ponse fournie est retourn&eacute;. Si le serveur - ne supporte par le mode FTP passif, <function>fopen</function> &eacute;chouera. - Vous pouvez ouvrir des fichiers en lecture seulement, ou en &eacute;criture - seulement (le full duplex n'est pas support&eacute;). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", - ou "php://stderr", le flot correspondant sera ouvert. (Cela a &eacute;t&eacute; - introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" - ou "/dev/fd/0" devaient &ecirc;tre utilis&eacute;s pour acc&eacute;der &agrave; - ces flots). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP - tentera de lire ce fichier dans le syst&egrave;me local, et un pointeur sur - le fichier ouvert sera retourn&eacute;. - </simpara> - <simpara> - Si l'ouverture &eacute;choue, <function>fopen</function> retourne - &false;. - </simpara> + Si &php; d&eacute;cide que le fichier <parameter>filename</parameter> est un fichier + local, il va essayer d'ouvrir un fl&ocirc;t avec ce fichier. Le fichier doit &ecirc;tre + accessible &agrave; &php;. Il vous faut donc vous assurer que vous avez les + droits d'acc&egrave;s &agrave; ce fichier. Si vous activ&eacute; le &safemode;, + ou la directive <link linkend="ini.open-basedir">open_basedir</link>, d'autres + conditions peuvent aussi s'appliquer. + </simpara> + <simpara> + Si &php; a d&eacute;cid&eacute; que <parameter>filename</parameter> sp&eacute;cifie + un protocole enregistr&eacute;, et que ce protocole est enregistr&eacute; comme + un protocole r&eacute;seau, &php; s'assurera que la directive + <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activ&eacute;e. + Si elle est inactive, &php; va &eacute;mettre une alerte, et l'ouverte + va &eacute;chouer. + </simpara> + <note> + <simpara> + La liste des protocoles support&eacute;s est disponible <xref linkend="wrappers"/>. + </simpara> + </note> <para> <parameter>mode</parameter> peut prendre les valeurs suivantes : <itemizedlist> @@ -113,14 +103,24 @@ en le mettant &agrave; 1. </para> <para> + Le param&egrave;tre optionnel <parameter>zcontext</parameter> est utilis&eacute; pour + sp&eacute;cifier des param&egrave;tres d'optimisation et de callback. + </para> + <simpara> + Si l'ouverture &eacute;choue, <function>fopen</function> retournera &false;. + </simpara> + <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; +<![CDATA[ +<?php +$handle = fopen ("/home/rasmus/file.txt", "r"); +$handle = fopen ("/home/rasmus/file.gif", "wb"); +$handle = fopen ("http://www.example.com/", "r"); +$handle = fopen ("ftp://user:password@example.com/somefile.txt", "w"); +?> +]]> </programlisting> </example> </para> @@ -133,20 +133,28 @@ <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> + <example> + <title>Exemple avec <function>fopen</function> sous Windows</title> <programlisting role="php"> -&lt;?php - $fp = fopen("c:\\data\\info.txt", "r"); -?&gt; +<![CDATA[ +<?php + $handle = fopen ("c:\\data\\info.txt", "r"); +?> +]]> </programlisting> - </informalexample> + </example> </para> <simpara> Voir aussi - <function>fclose</function>, - <function>fsockopen</function>, - <function>socket_set_timeout</function> et - <function>popen</function>. + <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, + <function>fsockopen</function>, + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>socket_set_timeout</function> et + <function>popen</function>. </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fpassthru.xml diff -u phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.1 phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.1 Sun Apr 14 20:28:13 2002 +++ phpdoc-fr/reference/filesystem/functions/fpassthru.xml Sat May 3 18:36:52 2003 @@ -4,35 +4,43 @@ <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> + <refpurpose>Affiche le reste du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fpassthru</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>fpassthru</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <simpara> <function>fpassthru</function> lit tout le reste d'un fichier jusqu'&agrave; la fin, et dirige le r&eacute;sultat vers la sortie standard. </simpara> <simpara> Si une erreur survient, <function>fpassthru</function> retourne &false;. + Sinon, <function>fpassthru</function> retourne le nombre de caract&egrave;res + lu dans <parameter>handle</parameter> et pass&eacute; &agrave; la sortie standard. </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>. + <parameter>handle</parameter> sera alors invalide). </simpara> + <note> + <para> + Lorque vous utilisez la fonction <function>fpassthru</function> sur un fichier + binaire sous Windows, assurez vous d'avoir ouvert le fichier + en mode binaire en ajoutant la lettre <literal>b</literal> au mode + d'acc&egrave;s utilis&eacute; dans <function>fopen</function>. + </para> + <para> + Vous &ecirc;tes encourag&eacute;s &agrave; utiliser l'option <literal>b</literal> lorsque vous + traitez des fichiers binaires, m&ecirc;me si votre syst&egrave;me ne le requiert pas, + de fa&ccedil;on &agrave; rendre vos scripts portables. + </para> + </note> <simpara> Voir aussi <function>readfile</function>, Index: phpdoc-fr/reference/filesystem/functions/fputs.xml diff -u phpdoc-fr/reference/filesystem/functions/fputs.xml:1.1 phpdoc-fr/reference/filesystem/functions/fputs.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fputs.xml:1.1 Sun Apr 14 20:28:13 2002 +++ phpdoc-fr/reference/filesystem/functions/fputs.xml Sat May 3 18:36:52 2003 @@ -4,18 +4,16 @@ <refentry id="function.fputs"> <refnamediv> <refname>fputs</refname> - <refpurpose>Ecrit dans un fichier.</refpurpose> + <refpurpose>Ecrit dans un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fputs</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - length - </parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>fputs</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> <para> <function>fputs</function> est un alias de <function>fwrite</function>, et lui est identique en tous points. Notez que Index: phpdoc-fr/reference/filesystem/functions/fread.xml diff -u phpdoc-fr/reference/filesystem/functions/fread.xml:1.1 phpdoc-fr/reference/filesystem/functions/fread.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fread.xml:1.1 Sun Apr 14 20:28:13 2002 +++ phpdoc-fr/reference/filesystem/functions/fread.xml Sat May 3 18:36:52 2003 @@ -4,18 +4,18 @@ <refentry id="function.fread"> <refnamediv> <refname>fread</refname> - <refpurpose>Lecture du fichier en mode binaire.</refpurpose> + <refpurpose>Lecture du fichier en mode binaire</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>fread</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>length</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>fread</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> <simpara> <function>fread</function> lit jusqu'&agrave; <parameter>length</parameter> - octets dans le fichier ref&eacute;renc&eacute; par <parameter>fp</parameter>. + octets dans le fichier ref&eacute;renc&eacute; par <parameter>handle</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). @@ -23,13 +23,15 @@ <para> <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // Lit un fichier, et le place dans une cha&icirc;ne - $filename = "/usr/local/quelquechose.txt"; - $fd = fopen($filename, "r"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?&gt; +$filename = "/usr/local/something.txt"; +$handle = fopen ($filename, "r"); +$contents = fread ($handle, filesize ($filename)); +fclose ($handle); +?> +]]> </programlisting> </informalexample> </para> @@ -45,12 +47,14 @@ <para> <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $filename = "c:\\fichiers\\uneimage.gif"; - $fd = fopen($filename, "rb"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?&gt; + $handle = fopen ($filename, "rb"); + $contents = fread ($handle, filesize ($filename)); + fclose ($handle); +?> +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/filesystem/functions/fscanf.xml diff -u phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.1 phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.1 Sun Apr 14 20:28:13 2002 +++ phpdoc-fr/reference/filesystem/functions/fscanf.xml Sat May 3 18:36:52 2003 @@ -8,12 +8,12 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>fscanf</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - <methodparam><type>string</type><parameter>format</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>fscanf</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>format</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam> + </methodsynopsis> <para> <function>fscanf</function> est similaire &agrave; <function>sscanf</function>, mais elle prend comme @@ -26,29 +26,49 @@ 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. + </para> + <para> + Tous les caract&egrave;res blancs de la cha&icirc;ne de formattage correspondent + &agrave; autant d'espaces dans le fl&ocirc;t d'entr&eacute;e. Cela signifie qu'une tabulation + <literal>\t</literal> dans la cha&icirc;ne de format peut remplacer + un espace simple dans le fl&ocirc;t d'entr&eacute;e. + </para> + <para> <example> - <title>Exemple <function>fscanf</function></title> + <title>Exemple avec <function>fscanf</function></title> <programlisting role="php"> -&lt;?php - $fp = fopen ("users.txt","r"); - while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) { +<![CDATA[ +<?php + $handle = fopen ("users.txt","r"); + while ($userinfo = fscanf ($handle, "%s\t%s\t%s\n")) { list ($name, $profession, $countrycode) = $userinfo; //... traitement des donn&eacute;es } - fclose($fp); -?&gt; - </programlisting> + fclose($handle); +?> +]]> + </programlisting> </example> <example> - <title>users.txt</title> + <title>utilisateurs.txt</title> <programlisting role="txt"> -janus argonaute gr -rodin sculpteur fr -sam oncle us -leonard inventeur it +<![CDATA[ +javier argonaute pe +hiroshi sculpteur jp +robert hockeyuer us +luigi fleuriste it +]]> </programlisting> </example> </para> + <note> + <simpara> + Avant &php; 4.3.0, le nombre maximum de caract&egrave;res lus dans le fichier + &eacute;tait de 512 (ou bien jusqu'&agrave; la premi&egrave;re nouvelle ligne "\n" : en fait, + le premier des deux). Depuis &php; 4.3.0, des lignes de n'importe quelle + taille peuvent &ecirc;tre lues. + </simpara> + </note> <para> Voir aussi <function>fread</function>, Index: phpdoc-fr/reference/filesystem/functions/fseek.xml diff -u phpdoc-fr/reference/filesystem/functions/fseek.xml:1.1 phpdoc-fr/reference/filesystem/functions/fseek.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fseek.xml:1.1 Sun Apr 14 20:28:14 2002 +++ phpdoc-fr/reference/filesystem/functions/fseek.xml Sat May 3 18:36:52 2003 @@ -4,42 +4,45 @@ <refentry id="function.fseek"> <refnamediv> <refname>fseek</refname> - <refpurpose>Modifie le pointeur de fichier.</refpurpose> + <refpurpose>Modifie le pointeur de fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fseek</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>fseek</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam> + </methodsynopsis> <para> <function>fseek</function> modifie le curseur de position - dans le fichier <parameter>fp</parameter>. La nouvelle position + dans le fichier <parameter>handle</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> + <constant>SEEK_SET</constant> - La position finale vaut + <parameter>offset</parameter> octets. + </member> <member> - SEEK_SET - La position finale vaut <parameter>offset</parameter> octets. + <constant>SEEK_CUR</constant> - La position finale vaut la position courante + ajout&eacute;e &agrave; <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> + <constant>SEEK_END</constant> - 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. + vaut par d&eacute;faut <constant>SEEK_SET</constant>. </para> <para> - <function>fseek</function> retourne &true; en cas de + <function>fseek</function> retourne 0 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> @@ -47,6 +50,11 @@ <function>fseek</function> ne peut pas &ecirc;tre utilis&eacute; sur les pointeurs retourn&eacute;s par <function>fopen</function> s'ils sont au format HTTP ou FTP. </para> + <note> + <para> + Le param&egrave;tre <parameter>whence</parameter> a &eacute;t&eacute; ajout&eacute; en &php; 4.0.0. + </para> + </note> <para> Voir aussi <function>ftell</function> et Index: phpdoc-fr/reference/filesystem/functions/fstat.xml diff -u phpdoc-fr/reference/filesystem/functions/fstat.xml:1.1 phpdoc-fr/reference/filesystem/functions/fstat.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/fstat.xml:1.1 Sun Apr 14 20:28:14 2002 +++ phpdoc-fr/reference/filesystem/functions/fstat.xml Sat May 3 18:36:52 2003 @@ -10,41 +10,38 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>fstat</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>array</type><methodname>fstat</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>fstat</function> rassemble les informations sur le fichier dont on - conna&icirc;t le pointeur <parameter>fp</parameter>. <function>fstat</function> + conna&icirc;t le pointeur <parameter>handle</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> + <listitem><simpara>volume </simpara></listitem> + <listitem><simpara>inode</simpara></listitem> + <listitem><simpara>nombre de liens </simpara></listitem> + <listitem><simpara>id de l'utilisateur propri&eacute;taire </simpara></listitem> + <listitem><simpara>id du groupe propri&eacute;taire</simpara></listitem> + <listitem><simpara>type du volume de l'inode * </simpara></listitem> + <listitem><simpara>taille en octets </simpara></listitem> + <listitem><simpara>date du dernier acc&egrave;s </simpara></listitem> + <listitem><simpara>date de la derni&egrave;re modification </simpara></listitem> + <listitem><simpara>date du dernier changement </simpara></listitem> + <listitem><simpara>taille de bloc du syst&egrave;me pour les entr&eacute;es/sorties(*)</simpara></listitem> + <listitem><simpara>nombre de blocs allou&eacute;s</simpara></listitem> </itemizedlist> * - uniquement sur les syst&egrave;mes qui supportent le type st_blksize. Les autres syst&egrave;mes (i.e. Windows) retournent -1. </para> - <para> - Les r&eacute;sultats de <function>fstat</function> sont mis en cache. - Reportez-vous &agrave; la fonction <function>clearstatcache</function> - pour plus de d&eacute;tails. - </para> + &note.clearstatcache; + + &note.no-remote; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/ftell.xml diff -u phpdoc-fr/reference/filesystem/functions/ftell.xml:1.1 phpdoc-fr/reference/filesystem/functions/ftell.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/ftell.xml:1.1 Sun Apr 14 20:28:14 2002 +++ phpdoc-fr/reference/filesystem/functions/ftell.xml Sat May 3 18:36:52 2003 @@ -4,18 +4,18 @@ <refentry id="function.ftell"> <refnamediv> <refname>ftell</refname> - <refpurpose>Renvoie la position du pointeur du fichier.</refpurpose> + <refpurpose>Renvoie la position du pointeur du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ftell</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>ftell</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>ftell</function> retourne la position courante du pointeur dans le - fichier rep&eacute;r&eacute; par le pointeur <parameter>fp</parameter>, i.e., - son offset. + fichier rep&eacute;r&eacute; par le pointeur <parameter>handle</parameter>, + i.e., son offset. </para> <para> Si une erreur survient, retourne &false;. Index: phpdoc-fr/reference/filesystem/functions/ftruncate.xml diff -u phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.1 phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.1 Sun Apr 14 20:28:15 2002 +++ phpdoc-fr/reference/filesystem/functions/ftruncate.xml Sat May 3 18:36:52 2003 @@ -4,21 +4,19 @@ <refentry id="function.ftruncate"> <refnamediv> <refname>ftruncate</refname> - <refpurpose>Tronque un fichier.</refpurpose> + <refpurpose>Tronque un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>ftruncate</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>int</type><parameter>size</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>bool</type><methodname>ftruncate</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>int</type><parameter>size</parameter></methodparam> + </methodsynopsis> <para> <function>ftruncate</function> prend le pointeur de fichier - <parameter>fp</parameter> et le tronque &agrave; la taille de - <parameter>size</parameter>.<function>ftruncate</function> retourne - &true; en cas de succ&egrave;s, et - &false; sinon. + <parameter>handle</parameter> et le tronque &agrave; la taille de + <parameter>size</parameter>. &return.success; </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/fwrite.xml diff -u phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.2 phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.3 --- phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.2 Sat Jan 4 21:55:19 2003 +++ phpdoc-fr/reference/filesystem/functions/fwrite.xml Sat May 3 18:36:52 2003 @@ -4,22 +4,20 @@ <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> - <refpurpose>Ecriture du fichier en mode binaire.</refpurpose> + <refpurpose>Ecriture du fichier en mode binaire</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>fwrite</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - length - </parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>fwrite</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam><type>string</type><parameter>string</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + </methodsynopsis> <simpara> <function>fwrite</function> &eacute;crit le contenu de la cha&icirc;ne <parameter>string</parameter> dans le fichier point&eacute; par - <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> + <parameter>handle</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). @@ -35,13 +33,50 @@ </simpara> <note> <para> - De plus, <parameter>mode</parameter> peut contenir la lettre 'b'. Cette option - n'est utile que sur les syst&egrave;mes qui font la diff&eacute;rence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalit&eacute; Windows, totalement inutile sous Unix). - S'il n'est pas n&eacute;cessaire, il sera ignor&eacute;. + Sur les syst&egrave;mes qui font la diff&eacute;rence entre les fichiers binaires + et les fichiers textes (par exemple, Windows), le fichier doit &ecirc;tre ouvert + avec l'option 'b' inclus dans le param&egrave;tre de mode de + <function>fopen</function>. </para> </note> + <para> + <example> + <title>Exemple d'&eacute;criture dans un fichier avec <function>fwrite</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = 'test.txt'; +$somecontent = "Ajout de cha&icirc;ne dans le fichier \n"; + +// Assurons nous que le fichier est accessible en &eacute;criture +if (is_writable($filename)) { + + // Dans notre exemple, nous ouvrons le fichier $filename en mode d'ajout + // Le pointeur de fichier est plac&eacute; &agrave; la fin du fichier + // c'est l&agrave; que $somecontent sera plac&eacute; + if (!$handle = fopen($filename, 'a')) { + print "Impossible d'ouvrir le fichier ($filename)"; + exit; + } + + // Write $somecontent to our opened file. + if (!fwrite($handle, $somecontent)) { + print "Impossible d'&eacute;crire dans le fichier ($filename)"; + exit; + } + + print "L'&eacute;criture de ($somecontent) dans le fichier ($filename) a r&eacute;ussi"; + + fclose($handle); + +} else { + print "Le fichier $filename n'est pas accessible en &eacute;criture."; +} +?> +]]> + </programlisting> + </example> + </para> <simpara> Voir aussi <function>fread</function>, Index: phpdoc-fr/reference/filesystem/functions/is-dir.xml diff -u phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.1 Sun Apr 14 20:28:16 2002 +++ phpdoc-fr/reference/filesystem/functions/is-dir.xml Sat May 3 18:36:52 2003 @@ -4,12 +4,12 @@ <refentry id="function.is-dir"> <refnamediv> <refname>is_dir</refname> - <refpurpose>Indique si le nom de fichier est un dossier.</refpurpose> + <refpurpose>Indique si le nom de fichier est un dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_dir</methodname> + <type>bool</type><methodname>is_dir</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -26,10 +26,16 @@ Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier du serveur. </simpara> + &note.clearstatcache; + + &note.no-remote; <para> Voir aussi + <function>chdir</function>, + <link linkend="class.dir">dir</link>, + <function>opendir</function>, <function>is_file</function> et - <function>is_link</function>. + <function>is_link</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/is-executable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.1 Sun Apr 14 20:28:16 2002 +++ phpdoc-fr/reference/filesystem/functions/is-executable.xml Sat May 3 18:36:52 2003 @@ -4,12 +4,12 @@ <refentry id="function.is-executable"> <refnamediv> <refname>is_executable</refname> - <refpurpose>Indique si le fichier est ex&eacute;cutable.</refpurpose> + <refpurpose>Indique si le fichier est ex&eacute;cutable</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_executable</methodname> + <type>bool</type><methodname>is_executable</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -27,6 +27,9 @@ Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier du serveur. </simpara> + &note.no-windows; + &note.clearstatcache; + &note.no-remote; <para> Voir aussi <function>is_file</function> et Index: phpdoc-fr/reference/filesystem/functions/is-file.xml diff -u phpdoc-fr/reference/filesystem/functions/is-file.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-file.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-file.xml:1.1 Sun Apr 14 20:28:17 2002 +++ phpdoc-fr/reference/filesystem/functions/is-file.xml Sat May 3 18:36:52 2003 @@ -11,7 +11,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_file</methodname> + <type>bool</type><methodname>is_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -30,6 +30,8 @@ Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier du serveur. </simpara> + &note.clearstatcache; + &note.no-remote; <para> Voir aussi <function>is_dir</function> et Index: phpdoc-fr/reference/filesystem/functions/is-link.xml diff -u phpdoc-fr/reference/filesystem/functions/is-link.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-link.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-link.xml:1.1 Sun Apr 14 20:28:17 2002 +++ phpdoc-fr/reference/filesystem/functions/is-link.xml Sat May 3 18:36:52 2003 @@ -11,7 +11,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_link</methodname> + <type>bool</type><methodname>is_link</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -29,16 +29,14 @@ Les fichiers doivent &ecirc;tre accessibles par le syst&egrave;me de fichier du serveur. </simpara> + &note.clearstatcache; + &note.no-remote; <para> Voir aussi + <function>readlink</function>, <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> Index: phpdoc-fr/reference/filesystem/functions/is-readable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.1 Sun Apr 14 20:28:17 2002 +++ phpdoc-fr/reference/filesystem/functions/is-readable.xml Sat May 3 18:36:52 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_readable</methodname> + <type>bool</type><methodname>is_readable</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -21,19 +21,12 @@ 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> + &note.clearstatcache; + &note.no-remote; <para> Voir aussi + <function>file_exists</function>, + <function>fgets</function> et <function>is_writable</function>. </para> </refsect1> Index: phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml diff -u phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.1 Sun Apr 14 20:28:18 2002 +++ phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml Sat May 3 18:36:52 2003 @@ -12,7 +12,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_uploaded_file</methodname> + <type>bool</type><methodname>is_uploaded_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -32,6 +32,44 @@ 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> + <function>is_uploaded_file</function> est disponible dans les + versions de &php; 3 apr&egrave;s PHP 3.0.16, et dans les versions de &php; 4 + apr&egrave;s la 4.0.2. Si vous &ecirc;tes coinc&eacute;s avec une version plus ancienne, + vous pouvez utiliser l'une des fonctions suivantes pour + vous prot&eacute;ger : + <note> + <para> + L'exemple suivant <emphasis>ne fonctionne pas</emphasis> avec + les versions de &php; ult&eacute;rieures &agrave; la 4.0.2. Elle d&eacute;pend + de fonctionnalit&eacute;s internes de &php; qui ont disparu apr&egrave;s + cette version. + </para> + </note> + <programlisting role="php"> +<![CDATA[ +<?php +/* Test utilisateur du fichier t&eacute;l&eacute;charg&eacute;. */ +function is_uploaded_file($filename) { + if (!$tmp_file = get_cfg_var('upload_tmp_dir')) { + $tmp_file = dirname(tempnam('', '')); + } + $tmp_file .= '/' . basename($filename); + /* L'utilisateur peut avoir laiss&eacute; des / finaux dans php.ini... */ + return (ereg_replace('/+', '/', $tmp_file) == $filename); +} + +/* Voici comment l'utiliser, car move_uploaded_file() n'est pas disponible + dans les anciennes versions : */ +if (is_uploaded_file($HTTP_POST_FILES['userfile'])) { + copy($HTTP_POST_FILES['userfile'], "/dossier/ou/placer/un/fichier/upload&eacute;"); +} else { + echo "Tentative d'attaque possible : '$HTTP_POST_FILES[userfile]'."; +} +?> +]]> + </programlisting> + </para> <para> Voir aussi <function>move_uploaded_file</function>, et Index: phpdoc-fr/reference/filesystem/functions/is-writable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.1 Sun Apr 14 20:28:18 2002 +++ phpdoc-fr/reference/filesystem/functions/is-writable.xml Sat May 3 18:36:52 2003 @@ -4,12 +4,12 @@ <refentry id="function.is-writable"> <refnamediv> <refname>is_writable</refname> - <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture.</refpurpose> + <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_writable</methodname> + <type>bool</type><methodname>is_writable</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> @@ -21,19 +21,12 @@ 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> + &note.clearstatcache; + &note.no-remote; <para> Voir aussi + <function>file_exists</function>, + <function>fwrite</function> et <function>is_readable</function>. </para> </refsect1> Index: phpdoc-fr/reference/filesystem/functions/is-writeable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.1 phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.1 Sun Apr 14 20:28:19 2002 +++ phpdoc-fr/reference/filesystem/functions/is-writeable.xml Sat May 3 18:36:52 2003 @@ -4,12 +4,12 @@ <refentry id="function.is-writeable"> <refnamediv> <refname>is_writeable</refname> - <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture.</refpurpose> + <refpurpose>Indique si un fichier est autoris&eacute; en &eacute;criture</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>is_writeable</methodname> + <type>bool</type><methodname>is_writeable</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> Index: phpdoc-fr/reference/filesystem/functions/link.xml diff -u phpdoc-fr/reference/filesystem/functions/link.xml:1.1 phpdoc-fr/reference/filesystem/functions/link.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/link.xml:1.1 Sun Apr 14 20:28:19 2002 +++ phpdoc-fr/reference/filesystem/functions/link.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.link"> <refnamediv> <refname>link</refname> - <refpurpose>Cr&eacute;e un lien.</refpurpose> + <refpurpose>Cr&eacute;e un lien</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -16,6 +16,7 @@ <para> <function>link</function> cr&eacute;e un lien. </para> + &note.no-remote; <para> Voir aussi <function>symlink</function> pour cr&eacute;er des liens Index: phpdoc-fr/reference/filesystem/functions/linkinfo.xml diff -u phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.1 phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.1 Sun Apr 14 20:28:19 2002 +++ phpdoc-fr/reference/filesystem/functions/linkinfo.xml Sat May 3 18:36:52 2003 @@ -4,7 +4,7 @@ <refentry id="function.linkinfo"> <refnamediv> <refname>linkinfo</refname> - <refpurpose>Renvoie les informations &agrave; propos d'un lien.</refpurpose> + <refpurpose>Renvoie les informations &agrave; propos d'un lien</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/filesystem/functions/lstat.xml diff -u phpdoc-fr/reference/filesystem/functions/lstat.xml:1.1 phpdoc-fr/reference/filesystem/functions/lstat.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/lstat.xml:1.1 Sun Apr 14 20:28:19 2002 +++ phpdoc-fr/reference/filesystem/functions/lstat.xml Sat May 3 18:36:52 2003 @@ -43,11 +43,8 @@ * - uniquement sur les syst&egrave;mes qui supportent le type st_blksize. Les autres syst&egrave;mes (i.e. Windows) retournent -1. </para> - <para> - Les r&eacute;sultats de <function>lstat</function> sont mis en cache. - Reportez-vous &agrave; la fonction <function>clearstatcache</function> - pour plus de d&eacute;tails. - </para> + &note.no-remote; + &note.clearstatcache; </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/mkdir.xml diff -u phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.1 phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.1 Sun Apr 14 20:28:20 2002 +++ phpdoc-fr/reference/filesystem/functions/mkdir.xml Sat May 3 18:36:52 2003 @@ -4,15 +4,15 @@ <refentry id="function.mkdir"> <refnamediv> <refname>mkdir</refname> - <refpurpose>Cr&eacute;e un dossier.</refpurpose> + <refpurpose>Cr&eacute;e un dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mkdir</methodname> - <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>mkdir</methodname> + <methodparam><type>string</type><parameter>pathname</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> <para> <function>mkdir</function> tente de cr&eacute;er un dossier dans le chemin <parameter>pathname</parameter>. @@ -22,17 +22,32 @@ ce qui signifie que vous aurez probablement un 0 comme premier chiffre. Le mode sera aussi modifi&eacute; par le umask courant, que vous pouvez modifier avec la fonction <function>umask</function>. - <informalexample> + </para> + <para> + <note> + <para> + Le param&egrave;tre <parameter>mode</parameter> est ignor&eacute; sous Windows, + et il est devenu optionnel depuis &php; 4.2.0. + </para> + </note> + </para> + <para> + Le mode par d&eacute;faut est le mode 0777, ce qui correspond au maximum de + droits possible. Pour plus d'informations sur les modes, lisez en + d&eacute;tail la documentation de la fonction <function>chmod</function>. + <example> + <title>Exemple avec <function>mkdir</function></title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php mkdir ("/chemin/de/mon/dossier", 0700); -?&gt; +?> +]]> </programlisting> - </informalexample> + </example> </para> <para> - <function>mkdir</function> retourne &true; en cas de - succ&egrave;s, et &false; en cas d'&eacute;chec. + &return.success; </para> <para> Voir aussi Index: phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml diff -u phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.1 phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.1 Sun Apr 14 20:28:20 2002 +++ phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml Sat May 3 18:36:52 2003 @@ -4,20 +4,16 @@ <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> + <refpurpose>D&eacute;place un fichier t&eacute;l&eacute;charg&eacute;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>move_uploaded_file</methodname> + <type>bool</type><methodname>move_uploaded_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam><type>string</type><parameter>destination</parameter></methodparam> </methodsynopsis> <para> - <function>move_uploaded_file</function> est disponible &agrave; partir - des versions PHP 3.0.16 et 4.0.2. - </para> - <para> <function>move_uploaded_file</function> s'assure que le fichier <parameter>filename</parameter> est un fichier t&eacute;l&eacute;charg&eacute; par HTTP POST. Si le fichier est valide, il est d&eacute;plac&eacute; @@ -40,9 +36,23 @@ r&eacute;v&egrave;lent leur contenu &agrave; l'utilisateur, ou m&ecirc;me aux utilisateurs du m&ecirc;me syst&egrave;me. </para> + &note.sm.uidcheck; + <note> + <para> + <function>move_uploaded_file</function> n'est pas affect&eacute;e par les + restrictictions du &safemode;. Ce n'est pas un probl&egrave;me, car + <function>move_uploaded_file</function> ne fonctionne que sur des fichiers + qui ont &eacute;t&eacute; t&eacute;l&eacute;charg&eacute;s avec &php;. + </para> + </note> + <warning> + <para> + Si le fichier de destination existe d&eacute;j&agrave;, il sera &eacute;cras&eacute;. + </para> + </warning> <para> Voir aussi - <function>move_uploaded_file</function> et + <function>is_uploaded_file</function> et la section <link linkend="features.file-upload">Chargement de fichier</link> pour un exemple simple. </para> Index: phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.1 phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.1 Sun Apr 14 20:28:20 2002 +++ phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml Sat May 3 18:36:52 2003 @@ -11,9 +11,7 @@ <methodsynopsis> <type>array</type><methodname>parse_ini_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter> - process_sections - </parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>process_sections</parameter></methodparam> </methodsynopsis> <para> <function>parse_ini_file</function> charge le fichier @@ -27,7 +25,7 @@ <note> <para> Cette fonction n'a rien a voir avec le fichier - <filename>php.ini</filename>. Ce dernier a d&eacute;j&agrave; &eacute;tait + &php.ini;. Ce dernier a d&eacute;j&agrave; &eacute;tait trait&eacute; lorsque vous commencez a ex&eacute;cuter votre script. Cette fonction peut vous permettre de lire vos propres fichiers de configuration. @@ -35,19 +33,48 @@ </note> <para> La structure des fichiers de configuration lus est similaire - &agrave; celle de <filename>php.ini</filename>. + &agrave; celle de &php.ini;. </para> + <note> + <para> + Si une valeur du fichier .ini contient des donn&eacute;es non alphanum&eacute;rique, + il faut la prot&eacute;ger en la pla&ccedil;ant entre guillemets doubles ("). + </para> + </note> + <note> + <simpara> + Depuis &php; 4.2.1 cette fonction est aussi affect&eacute;e par + le &safemode; et <link linkend="ini.open-basedir">open_basedir</link>. + </simpara> + </note> + <para> + La strucute du fichier .ini est similaire &agrave; celle du + fichier &php.ini;. + </para> + <para> + Les <link linkend="language.constants">constantes</link> peuvent aussi + &ecirc;tre utilis&eacute;es dans le fichier .ini, ce qui fait que si vous d&eacute;finissez + une constante avant d'ex&eacute;cuter <function>parse_ini_file</function>, elle + sera int&eacute;gr&eacute;e dans les r&eacute;sultats. Seules les valeurs de configuration + sont remplac&eacute;es par leur &eacute;quivalent en constante. Par exemple : + </para> <para> <example> <title>Contenu de exemple.ini</title> <programlisting> -; Ceco est un fichier de configuration +<![CDATA[ +; Ceci est un fichier de configuration ; Les commentaires commencent par ';', comme dans php.ini + [premiere_section] un = 1 cinq = 5 +animal = oiseau + [seconde_section] chemin = /usr/local/bin +URL = "http://www.exemple.com/~utilisateur" +]]> </programlisting> </example> </para> @@ -55,14 +82,21 @@ <example> <title>Exemple avec <function>parse_ini_file</function></title> <programlisting> -&lt;?php -// Traitement sans les sections +<![CDATA[ +<?php + +define ('oiseau', 'dodu dodo'); + +// Analyse sans les sections $ini_array = parse_ini_file("exemple.ini"); print_r($ini_array); -// Traitement avec les sections -$ini_array = parse_ini_file("sample.ini", TRUE); + +// Analyse avec les sections +$ini_array = parse_ini_file("exemple.ini", TRUE); print_r($ini_array); -?&gt; + +?> +]]> </programlisting> </example> </para> @@ -70,24 +104,32 @@ Cet exemple va produire : <informalexample> <programlisting> +<![CDATA[ Array ( - [un] => 1 - [cinq] => 5 - [chemin] => /usr/local/bin + [un] => 1 + [cinq] => 5 + [animal] => dodu dodo + [chemin] => /usr/local/bin + [URL] => http://www.example.com/~username ) Array ( - [premiere_section] => Array - ( - [un] => 1 - [cinq] => 5 - ) - [seconde_section] => Array - ( - [chemin] => /usr/local/bin - ) + [premiere_section] => Array + ( + [un] => 1 + [cinq] => 5 + [animal] => dodu dodo + ) + + [seconde_section] => Array + ( + [chemin] => /usr/local/bin + [URL] => http://www.exemple.com/~utilisateur + ) + ) +]]> </programlisting> </informalexample> </para> Index: phpdoc-fr/reference/filesystem/functions/pathinfo.xml diff -u phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.1 phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.1 Sun Apr 14 20:28:22 2002 +++ phpdoc-fr/reference/filesystem/functions/pathinfo.xml Sat May 3 18:36:52 2003 @@ -23,12 +23,17 @@ <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; +<![CDATA[ +<?php + +$path_parts = pathinfo("/www/htdocs/index.html"); + +echo $path_parts["dirname"] . "\n"; +echo $path_parts["basename"] . "\n"; +echo $path_parts["extension"] . "\n"; + +?> +]]> </programlisting> </example> </para> @@ -36,12 +41,21 @@ Va afficher : <informalexample> <programlisting> +<![CDATA[ /www/htdocs index.html html +]]> </programlisting> </informalexample> </para> + <note> + <para> + Pour plus d'informations sur la lecture du chemin courant, + lisez la section sur les + <link linkend="language.variables.predefined">variables pr&eacute;d&eacute;finies</link>. + </para> + </note> <para> Voir aussi <function>dirname</function>, Index: phpdoc-fr/reference/filesystem/functions/pclose.xml diff -u phpdoc-fr/reference/filesystem/functions/pclose.xml:1.1 phpdoc-fr/reference/filesystem/functions/pclose.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/pclose.xml:1.1 Sun Apr 14 20:28:22 2002 +++ phpdoc-fr/reference/filesystem/functions/pclose.xml Sat May 3 18:36:52 2003 @@ -4,14 +4,14 @@ <refentry id="function.pclose"> <refnamediv> <refname>pclose</refname> - <refpurpose>Ferme un processus de pointeur de fichier.</refpurpose> + <refpurpose>Ferme un processus de pointeur de fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>pclose</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>pclose</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>pclose</function> ferme un processus de pointeur de fichier ouvert par <function>popen</function>. Index: phpdoc-fr/reference/filesystem/functions/popen.xml diff -u phpdoc-fr/reference/filesystem/functions/popen.xml:1.1 phpdoc-fr/reference/filesystem/functions/popen.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/popen.xml:1.1 Sun Apr 14 20:28:23 2002 +++ phpdoc-fr/reference/filesystem/functions/popen.xml Sat May 3 18:36:53 2003 @@ -4,15 +4,15 @@ <refentry id="function.popen"> <refnamediv> <refname>popen</refname> - <refpurpose>Cr&eacute;e un processus de pointeur de fichier.</refpurpose> + <refpurpose>Cr&eacute;e un processus de pointeur de fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>popen</methodname> - <methodparam><type>string</type><parameter>commet</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>resource</type><methodname>popen</methodname> + <methodparam><type>string</type><parameter>command</parameter></methodparam> + <methodparam><type>string</type><parameter>mode</parameter></methodparam> + </methodsynopsis> <para> <function>popen</function> ouvre un processus fils en faisant un fork de la commande. @@ -30,18 +30,47 @@ Si une erreur survient, retourne &false;. </para> <para> - <informalexample> + <example> + <title>Exemple avec <function>popen</function></title> <programlisting role="php"> -&lt;?php - $fp = popen("/bin/ls", "r"); -?&gt; +<![CDATA[ +<?php + $handle = popen ("/bin/ls", "r"); +?> +]]> </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>pclose</function>. + </example> </para> + <note> + <para> + Si la commande &agrave; ex&eacute;cuter n'a pu &ecirc;tre trouv&eacute;e, une ressource + valide sera retourn&eacute;e. Cela semble &eacute;trange, mais c'est pratique : + cela vous permet d'acc&eacute;der aux messages d'erreurs qui ont &eacute;t&eacute; + retourn&eacute; par le shell : + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + error_reporting(E_ALL); + +/* Ajoute une redirection pour que vous puissions lire stderr */ + $handle = popen('/path/to/spooge 2>&1', 'r'); + echo "'$handle'; " . gettype($handle) . "\n"; + $read = fread($handle, 2096); + echo $read; + pclose($handle); +?> +]]> + </programlisting> + </informalexample> + </para> + </note> + <para> + Voir aussi + <function>pclose</function>, + <function>fopen</function> et + <function>proc_open</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/readfile.xml diff -u phpdoc-fr/reference/filesystem/functions/readfile.xml:1.1 phpdoc-fr/reference/filesystem/functions/readfile.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/readfile.xml:1.1 Sun Apr 14 20:28:23 2002 +++ phpdoc-fr/reference/filesystem/functions/readfile.xml Sat May 3 18:36:53 2003 @@ -4,47 +4,26 @@ <refentry id="function.readfile"> <refnamediv> <refname>readfile</refname> - <refpurpose>Affiche un fichier.</refpurpose> + <refpurpose>Affiche un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>readfile</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - use_include_path - </parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>readfile</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> <para> <function>readfile</function> lit le fichier <parameter>filename</parameter> et - l'envoit &agrave; la sortie standard. + l'envoie &agrave; la sortie standard. </para> <para> <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. - Si une erreur survient, retourne &false;. - </para> - <para> - Si <parameter>filename</parameter> commence par "http://" (insensible - &agrave; la casse), une connexion HTTP 1.0 sera ouverte avec le serveur - sp&eacute;cifi&eacute;, et le texte de la r&eacute;ponse sera affich&eacute; - sur la sortie standard. - </para> - <simpara> - Les versions ant&eacute;rieures &agrave; PHP 4.0.6, ne g&egrave;re pas les redirections automatiques, - ce qui oblige &agrave; ajouter les slash finaux "/" pour indiquer un dossier. - </simpara> - <para> - Si <parameter>filename</parameter> commence par "ftp://" (insensible - &agrave; la casse), une connexion FTP est ouverte avec l'h&ocirc;te - sp&eacute;cifi&eacute; et la r&eacute;ponse du serveur est affich&eacute;e. - Si le serveur ne supporte les connexions passives, la requ&ecirc;te - &eacute;chouera. - </para> - <para> - Si <parameter>filename</parameter> ne commence par aucun des cas - pr&eacute;c&eacute;dents, le fichier sera ouvert sur l'h&ocirc;te - local, et envoy&eacute; &agrave; la sortie standard. + Si une erreur survient, retourne &false;, et &agrave; moins que la fonction n'ait + &eacute;t&eacute; appel&eacute;e avec @readfile, un message d'erreur est affich&eacute;. </para> + &tip.fopen-wrapper; <para> Vous pouvez utiliser le deuxi&egrave;me param&egrave;tre optionnel pour explorer le dossier <link linkend="ini.include-path">include_path</link>, @@ -56,8 +35,9 @@ <function>file</function>, <function>fopen</function>, <function>include</function>, - <function>require</function> et - <function>virtual</function>. + <function>require</function>, + <function>virtual</function> et + <xref linkend="wrappers"/>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/readlink.xml diff -u phpdoc-fr/reference/filesystem/functions/readlink.xml:1.1 phpdoc-fr/reference/filesystem/functions/readlink.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/readlink.xml:1.1 Sun Apr 14 20:28:23 2002 +++ phpdoc-fr/reference/filesystem/functions/readlink.xml Sat May 3 18:36:53 2003 @@ -23,7 +23,7 @@ <para> Voir aussi <function>symlink</function>, - <function>readlink</function> et + <function>is_link</function> et <function>linkinfo</function>. </para> <note> Index: phpdoc-fr/reference/filesystem/functions/realpath.xml diff -u phpdoc-fr/reference/filesystem/functions/realpath.xml:1.1 phpdoc-fr/reference/filesystem/functions/realpath.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/realpath.xml:1.1 Sun Apr 14 20:28:23 2002 +++ phpdoc-fr/reference/filesystem/functions/realpath.xml Sat May 3 18:36:53 2003 @@ -4,7 +4,7 @@ <refentry id="function.realpath"> <refnamediv> <refname>realpath</refname> - <refpurpose>Retourne le chemin canonique absolu.</refpurpose> + <refpurpose>Retourne le chemin canonique absolu</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -21,14 +21,22 @@ </para> <para> <example> - <title>Exemple <function>realpath</function></title> + <title>Exemple avec <function>realpath</function></title> <programlisting role="php"> -&lt;?php - $real_path = realpath("../../index.php"); -?&gt; +<![CDATA[ +<?php + $real_path = realpath ("../../index.php"); +?> +]]> </programlisting> </example> </para> + <para> + Voir aussi + <function>basename</function>, + <function>dirname</function> et + <function>pathinfo</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/rename.xml diff -u phpdoc-fr/reference/filesystem/functions/rename.xml:1.3 phpdoc-fr/reference/filesystem/functions/rename.xml:1.4 --- phpdoc-fr/reference/filesystem/functions/rename.xml:1.3 Thu Sep 19 21:01:51 2002 +++ phpdoc-fr/reference/filesystem/functions/rename.xml Sat May 3 18:36:53 2003 @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>boolean</type><methodname>rename</methodname> + <type>bool</type><methodname>rename</methodname> <methodparam><type>string</type><parameter>oldname</parameter></methodparam> <methodparam><type>string</type><parameter>newname</parameter></methodparam> </methodsynopsis> @@ -18,8 +18,9 @@ <parameter>oldname</parameter> en <parameter>newname</parameter>. </para> <para> - <function>rename</function> retourne &true; en cas de succ&egrave;s - et &false; sinon. + &return.success; + </para> + <para> <example> <title>Exemple avec <function>rename</function></title> <programlisting role="php"> Index: phpdoc-fr/reference/filesystem/functions/rewind.xml diff -u phpdoc-fr/reference/filesystem/functions/rewind.xml:1.1 phpdoc-fr/reference/filesystem/functions/rewind.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/rewind.xml:1.1 Sun Apr 14 20:28:23 2002 +++ phpdoc-fr/reference/filesystem/functions/rewind.xml Sat May 3 18:36:53 2003 @@ -4,17 +4,17 @@ <refentry id="function.rewind"> <refnamediv> <refname>rewind</refname> - <refpurpose>Replace le pointeur de fichier au d&eacute;but.</refpurpose> + <refpurpose>Replace le pointeur de fichier au d&eacute;but</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>rewind</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>rewind</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> <para> <function>rewind</function> replace le pointeur du fichier - <parameter>fp</parameter> au d&eacute;but. + <parameter>handle</parameter> au d&eacute;but. </para> <para> Si une erreur survient, retourne &false;. @@ -23,6 +23,13 @@ Le pointeur de fichier doit &ecirc;tre valide, et avoir &eacute;t&eacute; correctement ouvert par <function>fopen</function>. </para> + <note> + <para> + Si vous avez ouvert le fichier en mode d'ajout ("a"), toutes les donn&eacute;es + que vous &eacute;crirez dans ce fichier seront toujours ajout&eacute;es, ind&eacute;pendemment + de la position du pointeur de fichier. + </para> + </note> <para> Voir aussi <function>fseek</function> et Index: phpdoc-fr/reference/filesystem/functions/rmdir.xml diff -u phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.1 phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.1 Sun Apr 14 20:28:24 2002 +++ phpdoc-fr/reference/filesystem/functions/rmdir.xml Sat May 3 18:36:53 2003 @@ -4,7 +4,7 @@ <refentry id="function.rmdir"> <refnamediv> <refname>rmdir</refname> - <refpurpose>Efface un dossier.</refpurpose> + <refpurpose>Efface un dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,11 +18,12 @@ et le script doit avoir les autorisations ad&eacute;quates. </para> <para> - Si une erreur survient, <function>rmdir</function> retourne &false;. + &return.success; </para> <para> Voir aussi - <function>mkdir</function>. + <function>mkdir</function> et + <function>unlink</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml diff -u phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.1 phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.1 Sun Apr 14 20:28:24 2002 +++ phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml Sat May 3 18:36:53 2003 @@ -5,54 +5,20 @@ <refnamediv> <refname>set_file_buffer</refname> <refpurpose> - Fixe la bufferisation de fichier + Alias de <function>stream_set_write_buffer</function> </refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>set_file_buffer</methodname> - <methodparam><type>int</type><parameter>fp</parameter></methodparam> + <methodparam><type>int</type><parameter>handle</parameter></methodparam> <methodparam><type>int</type><parameter>buffer</parameter></methodparam> </methodsynopsis> <simpara> - L'&eacute;criture de fichier avec <function>fwrite</function> utilise normalement - un buffer de 8K. Cela signifie que si deux processus essaient d'&eacute;crire - dans le m&ecirc;me fichier, ils font une pause tous les 8ko pour laisser le temps - &agrave; l'autre d'&eacute;crire &agrave; son tour. - <function>set_file_buffer</function> permet de modifier la taille du buffer de - sortie pour le pointeur de fichier <parameter>fp</parameter> &agrave; - <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, - l'&eacute;criture se fera sans buffer. Cela force un processus &agrave; &eacute;crire - toutes ses donn&eacute;es dans un fichier avant que les autres puissent y acc&eacute;der. - </simpara> - <simpara> - <function>set_file_buffer</function> retourne 0 en cas de succ&egrave;s, ou - EOF si la requ&ecirc;te ne peut pas &ecirc;tre honor&eacute;e. - </simpara> - <para> - L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour cr&eacute;er un fichier - sans buffer. - <example> - <title>Exemple avec <function>set_file_buffer</function></title> - <programlisting role="php"> -&lt;?php - $fp=fopen($file, "w"); - if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); - } -?&gt; - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>fopen</function> et - <function>fwrite</function>. - </simpara> + <function>set_file_buffer</function> est un &alias; de + <function>stream_set_write_buffer</function>. + </simpara> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/stat.xml diff -u phpdoc-fr/reference/filesystem/functions/stat.xml:1.1 phpdoc-fr/reference/filesystem/functions/stat.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/stat.xml:1.1 Sun Apr 14 20:28:24 2002 +++ phpdoc-fr/reference/filesystem/functions/stat.xml Sat May 3 18:36:53 2003 @@ -4,7 +4,7 @@ <refentry id="function.stat"> <refnamediv> <refname>stat</refname> - <refpurpose>Renvoie les informations &agrave; propos d'un fichier.</refpurpose> + <refpurpose>Renvoie les informations &agrave; propos d'un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -44,15 +44,14 @@ <para> <function>stat</function> retourne &false; en cas d'erreur. </para> - <para> - <function>stat</function> ne g&egrave;re pas les URL comme peut le - faire <function>fopen</function>. - </para> - <para> - Les r&eacute;sultats de <function>stat</function> sont mis en cache. - Reportez-vous &agrave; la fonction <function>clearstatcache</function> pour - plus de d&eacute;tails. - </para> + &note.clearstatcache; + &note.no-remote; + <para> + Voir aussi + <function>lstat</function>, + <function>filemtime</function> et + <function>filegroup</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/symlink.xml diff -u phpdoc-fr/reference/filesystem/functions/symlink.xml:1.1 phpdoc-fr/reference/filesystem/functions/symlink.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/symlink.xml:1.1 Sun Apr 14 20:28:24 2002 +++ phpdoc-fr/reference/filesystem/functions/symlink.xml Sat May 3 18:36:53 2003 @@ -4,7 +4,7 @@ <refentry id="function.symlink"> <refnamediv> <refname>symlink</refname> - <refpurpose>Cr&eacute;e un lien symbolique.</refpurpose> + <refpurpose>Cr&eacute;e un lien symbolique</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/filesystem/functions/tempnam.xml diff -u phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.1 phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.1 Sun Apr 14 20:28:24 2002 +++ phpdoc-fr/reference/filesystem/functions/tempnam.xml Sat May 3 18:36:53 2003 @@ -4,7 +4,7 @@ <refentry id="function.tempnam"> <refnamediv> <refname>tempnam</refname> - <refpurpose>Cr&eacute;e un fichier avec un nom unique.</refpurpose> + <refpurpose>Cr&eacute;e un fichier avec un nom unique</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -34,12 +34,36 @@ <example> <title>Exemple avec <function>tempnam</function></title> <programlisting role="php"> -&lt;?php - $tmpfname = tempnam("/tmp", "FOO"); -?&gt; +<![CDATA[ +$tmpfname = tempnam ("/tmp", "FOO"); + +$handle = fopen($tmpfname, "w"); +fwrite($handle, "Ecrire dans le fichier temporaire"); +fclose($handle); + +// faire quelquechose ici + +unlink($tmpfname); +]]> </programlisting> </example> </para> + <note> + <simpara> + Le comportement de <function>tempnam</function> a &eacute;t&eacute; modifi&eacute; en + &php; 4.0.3. Le fichier temporaire est aussi + cr&eacute;&eacute; pour &eacute;viter des conflits si le fichier apparait dans le syst&egrave;me + de fichiers entre le moment o&ugrave; la cha&icirc;ne est g&eacute;n&eacute;r&eacute;e et avant que le + script n'ai termin&eacute; la c&eacute;ration du fichier. Notez que vous devez + effacer le fichier si vous n'en avez plus besoin, car cela n'est pas + fait automatiquement. + </simpara> + </note> + <para> + Voir aussi + <function>tmpfile</function> et + <function>unlink</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/filesystem/functions/tmpfile.xml diff -u phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.1 phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.1 Sun Apr 14 20:28:25 2002 +++ phpdoc-fr/reference/filesystem/functions/tmpfile.xml Sat May 3 18:36:53 2003 @@ -8,10 +8,10 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>tmpfile</methodname> - <void/> - </methodsynopsis> + <methodsynopsis> + <type>resource</type><methodname>tmpfile</methodname> + <void/> + </methodsynopsis> <para> <function>tmpfile</function> cr&eacute;e un fichier temporaire avec un nom unique, ouvert en &eacute;criture, et retourne un @@ -26,6 +26,20 @@ sur la fonction <literal>tmpfile(3)</literal>, et sur <filename>stdio.h</filename>. </para> + <para> + <example> + <title>Exemple avec <function>tmpfile</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + $temp = tmpfile(); + fwrite($temp, "Ecriture dans le fichier temporaire"); + fclose($temp); // Ceci supprime le fichier temporaire +?> +]]> + </programlisting> + </example> + </para> <para> Voir aussi <function>tempnam</function>. Index: phpdoc-fr/reference/filesystem/functions/touch.xml diff -u phpdoc-fr/reference/filesystem/functions/touch.xml:1.1 phpdoc-fr/reference/filesystem/functions/touch.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/touch.xml:1.1 Sun Apr 14 20:28:25 2002 +++ phpdoc-fr/reference/filesystem/functions/touch.xml Sat May 3 18:36:53 2003 @@ -4,17 +4,16 @@ <refentry id="function.touch"> <refnamediv> <refname>touch</refname> - <refpurpose> - Affecte une nouvelle date de modification &agrave; un fichier. - </refpurpose> + <refpurpose>Modifie la date de modification et de derni&egrave;r acc&egrave;s d'un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>touch</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>time</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>touch</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>time</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>atime</parameter></methodparam> + </methodsynopsis> <para> <function>touch</function> tente de forcer la date de modification du fichier nomm&eacute; <parameter>filename</parameter> &agrave; la date de @@ -25,16 +24,23 @@ Si le fichier n'existe pas, il est cr&eacute;&eacute;. </para> <para> - <function>touch</function> retourne &true; en cas de succ&egrave;s, - et &false; sinon. + &return.success; + </para> + <para> <example> <title>Exemple avec <function>touch</function></title> <programlisting role="php"> +<![CDATA[ +<?php if ( touch($NomDeFichier) ) { - print "La date de modification de $NomDeFichier a &eacute;t&eacute; fix&eacute;e &agrave; maintenant"; + 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"; + print "D&eacute;sol&eacute;, il est impossible de changer + la date de modification de $NomDeFichier"; } +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/filesystem/functions/umask.xml diff -u phpdoc-fr/reference/filesystem/functions/umask.xml:1.1 phpdoc-fr/reference/filesystem/functions/umask.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/umask.xml:1.1 Sun Apr 14 20:28:25 2002 +++ phpdoc-fr/reference/filesystem/functions/umask.xml Sat May 3 18:36:53 2003 @@ -4,14 +4,14 @@ <refentry id="function.umask"> <refnamediv> <refname>umask</refname> - <refpurpose>Change le "umask" courant.</refpurpose> + <refpurpose>Change le "umask" courant</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>umask</methodname> - <methodparam><type>int</type><parameter>mask</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>umask</methodname> + <methodparam choice="opt"><type>int</type><parameter>mask</parameter></methodparam> + </methodsynopsis> <para> <function>umask</function> change le umask de PHP : mask &amp; 0777 et retourne le vieux umask. Lorsque PHP est utilis&eacute; comme module de serveur, Index: phpdoc-fr/reference/filesystem/functions/file-put-contents.xml +++ phpdoc-fr/reference/filesystem/functions/file-put-contents.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.file-put-contents"> <refnamediv> <refname>file_put_contents</refname> <refpurpose>Ecrit une cha&icirc;ne dans un fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>int</type><methodname>file_put_contents</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam><type>string</type><parameter>data</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> </methodsynopsis> <simpara> <function>file_put_contents</function> revient &agrave; appeler successivement <function>fopen</function>, <function>fwrite</function>, et <function>fclose</function>. </simpara> <simpara> Le param&egrave;tre <parameter>flags</parameter> peut valoir <constant>FILE_USE_INCLUDE_PATH</constant> et/ou <constant>FILE_APPEND</constant>, mais <constant>FILE_USE_INCLUDE_PATH</constant> doit &ecirc;tre utilis&eacute; avec prudence. </simpara> &note.bin-safe; &tip.fopen-wrapper; <simpara> Voir aussi <function>fopen</function>, <function>fwrite</function>, <function>fclose</function> et <function>file_get_contents</function>. </simpara> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/filesystem/functions/fnmatch.xml +++ phpdoc-fr/reference/filesystem/functions/fnmatch.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.fnmatch"> <refnamediv> <refname>fnmatch</refname> <refpurpose>Rep&egrave;re un fichier &agrave; partir d'un masque</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>fnmatch</methodname> <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam><type>string</type><parameter>string</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>fnmatch</function> v&eacute;rifie si la cha&icirc;ne <parameter>string</parameter> va passer le masque shell <parameter>pattern</parameter>. </para> <para> C'est tout particuli&egrave;rement pratique pour les noms de fichiers, et il peut &ecirc;tre utilis&eacute; sur des cha&icirc;nes de caract&egrave;res. L'utilisateur moyen de shell peut &ecirc;tre familier avec les masques shell, ou tout au moins, leur expression les plus simples, comme <literal>'?'</literal> et <literal>'*'</literal>. De cette fa&ccedil;on, utiliser <function>fnmatch</function> au lieu de <function>ereg</function> ou <function>preg_match</function> pour des recherches peut &ecirc;tre plus pratique pour les non-initi&eacute;s. </para> <example> <title>V&eacute;rifier le nom d'une couleur avec un masque shell</title> <programlisting role="php"> <![CDATA[ <?php if(fnmatch("*gr[ae]y", $color)) { echo "some form of gray ..."; } ?> ]]> </programlisting> </example> <para> Voir aussi <function>glob</function>, <function>ereg</function>, <function>preg_match</function> et le manuel Unix de <literal>fnmatch(3)</literal> pour les options (tant qu'elles ne seront pas document&eacute;es ici). </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/filesystem/functions/glob.xml +++ phpdoc-fr/reference/filesystem/functions/glob.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.glob"> <refnamediv> <refname>glob</refname> <refpurpose>Recheche des chemins qui v&eacute;rifie un masque</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>glob</methodname> <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>glob</function> recherche tous les chemins qui v&eacute;rifient le masque <parameter>pattern</parameter>, en suivant les r&egrave;gles du shell. Aucun remlacement de tilde ~ ou de param&egrave;tre n'est fait. </para> <para> <function>glob</function> retourne un tableau contenant les chemins et fichiers trouv&eacute;s, ou &false; en cas d'erreur. </para> <example> <title> Un moyen pratique pour remplacer <function>opendir</function> par <function>glob</function> </title> <programlisting role="php"> <![CDATA[ <?php foreach (glob("*.txt") as $filename) { echo "$filename occupe " . filesize($filename) . " octets\n"; } ?> ]]> </programlisting> <para> Le r&eacute;sultat du script ci-dessus pourrait &ecirc;tre : </para> <screen> funclist.txt occupe 44686 octets funcsummary.txt occupe 267625 octets quickref.txt occupe 137820 octets </screen> </example> &note.no-remote; <para> Voir aussi <function>opendir</function>, <function>readdir</function>, <function>closedir</function>, <function>fnmatch</function> et le manuel Unix de <literal>fnmatch(3)</literal> pour les options (tant qu'elles ne seront pas document&eacute;es ici). </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.fr (#344) next »