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: | Damien Seguy | 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è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"> -<?php - $path = "/home/httpd/html/index.php3"; - $file = basename($path); - // $file est affecté avec "index.php3" -?> +<![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 été ajouté 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é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étaire - du fichier. Seul le super-utilisateur (root) peut changer le groupe + <function>chgrp</function> essaie de remplacer le groupe propriétaire + courant du fichier <parameter>filename</parameter> par <parameter>group</parameter>. + Seul le super-utilisateur (root) peut changer le groupe propriétaire d'un fichier arbitrairement. Les utilisateurs - classiques ne peuvent changer - le groupe propriétaire d'un fichier que si l'utilisateur - propriétaire du fichier est membre du groupe. + classiques ne peuvent changer le groupe propriétaire d'un + fichier que si l'utilisateur propriétaire du fichier est + membre du groupe. </para> <para> - <function>chgrp</function> renvoie &true; en - cas de succè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éré comme un nombre en notation octale. Afin de vous en assurer, vous pouvez préfixer cette valeur par un zéro (<parameter>mode</parameter>): - <informalexample> + <example> + <title>Comment utiliser <function>chmod</function></title> <programlisting role="php"> -<?php - chmod( "/somedir/somefile", 755 ); -// notation décimale; probablement <literal>FALSE</literal> - chmod( "/somedir/somefile", 0755 ); -// notation octale; valeur du mode correcte -?> +<![CDATA[ +chmod ("/somedir/somefile", 755); +// notation décimale : probablement faux +chmod ("/somedir/somefile", "u+rwx,go+rx"); +// chaîne : incorrect +chmod ("/somedir/somefile", 0755); +// notation octale : valeur du mode correcte +]]> </programlisting> - </informalexample> + </example> </para> + <para> + Le paramètre <parameter>mode</parameter> est constitué de trois + valeurs octacles qui spécifient les droits pour le propriétaire, + le group du propriétaire et les autres, respectivement. Chaque + composant peut être calculé en ajoutant les droits désirés. + Le chiffre 1 donne les droits d'éxécution, le chiffre 2 les droits + d'écriture et le chiffre 4 les droits de lecture. Ajoutez simplement + ces nombres pour spécifier les droits voulus. Vous pouvez aussi + lire le manuel des systèmes Unix avec 'man 1 chmod' et 'man 2 chmod'. + <informalexample> + <programlisting role="php"> +<![CDATA[ +// Lecture et écriture pour le propriétaire, rien pour les autres +chmod ("/un_dossier/un_fichier", 0600); + +// Lecture et écriture pour le propriétaire, écriture pour les autres +chmod ("/un_dossier/un_fichier", 0644); + +// Tous pour le propriétaire, lecture et écriture pour les autres +chmod ("/un_dossier/un_fichier", 0755); + +// Tout pour le propriétaire, lecture exé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é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ès, &false; sinon. + &return.success; </para> + ¬e.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étaire du fichier.</refpurpose> + <refpurpose>Change le groupe proprié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ès, "&false;" sinon. - <note> - <simpara> - Sous Windows, <function>chown</function> ne fait rien et - retourne &true;. - </simpara> - </note> + &return.success; </para> + ¬e.no-remote; <para> Voir aussi - <function>chown</function> et <function>chmod</function>. </para> - <note> - <simpara> - <function>chown</function> est inopérante sous Windows. - </simpara> - </note> </refsect1> </refentry> 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è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éussi...<br>\n"); -} +<![CDATA[ +<?php + if (!copy($file, $file.'.bak')) { + print("La copie du fichier $file n'a pas réussi...<BR>\n"); + } +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>rename</function>. - </para> + <note> + <para> + Depuis &php; 4.3.0, les deux paramètres <parameter>source</parameter> et + <parameter>dest</parameter> peuvent être des URL si les gestionnaires + d'URL ont été activés ("fopen wrappers"). Voyez la fonction + <function>fopen</function> pour plus de détails. + Si <parameter>dest</parameter> est une URL, la copie peut échouer si + ce protocole ne supporte pas l'écrasement de fichiers existants. + </para> + </note> + <warning> + <para> + Si le fichier de destination <parameter>dest</parameter> existe déjà, + il sera écrasé. + </para> + </warning> + <para> + Voir aussi + <function>move_uploaded_file</function>, + <function>rename</function> et + la section sur les <link linkend="features.file-upload">télé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"> -<?php +<![CDATA[ +<?php $path = "/etc/passwd"; - $file = dirname($path); // $file contient "/etc" -?> + $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 été modifié pour être + compatible POSIX. Cela signifie notamment que si il n'y a pas + de slash dans le paramètre <parameter>path</parameter>, un + point ('<literal>.</literal>') est retourné, indiquant le + dossier courant. Sinon, la chaîne retournée est + <parameter>path</parameter> avec le composant final + <literal>/composant</literal> supprimé. Notez que cela signifie + que vous allez obtenir un slash ou un point là ou l'ancien + comportement de <function>dirname</function> retournait une + chaî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"> -<?php +<![CDATA[ +<?php $df = disk_free_space("/"); // $df contient le nombre d'octets libres sur "/" -?> +?> +]]> </programlisting> </example> </para> + ¬e.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"> -<?php +<![CDATA[ +<?php $df = disk_total_space("/"); // $df contient le nombre d'octets libres - // dans le dossier "/" -?> + // dans le dossier "/" +?> +]]> </programlisting> </example> </para> - ¬e.sm.uidcheck; + ¬e.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ès, - et &false; en cas d'échec. + &return.success; </para> <para> Le pointeur de fichier doit être valide et doit avoir été 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 à la fin du fichier, ou si + <parameter>handle</parameter> est à 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'écriture de toutes les données bufferisées dans le fichier désigné - par <parameter>fp</parameter>. <function>fflush</function> retourne + par <parameter>handle</parameter>. <function>fflush</function> retourne &true; en cas de succè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 à <function>fgets</function> mais <function>fgetcsv</function> + <function>fgetcsv</function> est identique à + <function>fgets</function> mais <function>fgetcsv</function> analyse la ligne qu'il lit et recherche les champs CSV, qu'il va retourner dans un tableau les contenant. Le délimiteur de champs <parameter>delimiter</parameter> est la virgule, à moins que vous ne fournissiez un troisième argument. </simpara> + <note> + <simpara> + Le paramètre <parameter>enclosure</parameter> a été ajouté en PHP 4.3.0. + </simpara> + </note> <simpara> - <parameter>fp</parameter> doit être un pointeur valide, et avoir + <parameter>handle</parameter> doit être un pointeur valide, et avoir été 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ée dans le - tableau comme une chaîne vide, et ne sera pas traitée comme - une erreur. - </simpara> + <note> + <simpara> + Une ligne vide dans un fichier CSV sera retournée sous la + forme d'un tableau contenant la valeur &null; et ne sera pas traité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"> -<?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 "<p> $num champs dans la ligne $row: <br>"; + print "<p> $num champs dans la ligne $row: <br>\n"; $row++; - for ($c=0; $c<$num; $c++) { - print $data[$c] . "<br>"; + for ($c=0; $c < $num; $c++) { + print $data[$c] . "<br>\n"; } - } - fclose ($fp); -?> +} +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îne lue jusqu'à 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 être valide, et avoir été + <parameter>handle</parameter> doit être valide, et avoir été 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"> -<?php +<![CDATA[ +<?php $fd = fopen ("/tmp/inputfile.txt", "r"); - while (!feof($fd)) { + while (!feof ($fd)) { $buffer = fgets($fd, 4096); echo $buffer; } fclose ($fd); -?> +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>fread</function>, - <function>fopen</function>, - <function>popen</function>, - <function>fgetc</function>, - <function>fsockopen</function> et - <function>socket_set_timeout</function>. - </para> + <note> + <simpara> + Le paramètre <parameter>length</parameter> est devenu optionnel depuis + &php; 4.2.0. Si il est omis, il prend la valeur par défaut de 1024. + Depuis &php; 4.3.0, omettre le paramètre <parameter>length</parameter> fait + que la fonction va continuer à lire le flôt jusqu'à ce que la ligne + s'achèbe. Si la majorité des lignes du fichier dépassent les 8 ko, + il est plus efficace pour votre script de spécifier ce paramètre. + </simpara> + </note> + <note> + <simpara> + <function>fgets</function> est compatible avec les données binaires depuis + &php; 4.3. Les versions plus anciennes ne le sont pas. + </simpara> + </note> + ¬e.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 à <function>fgets</function>, mais <function>fgetss</function> + <function>fgetss</function> est identique à <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ème paramètre, optionnel. <note> <para> - <parameter>allowable_tags</parameter> a été ajouté dans - PHP 3.0.13, PHP 4B3. + <parameter>allowable_tags</parameter> a été ajouté en + PHP 3.0.13 et PHP 4.0.0. </para> </note> </para> + ¬e.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érifie si un fichier existe.</refpurpose> + <refpurpose>Vé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 à <function>clearstatcache</function> pour plus de détails. </simpara> + <note> + <title>Utilisation des dossiers partagés Windows</title> + <para> + Sous Windows, utilisez le format de chemin + <filename>//computername/share/filename</filename> ou + <filename>\\\\computername\share\filename</filename> pour vérifier qu'un + fichier est disponible sur le partage ré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> + ¬e.clearstatcache; + + ¬e.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î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 à la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une chaîne. </para> <note> <para> Cette fonction a été introduite en PHP 4.3.0. </para> </note> ¬e.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î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 à la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une chaîne. </para> <note> <para> Cette fonction a été introduite en PHP 4.3.0. </para> </note> ¬e.bin-safe; &tip.fopen-wrapper; <note> <simpara> Le support de l'argument <parameter>context</parameter> sera ajouté 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ésultat dans un tableau. + Lit le fichier et renvoie le ré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 à <function>readfile</function>, hormis le fait que + <function>file</function> est identique à <function>readfile</function>, + hormis le fait que <function>file</function> retourne le fichier dans un tableau. Chaque élément du tableau correspond à une ligne du fichier, et les retour-chariots sont placés en fin de ligne. </para> + <note> + <para> + Chaque élément du tableau résultat contiendra la nouvelle ligne de fin de chaîne. + Il faudra donc utiliser <function>trim</function> sur cette valeur + pour le supprimer. + </para> + </note> + ¬e.line-endings; <para> Vous pouvez utiliser l'option <parameter>use_include_path</parameter> : en la mettant à "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"> -<?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 "<B>Ligne $numero_ligne:</B> ".htmlspecialchars( $ligne ) . "<br>\n"; - } -// lire une page web dans une chaîne - $fcontents = join( '', file( 'http://www.php.net' ) ); -?> +<![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é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î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îne. + </para> + <para> + En PHP 4.3.0 <function>file</function> est désormais compatible avec les donné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 à <function>clearstatcache</function> pour plus de détails. </simpara> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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érante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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éro d'inode du fichier.</refpurpose> + <refpurpose>Renvoie le numéro d'inode du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -32,6 +32,9 @@ <function>fileinode</function> est inopérante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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é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 été modifié le : December 29 2002 22:16:23. + +$filename = 'lefichier.txt'; +if (file_exists($filename)) { + echo "$filename a été modifié le : " . date ("F d Y H:i:s.", filemtime($filename)); +} +?> +]]> + </programlisting> + </example> + </para> + ¬e.clearstatcache; + + ¬e.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étaire du fichier.</refpurpose> + <refpurpose>Renvoie le nom du propriétaire du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -34,6 +34,9 @@ <function>fileowner</function> est inopérante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> - <para> - Le résultat de <function>filetype</function> est mis en cache. - Reportez-vous à <function>clearstatcache</function> pour plus de - détails. - </para> + ¬e.clearstatcache; + + ¬e.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>&wouldblock</parameter></methodparam> + </methodsynopsis> <simpara> PHP dispose d'un système complet de verrouillage de fichiers. Tous les programmes qui accèdent au fichier doivent utiliser la même méthode de verrouillage pour qu'il soit efficace. </simpara> <simpara> - <function>flock</function> agit sur le fichier <parameter>fp</parameter> + <function>flock</function> agit sur le fichier <parameter>handle</parameter> qui doit avoir été ouvert au pré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 (écriture), - <parameter>operation</parameter> = 2. - </simpara> + Acquisition d'un verrou exclusif en é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ération d'un verrou (partagé ou exclusif), - <parameter>operation</parameter> = 3. + Libération d'un verrou partagé 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 à <parameter>operation</parameter>. + le verrouillage, ajoutez <constant>LOCK_NB</constant> à + <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éaliser un système simple de verrous écriture / lecture, qui peut être utilisé sur - n'importe quelle plate-forme (Unix et Windows compris). + n'importe quelle plate-forme (Unix et Windows compris). Le troisième + paramètre optionnel vaut par défaut &true;, si le verrou doit bloquer le + script (condition d'erreur EWOULDBLOCK). </simpara> <simpara> - <function>flock</function> retourne &true; en cas - de succès, et &false; - sinon. (le verrou n'a pas pu être obtenu). + &return.success; </simpara> - <warning> - <para> - Sur la plupart des OS, <function>flock</function> est implémenté - au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, - comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> - pour protéger vos fichiers contre des accès concurrents du - même serveur. - </para> - </warning> + <note> + <para> + Comme <function>flock</function> requiert un pointeur de fichier, vous + aurez peut être à utiliser un verrou spécial pour protéger l'accès au fichier + que vous voulez tronquer en l'ouvrant en mode d'é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èmes de fichiers réseaux. Vérifiez la documentation de votre + système d'exploitation pour plus de détails. + </para> + <para> + Sur certains systèmes d'exploitation, <function>flock</function> est implémenté + 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éger vos fichiers contre d'autres scripts &php; qui fonctionnent + en paralelle sur d'autres thread du même serveur. + </para> + <para> + <function>flock</function> n'est pas supporté sur les vieux systèmes de fichiers + comme <literal>FAT</literal> et ses dérivés, et elle retournera forcément + &false; sous ces environnement (ceci est particuliè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 à - la casse), une connexion HTTP 1.x est ouverte avec le serveur - spécifié, et un pointeur sur la réponse fournie est - retourné. Une en-tête '<literal>Host:</literal>' est envoyé avec la - requête, afin de gérer les virtual hosts basé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ée une ressource nommée, spécifiée par le + paramètre <parameter>filename</parameter>, sous la forme d'un flôt. + Si <parameter>filename</parameter> est de la forme "protocole://...", + <parameter>filename</parameter> est supposé être une URL, et &php; va + rechercher un gestionnaire de protocole adapté pour lire ce fichier. + Si aucun gestionnaire pour ce protocole n'est disponible, &php; va émettre + une alerte qui vous permettra de savoir que vous avez des problè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é représente le corps de la - réponse, et qu'il n'est pas possible d'accéder aux en-têtes HTTP - avec cette fonction. - </simpara> - <simpara> - Les versions antérieures à PHP 4.0.6, ne gère pas les - redirections automatiques, ce qui oblige à ajouter les slash finaux - "/" pour indiquer un dossier. - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "ftp://" (insensible à - la casse), une connexion FTP est ouverte avec le serveur spécifié, - et un pointeur sur la réponse fournie est retourné. Si le serveur - ne supporte par le mode FTP passif, <function>fopen</function> échouera. - Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture - seulement (le full duplex n'est pas supporté). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", - ou "php://stderr", le flot correspondant sera ouvert. (Cela a été - introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" - ou "/dev/fd/0" devaient être utilisés pour accéder à - ces flots). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP - tentera de lire ce fichier dans le système local, et un pointeur sur - le fichier ouvert sera retourné. - </simpara> - <simpara> - Si l'ouverture échoue, <function>fopen</function> retourne - &false;. - </simpara> + Si &php; décide que le fichier <parameter>filename</parameter> est un fichier + local, il va essayer d'ouvrir un flôt avec ce fichier. Le fichier doit être + accessible à &php;. Il vous faut donc vous assurer que vous avez les + droits d'accès à ce fichier. Si vous activé 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écidé que <parameter>filename</parameter> spécifie + un protocole enregistré, et que ce protocole est enregistré comme + un protocole réseau, &php; s'assurera que la directive + <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activée. + Si elle est inactive, &php; va émettre une alerte, et l'ouverte + va échouer. + </simpara> + <note> + <simpara> + La liste des protocoles supporté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 à 1. </para> <para> + Le paramètre optionnel <parameter>zcontext</parameter> est utilisé pour + spécifier des paramètres d'optimisation et de callback. + </para> + <simpara> + Si l'ouverture échoue, <function>fopen</function> retournera &false;. + </simpara> + <para> <example> <title>Exemple avec <function>fopen</function></title> <programlisting role="php"> -<?php - $fp = fopen("/home/rasmus/file.txt", "r"); - $fp = fopen("http://www.php.net/", "r"); - $fp = fopen("ftp://user:password@example.com/", "w"); -?> +<![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 échapper les anti-slash utilisé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"> -<?php - $fp = fopen("c:\\data\\info.txt", "r"); -?> +<![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ée aprè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'à la fin, et dirige le ré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ères + lu dans <parameter>handle</parameter> et passé à la sortie standard. </simpara> <simpara> Le pointeur de fichier doit être valide, et doit avoir été correctement ouvert par <function>fopen</function>, <function>popen</function>, ou <function>fsockopen</function>. Après lecture, <function>fpassthru</function> va fermer le fichier (le pointeur - <parameter>fp</parameter> sera alors invalide). - </simpara> - <simpara> - Si vous voulez simplement afficher le contenu d'un fichier, il - suffit d'utiliser <function>readfile</function>, ce qui épargnera - l'appel à <function>fopen</function>. + <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ès utilisé dans <function>fopen</function>. + </para> + <para> + Vous êtes encouragés à utiliser l'option <literal>b</literal> lorsque vous + traitez des fichiers binaires, même si votre système ne le requiert pas, + de façon à 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'à <parameter>length</parameter> - octets dans le fichier reférencé par <parameter>fp</parameter>. + octets dans le fichier reférencé par <parameter>handle</parameter>. La lecture s'arrête lorsque <parameter>length</parameter> octets ont été lus, ou que l'on a atteint la fin du fichier, ou qu'une erreur survient (le premier des trois). @@ -23,13 +23,15 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Lit un fichier, et le place dans une chaîne - $filename = "/usr/local/quelquechose.txt"; - $fd = fopen($filename, "r"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?> +$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"> -<?php +<![CDATA[ +<?php $filename = "c:\\fichiers\\uneimage.gif"; - $fd = fopen($filename, "rb"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?> + $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 à <function>sscanf</function>, mais elle prend comme @@ -26,29 +26,49 @@ optionnels sont passés, la fonction retournera le nombre de valeurs assignées. Les options doivent être passées par référence. + </para> + <para> + Tous les caractères blancs de la chaîne de formattage correspondent + à autant d'espaces dans le flôt d'entrée. Cela signifie qu'une tabulation + <literal>\t</literal> dans la chaîne de format peut remplacer + un espace simple dans le flôt d'entrée. + </para> + <para> <example> - <title>Exemple <function>fscanf</function></title> + <title>Exemple avec <function>fscanf</function></title> <programlisting role="php"> -<?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ées } - fclose($fp); -?> - </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ères lus dans le fichier + était de 512 (ou bien jusqu'à la première nouvelle ligne "\n" : en fait, + le premier des deux). Depuis &php; 4.3.0, des lignes de n'importe quelle + taille peuvent ê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ée en octets à partir du début du fichier, est obtenue en additionnant la distance <parameter>offset</parameter> à la position <parameter>whence</parameter>. Ce paramètre peut prendre les valeurs suivantes : <simplelist> + <member> + <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ée à <parameter>offset</parameter> octets. </member> <member> - SEEK_CUR - La position finale vaut la position courante - ajoutée à <parameter>offset</parameter> octets. - </member> - <member> - SEEK_END - La position finale vaut la position courante par rapport à - la fin du fichier, ajoutée de <parameter>offset</parameter>. - </member> + <constant>SEEK_END</constant> - La position finale vaut la position courante + par rapport à la fin du fichier, ajoutée de + <parameter>offset</parameter>. + </member> </simplelist> </para> <para> Si <parameter>whence</parameter> n'est pas spécifiée, il - vaut par défaut SEEK_SET. + vaut par défaut <constant>SEEK_SET</constant>. </para> <para> - <function>fseek</function> retourne &true; en cas de + <function>fseek</function> retourne 0 en cas de succès, et sinon -1. Notez que positionner le pointeur au delà de la fin du fichier n'est pas une erreur. </para> @@ -47,6 +50,11 @@ <function>fseek</function> ne peut pas être utilisé sur les pointeurs retournés par <function>fopen</function> s'ils sont au format HTTP ou FTP. </para> + <note> + <para> + Le paramètre <parameter>whence</parameter> a été ajouté 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ît le pointeur <parameter>fp</parameter>. <function>fstat</function> + connaît le pointeur <parameter>handle</parameter>. <function>fstat</function> est similaire à la fonction <function>stat</function>, hormis le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier. </para> <para> <function>fstat</function> retourne un tableau avec les éléments suivants : <itemizedlist> - <listitem><simpara>1 : volume </simpara></listitem> - <listitem><simpara>2 : inode</simpara></listitem> - <listitem><simpara>3 : mode de protection du inode </simpara></listitem> - <listitem><simpara>4 : nombre de liens </simpara></listitem> - <listitem><simpara>5 : id de l'utilisateur propriétaire </simpara></listitem> - <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>7 : type du volume de l'inode * </simpara></listitem> - <listitem><simpara>8 : taille en octets </simpara></listitem> - <listitem><simpara>9 : date du dernier accès </simpara></listitem> - <listitem><simpara>10 : date de la dernière modification </simpara></listitem> - <listitem><simpara>11 : date du dernier changement </simpara></listitem> - <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> - <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> + <listitem><simpara>volume </simpara></listitem> + <listitem><simpara>inode</simpara></listitem> + <listitem><simpara>nombre de liens </simpara></listitem> + <listitem><simpara>id de l'utilisateur propriétaire </simpara></listitem> + <listitem><simpara>id du groupe proprié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ès </simpara></listitem> + <listitem><simpara>date de la dernière modification </simpara></listitem> + <listitem><simpara>date du dernier changement </simpara></listitem> + <listitem><simpara>taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> + <listitem><simpara>nombre de blocs alloués</simpara></listitem> </itemizedlist> * - uniquement sur les systèmes qui supportent le type st_blksize. Les autres systèmes (i.e. Windows) retournent -1. </para> - <para> - Les résultats de <function>fstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> + ¬e.clearstatcache; + + ¬e.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éré par le pointeur <parameter>fp</parameter>, i.e., - son offset. + fichier repéré 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 à la taille de - <parameter>size</parameter>.<function>ftruncate</function> retourne - &true; en cas de succès, et - &false; sinon. + <parameter>handle</parameter> et le tronque à 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> écrit le contenu de la chaîne <parameter>string</parameter> dans le fichier pointé par - <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> + <parameter>handle</parameter>. Si la longueur <parameter>length</parameter> est fournie, l'écriture s'arrêtera après <parameter>length</parameter> octets, ou à la fin de la chaîne (le premier des deux). @@ -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èmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - S'il n'est pas nécessaire, il sera ignoré. + Sur les systèmes qui font la différence entre les fichiers binaires + et les fichiers textes (par exemple, Windows), le fichier doit être ouvert + avec l'option 'b' inclus dans le paramètre de mode de + <function>fopen</function>. </para> </note> + <para> + <example> + <title>Exemple d'écriture dans un fichier avec <function>fwrite</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = 'test.txt'; +$somecontent = "Ajout de chaîne dans le fichier \n"; + +// Assurons nous que le fichier est accessible en écriture +if (is_writable($filename)) { + + // Dans notre exemple, nous ouvrons le fichier $filename en mode d'ajout + // Le pointeur de fichier est placé à la fin du fichier + // c'est là que $somecontent sera placé + 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'écrire dans le fichier ($filename)"; + exit; + } + + print "L'écriture de ($somecontent) dans le fichier ($filename) a réussi"; + + fclose($handle); + +} else { + print "Le fichier $filename n'est pas accessible en é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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + + ¬e.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écutable.</refpurpose> + <refpurpose>Indique si le fichier est exé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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.no-windows; + ¬e.clearstatcache; + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + ¬e.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é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ésultat de <function>is_readable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_readable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> + ¬e.clearstatcache; + ¬e.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évélent leur contenu à l'utilisateur, ou même aux utilisateurs du même système. </para> + <para> + <function>is_uploaded_file</function> est disponible dans les + versions de &php; 3 après PHP 3.0.16, et dans les versions de &php; 4 + après la 4.0.2. Si vous êtes coincés avec une version plus ancienne, + vous pouvez utiliser l'une des fonctions suivantes pour + vous protéger : + <note> + <para> + L'exemple suivant <emphasis>ne fonctionne pas</emphasis> avec + les versions de &php; ultérieures à la 4.0.2. Elle dépend + de fonctionnalités internes de &php; qui ont disparu après + cette version. + </para> + </note> + <programlisting role="php"> +<![CDATA[ +<?php +/* Test utilisateur du fichier téléchargé. */ +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é 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é"); +} 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é en écriture.</refpurpose> + <refpurpose>Indique si un fichier est autorisé en é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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>is_writable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + ¬e.clearstatcache; + ¬e.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é en écriture.</refpurpose> + <refpurpose>Indique si un fichier est autorisé en é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ée un lien.</refpurpose> + <refpurpose>Crée un lien</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -16,6 +16,7 @@ <para> <function>link</function> crée un lien. </para> + ¬e.no-remote; <para> Voir aussi <function>symlink</function> pour cré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 à propos d'un lien.</refpurpose> + <refpurpose>Renvoie les informations à 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èmes qui supportent le type st_blksize. Les autres systèmes (i.e. Windows) retournent -1. </para> - <para> - Les résultats de <function>lstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> + ¬e.no-remote; + ¬e.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ée un dossier.</refpurpose> + <refpurpose>Cré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é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é par le umask courant, que vous pouvez modifier avec la fonction <function>umask</function>. - <informalexample> + </para> + <para> + <note> + <para> + Le paramètre <parameter>mode</parameter> est ignoré sous Windows, + et il est devenu optionnel depuis &php; 4.2.0. + </para> + </note> + </para> + <para> + Le mode par défaut est le mode 0777, ce qui correspond au maximum de + droits possible. Pour plus d'informations sur les modes, lisez en + détail la documentation de la fonction <function>chmod</function>. + <example> + <title>Exemple avec <function>mkdir</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mkdir ("/chemin/de/mon/dossier", 0700); -?> +?> +]]> </programlisting> - </informalexample> + </example> </para> <para> - <function>mkdir</function> retourne &true; en cas de - succès, et &false; en cas d'é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éplace un fichier téléchargé.</refpurpose> + <refpurpose>Déplace un fichier téléchargé</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 à partir - des versions PHP 3.0.16 et 4.0.2. - </para> - <para> <function>move_uploaded_file</function> s'assure que le fichier <parameter>filename</parameter> est un fichier téléchargé par HTTP POST. Si le fichier est valide, il est déplacé @@ -40,9 +36,23 @@ révèlent leur contenu à l'utilisateur, ou même aux utilisateurs du même système. </para> + ¬e.sm.uidcheck; + <note> + <para> + <function>move_uploaded_file</function> n'est pas affectée par les + restrictictions du &safemode;. Ce n'est pas un problème, car + <function>move_uploaded_file</function> ne fonctionne que sur des fichiers + qui ont été téléchargés avec &php;. + </para> + </note> + <warning> + <para> + Si le fichier de destination existe déjà, il sera écrasé. + </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éjà était + &php.ini;. Ce dernier a déjà était traité lorsque vous commencez a exé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 - à celle de <filename>php.ini</filename>. + à celle de &php.ini;. </para> + <note> + <para> + Si une valeur du fichier .ini contient des données non alphanumérique, + il faut la protéger en la plaçant entre guillemets doubles ("). + </para> + </note> + <note> + <simpara> + Depuis &php; 4.2.1 cette fonction est aussi affectée par + le &safemode; et <link linkend="ini.open-basedir">open_basedir</link>. + </simpara> + </note> + <para> + La strucute du fichier .ini est similaire à celle du + fichier &php.ini;. + </para> + <para> + Les <link linkend="language.constants">constantes</link> peuvent aussi + être utilisées dans le fichier .ini, ce qui fait que si vous définissez + une constante avant d'exécuter <function>parse_ini_file</function>, elle + sera intégrée dans les résultats. Seules les valeurs de configuration + sont remplacées par leur é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> -<?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); -?> + +?> +]]> </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"> -<?php - $path_parts = pathinfo("/www/htdocs/index.html"); - echo $path_parts["dirname"] . "\n"; - echo $path_parts["basename"] . "\n"; - echo $path_parts["extension"] . "\n"; -?> +<![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édé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ée un processus de pointeur de fichier.</refpurpose> + <refpurpose>Cré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"> -<?php - $fp = popen("/bin/ls", "r"); -?> +<![CDATA[ +<?php + $handle = popen ("/bin/ls", "r"); +?> +]]> </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>pclose</function>. + </example> </para> + <note> + <para> + Si la commande à exécuter n'a pu être trouvée, une ressource + valide sera retournée. Cela semble étrange, mais c'est pratique : + cela vous permet d'accéder aux messages d'erreurs qui ont été + retourné 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 à la sortie standard. + l'envoie à 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 - à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur - spécifié, et le texte de la réponse sera affiché - sur la sortie standard. - </para> - <simpara> - Les versions antérieures à PHP 4.0.6, ne gère pas les redirections automatiques, - ce qui oblige à ajouter les slash finaux "/" pour indiquer un dossier. - </simpara> - <para> - Si <parameter>filename</parameter> commence par "ftp://" (insensible - à la casse), une connexion FTP est ouverte avec l'hôte - spécifié et la réponse du serveur est affichée. - Si le serveur ne supporte les connexions passives, la requête - échouera. - </para> - <para> - Si <parameter>filename</parameter> ne commence par aucun des cas - précédents, le fichier sera ouvert sur l'hôte - local, et envoyé à la sortie standard. + Si une erreur survient, retourne &false;, et à moins que la fonction n'ait + été appelée avec @readfile, un message d'erreur est affiché. </para> + &tip.fopen-wrapper; <para> Vous pouvez utiliser le deuxième paramè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"> -<?php - $real_path = realpath("../../index.php"); -?> +<![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è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ébut.</refpurpose> + <refpurpose>Replace le pointeur de fichier au dé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ébut. + <parameter>handle</parameter> au début. </para> <para> Si une erreur survient, retourne &false;. @@ -23,6 +23,13 @@ Le pointeur de fichier doit être valide, et avoir été correctement ouvert par <function>fopen</function>. </para> + <note> + <para> + Si vous avez ouvert le fichier en mode d'ajout ("a"), toutes les données + que vous écrirez dans ce fichier seront toujours ajoutées, indé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é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'écriture de fichier avec <function>fwrite</function> utilise normalement - un buffer de 8K. Cela signifie que si deux processus essaient d'écrire - dans le même fichier, ils font une pause tous les 8ko pour laisser le temps - à l'autre d'écrire à son tour. - <function>set_file_buffer</function> permet de modifier la taille du buffer de - sortie pour le pointeur de fichier <parameter>fp</parameter> à - <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, - l'écriture se fera sans buffer. Cela force un processus à écrire - toutes ses données dans un fichier avant que les autres puissent y accéder. - </simpara> - <simpara> - <function>set_file_buffer</function> retourne 0 en cas de succès, ou - EOF si la requête ne peut pas être honorée. - </simpara> - <para> - L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour créer un fichier - sans buffer. - <example> - <title>Exemple avec <function>set_file_buffer</function></title> - <programlisting role="php"> -<?php - $fp=fopen($file, "w"); - if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); - } -?> - </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 à propos d'un fichier.</refpurpose> + <refpurpose>Renvoie les informations à 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ère pas les URL comme peut le - faire <function>fopen</function>. - </para> - <para> - Les résultats de <function>stat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> pour - plus de détails. - </para> + ¬e.clearstatcache; + ¬e.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ée un lien symbolique.</refpurpose> + <refpurpose>Cré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ée un fichier avec un nom unique.</refpurpose> + <refpurpose>Cré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"> -<?php - $tmpfname = tempnam("/tmp", "FOO"); -?> +<![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 été modifié en + &php; 4.0.3. Le fichier temporaire est aussi + créé pour éviter des conflits si le fichier apparait dans le système + de fichiers entre le moment où la chaîne est générée et avant que le + script n'ai terminé la cé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ée un fichier temporaire avec un nom unique, ouvert en é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 à un fichier. - </refpurpose> + <refpurpose>Modifie la date de modification et de dernièr accè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é <parameter>filename</parameter> à la date de @@ -25,16 +24,23 @@ Si le fichier n'existe pas, il est créé. </para> <para> - <function>touch</function> retourne &true; en cas de succè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 été fixée à maintenant"; + print "La date de modification de $NomDeFichier a + été fixée à maintenant"; } else { - print "Désolé, il est impossible de changer la date de modification de $NomDeFichier"; + print "Désolé, 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 & 0777 et retourne le vieux umask. Lorsque PHP est utilisé 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î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 à appeler successivement <function>fopen</function>, <function>fwrite</function>, et <function>fclose</function>. </simpara> <simpara> Le paramè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 être utilisé avec prudence. </simpara> ¬e.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ère un fichier à 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érifie si la chaîne <parameter>string</parameter> va passer le masque shell <parameter>pattern</parameter>. </para> <para> C'est tout particulièrement pratique pour les noms de fichiers, et il peut être utilisé sur des chaînes de caractères. L'utilisateur moyen de shell peut être familier avec les masques shell, ou tout au moins, leur expression les plus simples, comme <literal>'?'</literal> et <literal>'*'</literal>. De cette façon, utiliser <function>fnmatch</function> au lieu de <function>ereg</function> ou <function>preg_match</function> pour des recherches peut être plus pratique pour les non-initiés. </para> <example> <title>Vé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é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é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érifient le masque <parameter>pattern</parameter>, en suivant les règles du shell. Aucun remlacement de tilde ~ ou de paramètre n'est fait. </para> <para> <function>glob</function> retourne un tableau contenant les chemins et fichiers trouvé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ésultat du script ci-dessus pourrait être : </para> <screen> funclist.txt occupe 44686 octets funcsummary.txt occupe 267625 octets quickref.txt occupe 137820 octets </screen> </example> ¬e.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é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/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è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"> -<?php - $path = "/home/httpd/html/index.php3"; - $file = basename($path); - // $file est affecté avec "index.php3" -?> +<![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 été ajouté 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é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étaire - du fichier. Seul le super-utilisateur (root) peut changer le groupe + <function>chgrp</function> essaie de remplacer le groupe propriétaire + courant du fichier <parameter>filename</parameter> par <parameter>group</parameter>. + Seul le super-utilisateur (root) peut changer le groupe propriétaire d'un fichier arbitrairement. Les utilisateurs - classiques ne peuvent changer - le groupe propriétaire d'un fichier que si l'utilisateur - propriétaire du fichier est membre du groupe. + classiques ne peuvent changer le groupe propriétaire d'un + fichier que si l'utilisateur propriétaire du fichier est + membre du groupe. </para> <para> - <function>chgrp</function> renvoie &true; en - cas de succè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éré comme un nombre en notation octale. Afin de vous en assurer, vous pouvez préfixer cette valeur par un zéro (<parameter>mode</parameter>): - <informalexample> + <example> + <title>Comment utiliser <function>chmod</function></title> <programlisting role="php"> -<?php - chmod( "/somedir/somefile", 755 ); -// notation décimale; probablement <literal>FALSE</literal> - chmod( "/somedir/somefile", 0755 ); -// notation octale; valeur du mode correcte -?> +<![CDATA[ +chmod ("/somedir/somefile", 755); +// notation décimale : probablement faux +chmod ("/somedir/somefile", "u+rwx,go+rx"); +// chaîne : incorrect +chmod ("/somedir/somefile", 0755); +// notation octale : valeur du mode correcte +]]> </programlisting> - </informalexample> + </example> </para> + <para> + Le paramètre <parameter>mode</parameter> est constitué de trois + valeurs octacles qui spécifient les droits pour le propriétaire, + le group du propriétaire et les autres, respectivement. Chaque + composant peut être calculé en ajoutant les droits désirés. + Le chiffre 1 donne les droits d'éxécution, le chiffre 2 les droits + d'écriture et le chiffre 4 les droits de lecture. Ajoutez simplement + ces nombres pour spécifier les droits voulus. Vous pouvez aussi + lire le manuel des systèmes Unix avec 'man 1 chmod' et 'man 2 chmod'. + <informalexample> + <programlisting role="php"> +<![CDATA[ +// Lecture et écriture pour le propriétaire, rien pour les autres +chmod ("/un_dossier/un_fichier", 0600); + +// Lecture et écriture pour le propriétaire, écriture pour les autres +chmod ("/un_dossier/un_fichier", 0644); + +// Tous pour le propriétaire, lecture et écriture pour les autres +chmod ("/un_dossier/un_fichier", 0755); + +// Tout pour le propriétaire, lecture exé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é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ès, &false; sinon. + &return.success; </para> + ¬e.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étaire du fichier.</refpurpose> + <refpurpose>Change le groupe proprié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ès, "&false;" sinon. - <note> - <simpara> - Sous Windows, <function>chown</function> ne fait rien et - retourne &true;. - </simpara> - </note> + &return.success; </para> + ¬e.no-remote; <para> Voir aussi - <function>chown</function> et <function>chmod</function>. </para> - <note> - <simpara> - <function>chown</function> est inopérante sous Windows. - </simpara> - </note> </refsect1> </refentry> 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è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éussi...<br>\n"); -} +<![CDATA[ +<?php + if (!copy($file, $file.'.bak')) { + print("La copie du fichier $file n'a pas réussi...<BR>\n"); + } +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>rename</function>. - </para> + <note> + <para> + Depuis &php; 4.3.0, les deux paramètres <parameter>source</parameter> et + <parameter>dest</parameter> peuvent être des URL si les gestionnaires + d'URL ont été activés ("fopen wrappers"). Voyez la fonction + <function>fopen</function> pour plus de détails. + Si <parameter>dest</parameter> est une URL, la copie peut échouer si + ce protocole ne supporte pas l'écrasement de fichiers existants. + </para> + </note> + <warning> + <para> + Si le fichier de destination <parameter>dest</parameter> existe déjà, + il sera écrasé. + </para> + </warning> + <para> + Voir aussi + <function>move_uploaded_file</function>, + <function>rename</function> et + la section sur les <link linkend="features.file-upload">télé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"> -<?php +<![CDATA[ +<?php $path = "/etc/passwd"; - $file = dirname($path); // $file contient "/etc" -?> + $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 été modifié pour être + compatible POSIX. Cela signifie notamment que si il n'y a pas + de slash dans le paramètre <parameter>path</parameter>, un + point ('<literal>.</literal>') est retourné, indiquant le + dossier courant. Sinon, la chaîne retournée est + <parameter>path</parameter> avec le composant final + <literal>/composant</literal> supprimé. Notez que cela signifie + que vous allez obtenir un slash ou un point là ou l'ancien + comportement de <function>dirname</function> retournait une + chaî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"> -<?php +<![CDATA[ +<?php $df = disk_free_space("/"); // $df contient le nombre d'octets libres sur "/" -?> +?> +]]> </programlisting> </example> </para> + ¬e.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"> -<?php +<![CDATA[ +<?php $df = disk_total_space("/"); // $df contient le nombre d'octets libres - // dans le dossier "/" -?> + // dans le dossier "/" +?> +]]> </programlisting> </example> </para> - ¬e.sm.uidcheck; + ¬e.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ès, - et &false; en cas d'échec. + &return.success; </para> <para> Le pointeur de fichier doit être valide et doit avoir été 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 à la fin du fichier, ou si + <parameter>handle</parameter> est à 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'écriture de toutes les données bufferisées dans le fichier désigné - par <parameter>fp</parameter>. <function>fflush</function> retourne + par <parameter>handle</parameter>. <function>fflush</function> retourne &true; en cas de succè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 à <function>fgets</function> mais <function>fgetcsv</function> + <function>fgetcsv</function> est identique à + <function>fgets</function> mais <function>fgetcsv</function> analyse la ligne qu'il lit et recherche les champs CSV, qu'il va retourner dans un tableau les contenant. Le délimiteur de champs <parameter>delimiter</parameter> est la virgule, à moins que vous ne fournissiez un troisième argument. </simpara> + <note> + <simpara> + Le paramètre <parameter>enclosure</parameter> a été ajouté en PHP 4.3.0. + </simpara> + </note> <simpara> - <parameter>fp</parameter> doit être un pointeur valide, et avoir + <parameter>handle</parameter> doit être un pointeur valide, et avoir été 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ée dans le - tableau comme une chaîne vide, et ne sera pas traitée comme - une erreur. - </simpara> + <note> + <simpara> + Une ligne vide dans un fichier CSV sera retournée sous la + forme d'un tableau contenant la valeur &null; et ne sera pas traité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"> -<?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 "<p> $num champs dans la ligne $row: <br>"; + print "<p> $num champs dans la ligne $row: <br>\n"; $row++; - for ($c=0; $c<$num; $c++) { - print $data[$c] . "<br>"; + for ($c=0; $c < $num; $c++) { + print $data[$c] . "<br>\n"; } - } - fclose ($fp); -?> +} +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îne lue jusqu'à 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 être valide, et avoir été + <parameter>handle</parameter> doit être valide, et avoir été 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"> -<?php +<![CDATA[ +<?php $fd = fopen ("/tmp/inputfile.txt", "r"); - while (!feof($fd)) { + while (!feof ($fd)) { $buffer = fgets($fd, 4096); echo $buffer; } fclose ($fd); -?> +?> +]]> </programlisting> </example> </para> - <para> - Voir aussi - <function>fread</function>, - <function>fopen</function>, - <function>popen</function>, - <function>fgetc</function>, - <function>fsockopen</function> et - <function>socket_set_timeout</function>. - </para> + <note> + <simpara> + Le paramètre <parameter>length</parameter> est devenu optionnel depuis + &php; 4.2.0. Si il est omis, il prend la valeur par défaut de 1024. + Depuis &php; 4.3.0, omettre le paramètre <parameter>length</parameter> fait + que la fonction va continuer à lire le flôt jusqu'à ce que la ligne + s'achèbe. Si la majorité des lignes du fichier dépassent les 8 ko, + il est plus efficace pour votre script de spécifier ce paramètre. + </simpara> + </note> + <note> + <simpara> + <function>fgets</function> est compatible avec les données binaires depuis + &php; 4.3. Les versions plus anciennes ne le sont pas. + </simpara> + </note> + ¬e.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 à <function>fgets</function>, mais <function>fgetss</function> + <function>fgetss</function> est identique à <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ème paramètre, optionnel. <note> <para> - <parameter>allowable_tags</parameter> a été ajouté dans - PHP 3.0.13, PHP 4B3. + <parameter>allowable_tags</parameter> a été ajouté en + PHP 3.0.13 et PHP 4.0.0. </para> </note> </para> + ¬e.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érifie si un fichier existe.</refpurpose> + <refpurpose>Vé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 à <function>clearstatcache</function> pour plus de détails. </simpara> + <note> + <title>Utilisation des dossiers partagés Windows</title> + <para> + Sous Windows, utilisez le format de chemin + <filename>//computername/share/filename</filename> ou + <filename>\\\\computername\share\filename</filename> pour vérifier qu'un + fichier est disponible sur le partage ré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> + ¬e.clearstatcache; + + ¬e.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î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 à la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une chaîne. </para> <note> <para> Cette fonction a été introduite en PHP 4.3.0. </para> </note> ¬e.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î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 à la fonction <function>readfile</function>, hormis le fait que <function>file_get_contents</function> retourne le fichier <parameter>filename</parameter> dans une chaîne. </para> <note> <para> Cette fonction a été introduite en PHP 4.3.0. </para> </note> ¬e.bin-safe; &tip.fopen-wrapper; <note> <simpara> Le support de l'argument <parameter>context</parameter> sera ajouté 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ésultat dans un tableau. + Lit le fichier et renvoie le ré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 à <function>readfile</function>, hormis le fait que + <function>file</function> est identique à <function>readfile</function>, + hormis le fait que <function>file</function> retourne le fichier dans un tableau. Chaque élément du tableau correspond à une ligne du fichier, et les retour-chariots sont placés en fin de ligne. </para> + <note> + <para> + Chaque élément du tableau résultat contiendra la nouvelle ligne de fin de chaîne. + Il faudra donc utiliser <function>trim</function> sur cette valeur + pour le supprimer. + </para> + </note> + ¬e.line-endings; <para> Vous pouvez utiliser l'option <parameter>use_include_path</parameter> : en la mettant à "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"> -<?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 "<B>Ligne $numero_ligne:</B> ".htmlspecialchars( $ligne ) . "<br>\n"; - } -// lire une page web dans une chaîne - $fcontents = join( '', file( 'http://www.php.net' ) ); -?> +<![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é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î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îne. + </para> + <para> + En PHP 4.3.0 <function>file</function> est désormais compatible avec les donné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 à <function>clearstatcache</function> pour plus de détails. </simpara> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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érante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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éro d'inode du fichier.</refpurpose> + <refpurpose>Renvoie le numéro d'inode du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -32,6 +32,9 @@ <function>fileinode</function> est inopérante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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é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 été modifié le : December 29 2002 22:16:23. + +$filename = 'lefichier.txt'; +if (file_exists($filename)) { + echo "$filename a été modifié le : " . date ("F d Y H:i:s.", filemtime($filename)); +} +?> +]]> + </programlisting> + </example> + </para> + ¬e.clearstatcache; + + ¬e.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étaire du fichier.</refpurpose> + <refpurpose>Renvoie le nom du propriétaire du fichier</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -34,6 +34,9 @@ <function>fileowner</function> est inopérante sous Windows. </simpara> </note> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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 à <function>clearstatcache</function> pour plus de détails. </para> + ¬e.clearstatcache; + + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> - <para> - Le résultat de <function>filetype</function> est mis en cache. - Reportez-vous à <function>clearstatcache</function> pour plus de - détails. - </para> + ¬e.clearstatcache; + + ¬e.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>&wouldblock</parameter></methodparam> + </methodsynopsis> <simpara> PHP dispose d'un système complet de verrouillage de fichiers. Tous les programmes qui accèdent au fichier doivent utiliser la même méthode de verrouillage pour qu'il soit efficace. </simpara> <simpara> - <function>flock</function> agit sur le fichier <parameter>fp</parameter> + <function>flock</function> agit sur le fichier <parameter>handle</parameter> qui doit avoir été ouvert au pré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 (écriture), - <parameter>operation</parameter> = 2. - </simpara> + Acquisition d'un verrou exclusif en é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ération d'un verrou (partagé ou exclusif), - <parameter>operation</parameter> = 3. + Libération d'un verrou partagé 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 à <parameter>operation</parameter>. + le verrouillage, ajoutez <constant>LOCK_NB</constant> à + <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éaliser un système simple de verrous écriture / lecture, qui peut être utilisé sur - n'importe quelle plate-forme (Unix et Windows compris). + n'importe quelle plate-forme (Unix et Windows compris). Le troisième + paramètre optionnel vaut par défaut &true;, si le verrou doit bloquer le + script (condition d'erreur EWOULDBLOCK). </simpara> <simpara> - <function>flock</function> retourne &true; en cas - de succès, et &false; - sinon. (le verrou n'a pas pu être obtenu). + &return.success; </simpara> - <warning> - <para> - Sur la plupart des OS, <function>flock</function> est implémenté - au niveau processus. Lors de l'utilisation des API d'un serveur multi-thread, - comme ISAPI, vous ne pouvez pas vous fier à <function>flock</function> - pour protéger vos fichiers contre des accès concurrents du - même serveur. - </para> - </warning> + <note> + <para> + Comme <function>flock</function> requiert un pointeur de fichier, vous + aurez peut être à utiliser un verrou spécial pour protéger l'accès au fichier + que vous voulez tronquer en l'ouvrant en mode d'é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èmes de fichiers réseaux. Vérifiez la documentation de votre + système d'exploitation pour plus de détails. + </para> + <para> + Sur certains systèmes d'exploitation, <function>flock</function> est implémenté + 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éger vos fichiers contre d'autres scripts &php; qui fonctionnent + en paralelle sur d'autres thread du même serveur. + </para> + <para> + <function>flock</function> n'est pas supporté sur les vieux systèmes de fichiers + comme <literal>FAT</literal> et ses dérivés, et elle retournera forcément + &false; sous ces environnement (ceci est particuliè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 à - la casse), une connexion HTTP 1.x est ouverte avec le serveur - spécifié, et un pointeur sur la réponse fournie est - retourné. Une en-tête '<literal>Host:</literal>' est envoyé avec la - requête, afin de gérer les virtual hosts basé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ée une ressource nommée, spécifiée par le + paramètre <parameter>filename</parameter>, sous la forme d'un flôt. + Si <parameter>filename</parameter> est de la forme "protocole://...", + <parameter>filename</parameter> est supposé être une URL, et &php; va + rechercher un gestionnaire de protocole adapté pour lire ce fichier. + Si aucun gestionnaire pour ce protocole n'est disponible, &php; va émettre + une alerte qui vous permettra de savoir que vous avez des problè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é représente le corps de la - réponse, et qu'il n'est pas possible d'accéder aux en-têtes HTTP - avec cette fonction. - </simpara> - <simpara> - Les versions antérieures à PHP 4.0.6, ne gère pas les - redirections automatiques, ce qui oblige à ajouter les slash finaux - "/" pour indiquer un dossier. - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "ftp://" (insensible à - la casse), une connexion FTP est ouverte avec le serveur spécifié, - et un pointeur sur la réponse fournie est retourné. Si le serveur - ne supporte par le mode FTP passif, <function>fopen</function> échouera. - Vous pouvez ouvrir des fichiers en lecture seulement, ou en écriture - seulement (le full duplex n'est pas supporté). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par "php://stdin", "php://stdout", - ou "php://stderr", le flot correspondant sera ouvert. (Cela a été - introduit en PHP 3.0.13; dans les anciennes versions, les fichiers "/dev/stdin" - ou "/dev/fd/0" devaient être utilisés pour accéder à - ces flots). - </simpara> - <simpara> - Si <parameter>filename</parameter> commence par n'importe quoi d'autre, PHP - tentera de lire ce fichier dans le système local, et un pointeur sur - le fichier ouvert sera retourné. - </simpara> - <simpara> - Si l'ouverture échoue, <function>fopen</function> retourne - &false;. - </simpara> + Si &php; décide que le fichier <parameter>filename</parameter> est un fichier + local, il va essayer d'ouvrir un flôt avec ce fichier. Le fichier doit être + accessible à &php;. Il vous faut donc vous assurer que vous avez les + droits d'accès à ce fichier. Si vous activé 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écidé que <parameter>filename</parameter> spécifie + un protocole enregistré, et que ce protocole est enregistré comme + un protocole réseau, &php; s'assurera que la directive + <link linkend="ini.allow-url-fopen">allow_url_fopen</link> est activée. + Si elle est inactive, &php; va émettre une alerte, et l'ouverte + va échouer. + </simpara> + <note> + <simpara> + La liste des protocoles supporté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 à 1. </para> <para> + Le paramètre optionnel <parameter>zcontext</parameter> est utilisé pour + spécifier des paramètres d'optimisation et de callback. + </para> + <simpara> + Si l'ouverture échoue, <function>fopen</function> retournera &false;. + </simpara> + <para> <example> <title>Exemple avec <function>fopen</function></title> <programlisting role="php"> -<?php - $fp = fopen("/home/rasmus/file.txt", "r"); - $fp = fopen("http://www.php.net/", "r"); - $fp = fopen("ftp://user:password@example.com/", "w"); -?> +<![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 échapper les anti-slash utilisé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"> -<?php - $fp = fopen("c:\\data\\info.txt", "r"); -?> +<![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ée aprè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'à la fin, et dirige le ré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ères + lu dans <parameter>handle</parameter> et passé à la sortie standard. </simpara> <simpara> Le pointeur de fichier doit être valide, et doit avoir été correctement ouvert par <function>fopen</function>, <function>popen</function>, ou <function>fsockopen</function>. Après lecture, <function>fpassthru</function> va fermer le fichier (le pointeur - <parameter>fp</parameter> sera alors invalide). - </simpara> - <simpara> - Si vous voulez simplement afficher le contenu d'un fichier, il - suffit d'utiliser <function>readfile</function>, ce qui épargnera - l'appel à <function>fopen</function>. + <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ès utilisé dans <function>fopen</function>. + </para> + <para> + Vous êtes encouragés à utiliser l'option <literal>b</literal> lorsque vous + traitez des fichiers binaires, même si votre système ne le requiert pas, + de façon à 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'à <parameter>length</parameter> - octets dans le fichier reférencé par <parameter>fp</parameter>. + octets dans le fichier reférencé par <parameter>handle</parameter>. La lecture s'arrête lorsque <parameter>length</parameter> octets ont été lus, ou que l'on a atteint la fin du fichier, ou qu'une erreur survient (le premier des trois). @@ -23,13 +23,15 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Lit un fichier, et le place dans une chaîne - $filename = "/usr/local/quelquechose.txt"; - $fd = fopen($filename, "r"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?> +$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"> -<?php +<![CDATA[ +<?php $filename = "c:\\fichiers\\uneimage.gif"; - $fd = fopen($filename, "rb"); - $contents = fread($fd, filesize ($filename)); - fclose($fd); -?> + $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 à <function>sscanf</function>, mais elle prend comme @@ -26,29 +26,49 @@ optionnels sont passés, la fonction retournera le nombre de valeurs assignées. Les options doivent être passées par référence. + </para> + <para> + Tous les caractères blancs de la chaîne de formattage correspondent + à autant d'espaces dans le flôt d'entrée. Cela signifie qu'une tabulation + <literal>\t</literal> dans la chaîne de format peut remplacer + un espace simple dans le flôt d'entrée. + </para> + <para> <example> - <title>Exemple <function>fscanf</function></title> + <title>Exemple avec <function>fscanf</function></title> <programlisting role="php"> -<?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ées } - fclose($fp); -?> - </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ères lus dans le fichier + était de 512 (ou bien jusqu'à la première nouvelle ligne "\n" : en fait, + le premier des deux). Depuis &php; 4.3.0, des lignes de n'importe quelle + taille peuvent ê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ée en octets à partir du début du fichier, est obtenue en additionnant la distance <parameter>offset</parameter> à la position <parameter>whence</parameter>. Ce paramètre peut prendre les valeurs suivantes : <simplelist> + <member> + <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ée à <parameter>offset</parameter> octets. </member> <member> - SEEK_CUR - La position finale vaut la position courante - ajoutée à <parameter>offset</parameter> octets. - </member> - <member> - SEEK_END - La position finale vaut la position courante par rapport à - la fin du fichier, ajoutée de <parameter>offset</parameter>. - </member> + <constant>SEEK_END</constant> - La position finale vaut la position courante + par rapport à la fin du fichier, ajoutée de + <parameter>offset</parameter>. + </member> </simplelist> </para> <para> Si <parameter>whence</parameter> n'est pas spécifiée, il - vaut par défaut SEEK_SET. + vaut par défaut <constant>SEEK_SET</constant>. </para> <para> - <function>fseek</function> retourne &true; en cas de + <function>fseek</function> retourne 0 en cas de succès, et sinon -1. Notez que positionner le pointeur au delà de la fin du fichier n'est pas une erreur. </para> @@ -47,6 +50,11 @@ <function>fseek</function> ne peut pas être utilisé sur les pointeurs retournés par <function>fopen</function> s'ils sont au format HTTP ou FTP. </para> + <note> + <para> + Le paramètre <parameter>whence</parameter> a été ajouté 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ît le pointeur <parameter>fp</parameter>. <function>fstat</function> + connaît le pointeur <parameter>handle</parameter>. <function>fstat</function> est similaire à la fonction <function>stat</function>, hormis le fait qu'elle utilise un pointeur de fichier, au lieu d'un nom de fichier. </para> <para> <function>fstat</function> retourne un tableau avec les éléments suivants : <itemizedlist> - <listitem><simpara>1 : volume </simpara></listitem> - <listitem><simpara>2 : inode</simpara></listitem> - <listitem><simpara>3 : mode de protection du inode </simpara></listitem> - <listitem><simpara>4 : nombre de liens </simpara></listitem> - <listitem><simpara>5 : id de l'utilisateur propriétaire </simpara></listitem> - <listitem><simpara>6 : id du groupe propriétaire</simpara></listitem> - <listitem><simpara>7 : type du volume de l'inode * </simpara></listitem> - <listitem><simpara>8 : taille en octets </simpara></listitem> - <listitem><simpara>9 : date du dernier accès </simpara></listitem> - <listitem><simpara>10 : date de la dernière modification </simpara></listitem> - <listitem><simpara>11 : date du dernier changement </simpara></listitem> - <listitem><simpara>12 : taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> - <listitem><simpara>13 : Nombre de blocs alloués</simpara></listitem> + <listitem><simpara>volume </simpara></listitem> + <listitem><simpara>inode</simpara></listitem> + <listitem><simpara>nombre de liens </simpara></listitem> + <listitem><simpara>id de l'utilisateur propriétaire </simpara></listitem> + <listitem><simpara>id du groupe proprié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ès </simpara></listitem> + <listitem><simpara>date de la dernière modification </simpara></listitem> + <listitem><simpara>date du dernier changement </simpara></listitem> + <listitem><simpara>taille de bloc du système pour les entrées/sorties(*)</simpara></listitem> + <listitem><simpara>nombre de blocs alloués</simpara></listitem> </itemizedlist> * - uniquement sur les systèmes qui supportent le type st_blksize. Les autres systèmes (i.e. Windows) retournent -1. </para> - <para> - Les résultats de <function>fstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> + ¬e.clearstatcache; + + ¬e.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éré par le pointeur <parameter>fp</parameter>, i.e., - son offset. + fichier repéré 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 à la taille de - <parameter>size</parameter>.<function>ftruncate</function> retourne - &true; en cas de succès, et - &false; sinon. + <parameter>handle</parameter> et le tronque à 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> écrit le contenu de la chaîne <parameter>string</parameter> dans le fichier pointé par - <parameter>fp</parameter>. Si la longueur <parameter>length</parameter> + <parameter>handle</parameter>. Si la longueur <parameter>length</parameter> est fournie, l'écriture s'arrêtera après <parameter>length</parameter> octets, ou à la fin de la chaîne (le premier des deux). @@ -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èmes qui font la différence entre - les fichiers binaires et les fichiers textes (en bref, c'est une - fonctionnalité Windows, totalement inutile sous Unix). - S'il n'est pas nécessaire, il sera ignoré. + Sur les systèmes qui font la différence entre les fichiers binaires + et les fichiers textes (par exemple, Windows), le fichier doit être ouvert + avec l'option 'b' inclus dans le paramètre de mode de + <function>fopen</function>. </para> </note> + <para> + <example> + <title>Exemple d'écriture dans un fichier avec <function>fwrite</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = 'test.txt'; +$somecontent = "Ajout de chaîne dans le fichier \n"; + +// Assurons nous que le fichier est accessible en écriture +if (is_writable($filename)) { + + // Dans notre exemple, nous ouvrons le fichier $filename en mode d'ajout + // Le pointeur de fichier est placé à la fin du fichier + // c'est là que $somecontent sera placé + 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'écrire dans le fichier ($filename)"; + exit; + } + + print "L'écriture de ($somecontent) dans le fichier ($filename) a réussi"; + + fclose($handle); + +} else { + print "Le fichier $filename n'est pas accessible en é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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + + ¬e.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écutable.</refpurpose> + <refpurpose>Indique si le fichier est exé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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.no-windows; + ¬e.clearstatcache; + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + ¬e.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 être accessibles par le système de fichier du serveur. </simpara> + ¬e.clearstatcache; + ¬e.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é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ésultat de <function>is_readable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> - <simpara> - <function>is_readable</function> ne fonctionne pas sur les - <link linkend="features.remote-files">fichiers distants</link>. - Les fichiers doivent être accessibles par le système de fichier - du serveur. - </simpara> + ¬e.clearstatcache; + ¬e.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évélent leur contenu à l'utilisateur, ou même aux utilisateurs du même système. </para> + <para> + <function>is_uploaded_file</function> est disponible dans les + versions de &php; 3 après PHP 3.0.16, et dans les versions de &php; 4 + après la 4.0.2. Si vous êtes coincés avec une version plus ancienne, + vous pouvez utiliser l'une des fonctions suivantes pour + vous protéger : + <note> + <para> + L'exemple suivant <emphasis>ne fonctionne pas</emphasis> avec + les versions de &php; ultérieures à la 4.0.2. Elle dépend + de fonctionnalités internes de &php; qui ont disparu après + cette version. + </para> + </note> + <programlisting role="php"> +<![CDATA[ +<?php +/* Test utilisateur du fichier téléchargé. */ +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é 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é"); +} 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é en écriture.</refpurpose> + <refpurpose>Indique si un fichier est autorisé en é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 être accessibles par le système de fichier - du serveur. - </simpara> - <para> - Le résultat de <function>is_writable</function> est mis en cache. - Voir la fonction <function>clearstatcache</function> pour plus de - détails. - </para> + ¬e.clearstatcache; + ¬e.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é en écriture.</refpurpose> + <refpurpose>Indique si un fichier est autorisé en é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ée un lien.</refpurpose> + <refpurpose>Crée un lien</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -16,6 +16,7 @@ <para> <function>link</function> crée un lien. </para> + ¬e.no-remote; <para> Voir aussi <function>symlink</function> pour cré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 à propos d'un lien.</refpurpose> + <refpurpose>Renvoie les informations à 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èmes qui supportent le type st_blksize. Les autres systèmes (i.e. Windows) retournent -1. </para> - <para> - Les résultats de <function>lstat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> - pour plus de détails. - </para> + ¬e.no-remote; + ¬e.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ée un dossier.</refpurpose> + <refpurpose>Cré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é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é par le umask courant, que vous pouvez modifier avec la fonction <function>umask</function>. - <informalexample> + </para> + <para> + <note> + <para> + Le paramètre <parameter>mode</parameter> est ignoré sous Windows, + et il est devenu optionnel depuis &php; 4.2.0. + </para> + </note> + </para> + <para> + Le mode par défaut est le mode 0777, ce qui correspond au maximum de + droits possible. Pour plus d'informations sur les modes, lisez en + détail la documentation de la fonction <function>chmod</function>. + <example> + <title>Exemple avec <function>mkdir</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mkdir ("/chemin/de/mon/dossier", 0700); -?> +?> +]]> </programlisting> - </informalexample> + </example> </para> <para> - <function>mkdir</function> retourne &true; en cas de - succès, et &false; en cas d'é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éplace un fichier téléchargé.</refpurpose> + <refpurpose>Déplace un fichier téléchargé</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 à partir - des versions PHP 3.0.16 et 4.0.2. - </para> - <para> <function>move_uploaded_file</function> s'assure que le fichier <parameter>filename</parameter> est un fichier téléchargé par HTTP POST. Si le fichier est valide, il est déplacé @@ -40,9 +36,23 @@ révèlent leur contenu à l'utilisateur, ou même aux utilisateurs du même système. </para> + ¬e.sm.uidcheck; + <note> + <para> + <function>move_uploaded_file</function> n'est pas affectée par les + restrictictions du &safemode;. Ce n'est pas un problème, car + <function>move_uploaded_file</function> ne fonctionne que sur des fichiers + qui ont été téléchargés avec &php;. + </para> + </note> + <warning> + <para> + Si le fichier de destination existe déjà, il sera écrasé. + </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éjà était + &php.ini;. Ce dernier a déjà était traité lorsque vous commencez a exé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 - à celle de <filename>php.ini</filename>. + à celle de &php.ini;. </para> + <note> + <para> + Si une valeur du fichier .ini contient des données non alphanumérique, + il faut la protéger en la plaçant entre guillemets doubles ("). + </para> + </note> + <note> + <simpara> + Depuis &php; 4.2.1 cette fonction est aussi affectée par + le &safemode; et <link linkend="ini.open-basedir">open_basedir</link>. + </simpara> + </note> + <para> + La strucute du fichier .ini est similaire à celle du + fichier &php.ini;. + </para> + <para> + Les <link linkend="language.constants">constantes</link> peuvent aussi + être utilisées dans le fichier .ini, ce qui fait que si vous définissez + une constante avant d'exécuter <function>parse_ini_file</function>, elle + sera intégrée dans les résultats. Seules les valeurs de configuration + sont remplacées par leur é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> -<?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); -?> + +?> +]]> </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"> -<?php - $path_parts = pathinfo("/www/htdocs/index.html"); - echo $path_parts["dirname"] . "\n"; - echo $path_parts["basename"] . "\n"; - echo $path_parts["extension"] . "\n"; -?> +<![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édé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ée un processus de pointeur de fichier.</refpurpose> + <refpurpose>Cré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"> -<?php - $fp = popen("/bin/ls", "r"); -?> +<![CDATA[ +<?php + $handle = popen ("/bin/ls", "r"); +?> +]]> </programlisting> - </informalexample> - </para> - <para> - Voir aussi - <function>pclose</function>. + </example> </para> + <note> + <para> + Si la commande à exécuter n'a pu être trouvée, une ressource + valide sera retournée. Cela semble étrange, mais c'est pratique : + cela vous permet d'accéder aux messages d'erreurs qui ont été + retourné 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 à la sortie standard. + l'envoie à 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 - à la casse), une connexion HTTP 1.0 sera ouverte avec le serveur - spécifié, et le texte de la réponse sera affiché - sur la sortie standard. - </para> - <simpara> - Les versions antérieures à PHP 4.0.6, ne gère pas les redirections automatiques, - ce qui oblige à ajouter les slash finaux "/" pour indiquer un dossier. - </simpara> - <para> - Si <parameter>filename</parameter> commence par "ftp://" (insensible - à la casse), une connexion FTP est ouverte avec l'hôte - spécifié et la réponse du serveur est affichée. - Si le serveur ne supporte les connexions passives, la requête - échouera. - </para> - <para> - Si <parameter>filename</parameter> ne commence par aucun des cas - précédents, le fichier sera ouvert sur l'hôte - local, et envoyé à la sortie standard. + Si une erreur survient, retourne &false;, et à moins que la fonction n'ait + été appelée avec @readfile, un message d'erreur est affiché. </para> + &tip.fopen-wrapper; <para> Vous pouvez utiliser le deuxième paramè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"> -<?php - $real_path = realpath("../../index.php"); -?> +<![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è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ébut.</refpurpose> + <refpurpose>Replace le pointeur de fichier au dé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ébut. + <parameter>handle</parameter> au début. </para> <para> Si une erreur survient, retourne &false;. @@ -23,6 +23,13 @@ Le pointeur de fichier doit être valide, et avoir été correctement ouvert par <function>fopen</function>. </para> + <note> + <para> + Si vous avez ouvert le fichier en mode d'ajout ("a"), toutes les données + que vous écrirez dans ce fichier seront toujours ajoutées, indé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é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'écriture de fichier avec <function>fwrite</function> utilise normalement - un buffer de 8K. Cela signifie que si deux processus essaient d'écrire - dans le même fichier, ils font une pause tous les 8ko pour laisser le temps - à l'autre d'écrire à son tour. - <function>set_file_buffer</function> permet de modifier la taille du buffer de - sortie pour le pointeur de fichier <parameter>fp</parameter> à - <parameter>buffer</parameter> octets. Si <parameter>buffer</parameter> vaut 0, - l'écriture se fera sans buffer. Cela force un processus à écrire - toutes ses données dans un fichier avant que les autres puissent y accéder. - </simpara> - <simpara> - <function>set_file_buffer</function> retourne 0 en cas de succès, ou - EOF si la requête ne peut pas être honorée. - </simpara> - <para> - L'exemple suivant montre comment utiliser la fonction - <function>set_file_buffer</function> pour créer un fichier - sans buffer. - <example> - <title>Exemple avec <function>set_file_buffer</function></title> - <programlisting role="php"> -<?php - $fp=fopen($file, "w"); - if($fp){ - set_file_buffer($fp, 0); - fputs($fp, $output); - fclose($fp); - } -?> - </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 à propos d'un fichier.</refpurpose> + <refpurpose>Renvoie les informations à 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ère pas les URL comme peut le - faire <function>fopen</function>. - </para> - <para> - Les résultats de <function>stat</function> sont mis en cache. - Reportez-vous à la fonction <function>clearstatcache</function> pour - plus de détails. - </para> + ¬e.clearstatcache; + ¬e.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ée un lien symbolique.</refpurpose> + <refpurpose>Cré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ée un fichier avec un nom unique.</refpurpose> + <refpurpose>Cré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"> -<?php - $tmpfname = tempnam("/tmp", "FOO"); -?> +<![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 été modifié en + &php; 4.0.3. Le fichier temporaire est aussi + créé pour éviter des conflits si le fichier apparait dans le système + de fichiers entre le moment où la chaîne est générée et avant que le + script n'ai terminé la cé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ée un fichier temporaire avec un nom unique, ouvert en é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 à un fichier. - </refpurpose> + <refpurpose>Modifie la date de modification et de dernièr accè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é <parameter>filename</parameter> à la date de @@ -25,16 +24,23 @@ Si le fichier n'existe pas, il est créé. </para> <para> - <function>touch</function> retourne &true; en cas de succè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 été fixée à maintenant"; + print "La date de modification de $NomDeFichier a + été fixée à maintenant"; } else { - print "Désolé, il est impossible de changer la date de modification de $NomDeFichier"; + print "Désolé, 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 & 0777 et retourne le vieux umask. Lorsque PHP est utilisé 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î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 à appeler successivement <function>fopen</function>, <function>fwrite</function>, et <function>fclose</function>. </simpara> <simpara> Le paramè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 être utilisé avec prudence. </simpara> ¬e.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ère un fichier à 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érifie si la chaîne <parameter>string</parameter> va passer le masque shell <parameter>pattern</parameter>. </para> <para> C'est tout particulièrement pratique pour les noms de fichiers, et il peut être utilisé sur des chaînes de caractères. L'utilisateur moyen de shell peut être familier avec les masques shell, ou tout au moins, leur expression les plus simples, comme <literal>'?'</literal> et <literal>'*'</literal>. De cette façon, utiliser <function>fnmatch</function> au lieu de <function>ereg</function> ou <function>preg_match</function> pour des recherches peut être plus pratique pour les non-initiés. </para> <example> <title>Vé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é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é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érifient le masque <parameter>pattern</parameter>, en suivant les règles du shell. Aucun remlacement de tilde ~ ou de paramètre n'est fait. </para> <para> <function>glob</function> retourne un tableau contenant les chemins et fichiers trouvé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ésultat du script ci-dessus pourrait être : </para> <screen> funclist.txt occupe 44686 octets funcsummary.txt occupe 267625 octets quickref.txt occupe 137820 octets </screen> </example> ¬e.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é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 -->