cvs: phpdoc-fr /reference/filesystem/functions basename.xml chgrp.xml chmod.xml chown.xml clearstatcache.xml copy.xml delete.xml dirname.xml
disk-free-space.xml disk-total-space.xml diskfreespace.xml fclose.xml feof.xml fflush.xml fgetc.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 fputcsv.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 lchgrp.xml lchown.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.x! ml symlink.xml tempnam.xml tmpfile.xml
touch.xml umask.xml unlink.xml

yannick Wed Feb 7 22:06:30 2007 UTC Modified files: /phpdoc-fr/reference/filesystem/functions basename.xml chgrp.xml chmod.xml chown.xml clearstatcache.xml copy.xml delete.xml dirname.xml disk-free-space.xml diskfreespace.xml disk-total-space.xml fclose.xml feof.xml fflush.xml fgetcsv.xml fgetc.xml fgetss.xml fgets.xml fileatime.xml filectime.xml file-exists.xml file-get-contents.xml filegroup.xml fileinode.xml filemtime.xml fileowner.xml fileperms.xml file-put-contents.xml filesize.xml filetype.xml file.xml flock.xml fnmatch.xml fopen.xml fpassthru.xml fputcsv.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 lchgrp.xml lchown.xml linkinfo.xml link.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 unlink.xml Log: sync with EN # WS, typo

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/basename.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/basename.xml diff -u phpdoc-fr/reference/filesystem/functions/basename.xml:1.12 phpdoc-fr/reference/filesystem/functions/basename.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/basename.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/basename.xml Wed Feb 7 22:06:29 2007 @@ -1,57 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.basename"> - <refnamediv> - <refname>basename</refname> - <refpurpose> - Sépare le nom du fichier et le nom du dossier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 <parameter>path</parameter>, - le chemin complet d'un fichier et en extrait le nom du fichier. - Si <parameter>suffix</parameter> est fourni, le suffixe sera aussi supprimé. - </para> - <para> - Sous Windows, les caractères (<literal>/</literal>) et anti-slash - (<literal>\</literal>) sont utilisés comme séparateurs de - dossier. Sous les autres OS, seul le caractère slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>basename</function></title> - <programlisting role="php"> + +<refentry id="function.basename"> + <refnamediv> + <refname>basename</refname> + <refpurpose> + Sépare le nom du fichier et le nom du dossier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 <parameter>path</parameter>, + le chemin complet d'un fichier et en extrait le nom du fichier. + Si <parameter>suffix</parameter> est fourni, le suffixe sera aussi supprimé. + </para> + <para> + Sous Windows, les caractères (<literal>/</literal>) et anti-slash + (<literal>\</literal>) sont utilisés comme séparateurs de + dossier. Sous les autres OS, seul le caractère slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>basename</function></title> + <programlisting role="php"> <![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" +$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> + </programlisting> + </example> + </para> + <note> + <para> + Le paramètre <parameter>suffix</parameter> a été ajouté en &php; 4.1.0. </para> - <note> - <para> - Le paramètre <parameter>suffix</parameter> a été ajouté en &php; 4.1.0. - </para> - </note> - <para> - Voir aussi - <function>dirname</function>. - </para> - </refsect1> - </refentry> + </note> + <para> + Voir aussi + <function>dirname</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -72,4 +73,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/chgrp.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/chgrp.xml diff -u phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.11 phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/chgrp.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/chgrp.xml Wed Feb 7 22:06:29 2007 @@ -1,40 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.chgrp"> - <refnamediv> - <refname>chgrp</refname> - <refpurpose>Change le groupe propriétaire d'un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>chgrp</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>group</parameter></methodparam> - </methodsynopsis> - <para> - <function>chgrp</function> essaie de 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. - </para> - <para> - &return.success; - </para> - &note.no-remote; - &note.sm.uidcheck; - <para> - Voir aussi - <function>chown</function> et - <function>chmod</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.chgrp"> + <refnamediv> + <refname>chgrp</refname> + <refpurpose>Change le groupe propriétaire d'un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>chgrp</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>mixed</type><parameter>group</parameter></methodparam> + </methodsynopsis> + <para> + <function>chgrp</function> essaie de 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. + </para> + <para> + &return.success; + </para> + &note.no-remote; + &note.sm.uidcheck; + <para> + Voir aussi + <function>chown</function> et + <function>chmod</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -55,4 +56,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/chmod.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/chmod.xml diff -u phpdoc-fr/reference/filesystem/functions/chmod.xml:1.16 phpdoc-fr/reference/filesystem/functions/chmod.xml:1.17 --- phpdoc-fr/reference/filesystem/functions/chmod.xml:1.16 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/chmod.xml Wed Feb 7 22:06:29 2007 @@ -1,55 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.chmod"> - <refnamediv> - <refname>chmod</refname> - <refpurpose>Change le mode du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>chmod</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - <function>chmod</function> remplace le mode du fichier - <parameter>filename</parameter> par le mode <parameter>mode</parameter>. - </para> - <para> - Il est à noter que le mode <parameter>mode</parameter> est - considéré comme un nombre en notation octale. Afin de - vous en assurer, vous pouvez préfixer cette valeur par un - zéro (<parameter>mode</parameter>): - <example> - <title>Comment utiliser <function>chmod</function></title> - <programlisting role="php"> + +<refentry id="function.chmod"> + <refnamediv> + <refname>chmod</refname> + <refpurpose>Change le mode du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>chmod</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + <function>chmod</function> remplace le mode du fichier + <parameter>filename</parameter> par le mode <parameter>mode</parameter>. + </para> + <para> + Il est à noter que le mode <parameter>mode</parameter> est + considéré comme un nombre en notation octale. Afin de + vous en assurer, vous pouvez préfixer cette valeur par un + zéro (<parameter>mode</parameter>): + <example> + <title>Comment utiliser <function>chmod</function></title> + <programlisting role="php"> <![CDATA[ -chmod ("/somedir/somefile", 755); +chmod ("/somedir/somefile", 755); // notation décimale : probablement faux chmod ("/somedir/somefile", "u+rwx,go+rx"); -// chaîne : incorrect -chmod ("/somedir/somefile", 0755); +// chaîne : incorrect +chmod ("/somedir/somefile", 0755); // notation octale : valeur du mode correcte ]]> - </programlisting> - </example> - </para> - <para> - Le paramètre <parameter>mode</parameter> est constitué de trois - valeurs octales qui spécifient les droits pour le propriétaire, - le groupe 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'exé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 <command>man 1 chmod</command> et - <command>man 2 chmod</command>. - <example> - <title>Comment utiliser le paramètre mode de <function>chmod</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <para> + Le paramètre <parameter>mode</parameter> est constitué de trois + valeurs octales qui spécifient les droits pour le propriétaire, + le groupe 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'exé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 <command>man 1 chmod</command> et + <command>man 2 chmod</command>. + <example> + <title>Comment utiliser le paramètre mode de <function>chmod</function></title> + <programlisting role="php"> <![CDATA[ // Lecture et écriture pour le propriétaire, rien pour les autres chmod ("/un_dossier/un_fichier", 0600); @@ -63,39 +64,39 @@ // Tout pour le propriétaire, lecture exécution pour le groupe, rien pour les autres chmod ("/un_dossier/un_fichier", 0750); ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> + <para> + <note> <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. - Le mode ne peut être modifié que par l'utilisateur à qui appartient le fichier - sur la plupart des systèmes. - </para> - </note> + 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. + Le mode ne peut être modifié que par l'utilisateur à qui appartient le fichier + sur la plupart des systèmes. </para> - <para> - &return.success; - </para> - <note> - <simpara> - Lorsque le &safemode; est activé, &php; vérifie si les fichiers et - dossiers que vous allez utiliser ont le même UID (propriétaire) que - le script qui est en cours d'exécution. De plus, vous ne pouvez pas - modifier les SUID, SGID et sticky bits. - </simpara> - </note> - &note.no-remote; - <para> - Voir aussi - <function>chown</function> et - <function>chgrp</function>. - </para> - </refsect1> - </refentry> + </note> + </para> + <para> + &return.success; + </para> + <note> + <simpara> + Lorsque le &safemode; est activé, &php; vérifie si les fichiers et + dossiers que vous allez utiliser ont le même UID (propriétaire) que + le script qui est en cours d'exécution. De plus, vous ne pouvez pas + modifier les SUID, SGID et sticky bits. + </simpara> + </note> + &note.no-remote; + <para> + Voir aussi + <function>chown</function> et + <function>chgrp</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -116,4 +117,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/chown.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/chown.xml diff -u phpdoc-fr/reference/filesystem/functions/chown.xml:1.11 phpdoc-fr/reference/filesystem/functions/chown.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/chown.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/chown.xml Wed Feb 7 22:06:29 2007 @@ -1,36 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.chown"> - <refnamediv> - <refname>chown</refname> - <refpurpose>Change le groupe propriétaire du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>chown</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>user</parameter></methodparam> - </methodsynopsis> - <para> - <function>chown</function> change le groupe propriétaire courant - du fichier <parameter>filename</parameter> en <parameter>user</parameter>. - Seul le super-utilisateur (root) peut changer arbitrairement - le propriétaire d'un fichier. - </para> - <para> - &return.success; - </para> - &note.no-remote; - &note.sm.uidcheck; - <para> - Voir aussi - <function>chmod</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.chown"> + <refnamediv> + <refname>chown</refname> + <refpurpose>Change le groupe propriétaire du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>chown</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>mixed</type><parameter>user</parameter></methodparam> + </methodsynopsis> + <para> + <function>chown</function> change le groupe propriétaire courant + du fichier <parameter>filename</parameter> en <parameter>user</parameter>. + Seul le super-utilisateur (root) peut changer arbitrairement + le propriétaire d'un fichier. + </para> + <para> + &return.success; + </para> + &note.no-remote; + &note.sm.uidcheck; + <para> + Voir aussi + <function>chmod</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +52,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/clearstatcache.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/clearstatcache.xml diff -u phpdoc-fr/reference/filesystem/functions/clearstatcache.xml:1.10 phpdoc-fr/reference/filesystem/functions/clearstatcache.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/clearstatcache.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/clearstatcache.xml Wed Feb 7 22:06:29 2007 @@ -1,68 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.clearstatcache"> - <refnamediv> - <refname>clearstatcache</refname> - <refpurpose>Efface le cache de <function>stat</function></refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>clearstatcache</methodname> - <void/> - </methodsynopsis> - <para> - L'appel à la fonction <function>stat</function> ou - <function>lstat</function> est relativement coûteux en terme de - temps d'exécution. Pour cela, le résultat du dernier - appel à l'une des fonctions de statut, (voir la liste ci-dessous), est - sauvegardé pour ré-utilisation ultérieure. Si vous voulez - forcer la vérification du statut d'un fichier, dans le cas où le - fichier aurait pu être modifié ou aurait disparu, vous - devez utiliser la fonction <function>clearstatcache</function> - afin d'effacer de la mémoire les résultats du dernier - appel à la fonction. - </para> - <para> - Sachez bien que &php; ne met pas en cache les informations concernant - un fichier inexistant. Si vous appelez <function>file_exists</function> - sur un fichier qui n'existe pas, la fonction retournera &false; - jusqu'à ce que vous créiez le fichier. Si vous créez le fichier, - la fonction retournera &true; même si vous effacez le fichier. - </para> - <note> - <para> - Cette fonction met en cache des informations sur les fichiers. - Vous n'avez donc besoin d'appeler <function>clearstatcache</function> que - si vous faites des opérations multiples sur le dossier, et que vous - voulez avoir une version récente des informations. - </para> - </note> + +<refentry id="function.clearstatcache"> + <refnamediv> + <refname>clearstatcache</refname> + <refpurpose>Efface le cache de <function>stat</function></refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>clearstatcache</methodname> + <void/> + </methodsynopsis> + <para> + L'appel à la fonction <function>stat</function> ou + <function>lstat</function> est relativement coûteux en terme de + temps d'exécution. Pour cela, le résultat du dernier + appel à l'une des fonctions de statut, (voir la liste ci-dessous), est + sauvegardé pour ré-utilisation ultérieure. Si vous voulez + forcer la vérification du statut d'un fichier, dans le cas où le + fichier aurait pu être modifié ou aurait disparu, vous + devez utiliser la fonction <function>clearstatcache</function> + afin d'effacer de la mémoire les résultats du dernier + appel à la fonction. + </para> + <para> + Sachez bien que &php; ne met pas en cache les informations concernant + un fichier inexistant. Si vous appelez <function>file_exists</function> + sur un fichier qui n'existe pas, la fonction retournera &false; + jusqu'à ce que vous créiez le fichier. Si vous créez le fichier, + la fonction retournera &true; même si vous effacez le fichier. + </para> + <note> <para> - Les fonctions affectées sont : - <function>stat</function>, - <function>lstat</function>, - <function>file_exists</function>, - <function>is_writable</function>, - <function>is_readable</function>, - <function>is_executable</function>, - <function>is_file</function>, - <function>is_dir</function>, - <function>is_link</function>, - <function>filectime</function>, - <function>fileatime</function>, - <function>filemtime</function>, - <function>fileinode</function>, - <function>filegroup</function>, - <function>fileowner</function>, - <function>filesize</function>, - <function>filetype</function>, et - <function>fileperms</function>. + Cette fonction met en cache des informations sur les fichiers. + Vous n'avez donc besoin d'appeler <function>clearstatcache</function> que + si vous faites des opérations multiples sur le dossier, et que vous + voulez avoir une version récente des informations. </para> - </refsect1> - </refentry> + </note> + <para> + Les fonctions affectées sont : + <function>stat</function>, + <function>lstat</function>, + <function>file_exists</function>, + <function>is_writable</function>, + <function>is_readable</function>, + <function>is_executable</function>, + <function>is_file</function>, + <function>is_dir</function>, + <function>is_link</function>, + <function>filectime</function>, + <function>fileatime</function>, + <function>filemtime</function>, + <function>fileinode</function>, + <function>filegroup</function>, + <function>fileowner</function>, + <function>filesize</function>, + <function>filetype</function>, et + <function>fileperms</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -83,4 +84,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/copy.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/copy.xml diff -u phpdoc-fr/reference/filesystem/functions/copy.xml:1.14 phpdoc-fr/reference/filesystem/functions/copy.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/copy.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/copy.xml Wed Feb 7 22:06:29 2007 @@ -1,73 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.copy"> - <refnamediv> - <refname>copy</refname> - <refpurpose>Copie un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>copy</methodname> - <methodparam><type>string</type><parameter>source</parameter></methodparam> - <methodparam><type>string</type><parameter>dest</parameter></methodparam> - </methodsynopsis> - <para> - <function>copy</function> fait une copie du fichier - <parameter>source</parameter> vers le fichier <parameter>dest</parameter>. - &return.success; - <example> - <title>Exemple avec <function>copy</function></title> - <programlisting role="php"> + +<refentry id="function.copy"> + <refnamediv> + <refname>copy</refname> + <refpurpose>Copie un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>copy</methodname> + <methodparam><type>string</type><parameter>source</parameter></methodparam> + <methodparam><type>string</type><parameter>dest</parameter></methodparam> + </methodsynopsis> + <para> + <function>copy</function> fait une copie du fichier + <parameter>source</parameter> vers le fichier <parameter>dest</parameter>. + &return.success; + <example> + <title>Exemple avec <function>copy</function></title> + <programlisting role="php"> <![CDATA[ <?php $file = 'example.txt'; $newfile = 'example.txt.bak'; if (!copy($file, $newfile)) { - echo "La copie du fichier $file n'a pas réussi...\n"; + echo "La copie du fichier $file n'a pas réussi...\n"; } ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + <para> + Si vous souhaitez déplacer un fichier, utilisez la fonction + <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. 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 vous souhaitez déplacer un fichier, utilisez la fonction - <function>rename</function>. + Si le fichier de destination <parameter>dest</parameter> existe déjà, + il sera écrasé. </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. 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> - <note> - <para> - Compatibilité avec Windows : si vous copiez un fichier avec une - taille nulle, <function>copy</function> retournera &false;, mais - le fichier sera correctement copié. - </para> - </note> + </warning> + <note> <para> - Voir aussi - <function>move_uploaded_file</function>, - <function>rename</function> et la section du manuel concernant la - <link linkend="features.file-upload">gestion des téléchargements de - fichiers</link>. + Compatibilité avec Windows : si vous copiez un fichier avec une + taille nulle, <function>copy</function> retournera &false;, mais + le fichier sera correctement copié. </para> + </note> + <para> + Voir aussi + <function>move_uploaded_file</function>, + <function>rename</function> et la section du manuel concernant la + <link linkend="features.file-upload">gestion des téléchargements de + fichiers</link>. + </para> </refsect1> </refentry> @@ -90,4 +91,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/delete.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/delete.xml diff -u phpdoc-fr/reference/filesystem/functions/delete.xml:1.9 phpdoc-fr/reference/filesystem/functions/delete.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/delete.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/delete.xml Wed Feb 7 22:06:29 2007 @@ -1,29 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.delete"> - <refnamediv> - <refname>delete</refname> - <refpurpose>Effacer</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>void</type><methodname>delete</methodname> - <methodparam><type>string</type><parameter>file</parameter></methodparam> - </methodsynopsis> - <para> - Ceci est une page d'entrée du manuel pour ceux qui recherchent - en fait la fonction <function>unlink</function> ou <function>unset</function>. - </para> - <para> - Voir aussi - <function>unlink</function> et - <function>unset</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.delete"> + <refnamediv> + <refname>delete</refname> + <refpurpose>Effacer</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>delete</methodname> + <methodparam><type>string</type><parameter>file</parameter></methodparam> + </methodsynopsis> + <para> + Ceci est une page d'entrée du manuel pour ceux qui recherchent + en fait la fonction <function>unlink</function> ou <function>unset</function>. + </para> + <para> + Voir aussi + <function>unlink</function> et + <function>unset</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +45,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/dirname.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/dirname.xml diff -u phpdoc-fr/reference/filesystem/functions/dirname.xml:1.12 phpdoc-fr/reference/filesystem/functions/dirname.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/dirname.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/dirname.xml Wed Feb 7 22:06:29 2007 @@ -1,62 +1,63 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.dirname"> - <refnamediv> - <refname>dirname</refname> - <refpurpose>Renvoie le nom du dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>dirname</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - </methodsynopsis> - <para> - <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 - (<literal>\</literal>) sont utilisés comme séparateurs - de dossier. Dans les autres environnements, seul le slash - (<literal>/</literal>) est utilisé. - </para> - <para> - <example> - <title>Exemple avec <function>dirname</function></title> - <programlisting role="php"> + +<refentry id="function.dirname"> + <refnamediv> + <refname>dirname</refname> + <refpurpose>Renvoie le nom du dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dirname</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + </methodsynopsis> + <para> + <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 + (<literal>\</literal>) sont utilisés comme séparateurs + de dossier. Dans les autres environnements, seul le slash + (<literal>/</literal>) est utilisé. + </para> + <para> + <example> + <title>Exemple avec <function>dirname</function></title> + <programlisting role="php"> <![CDATA[ <?php - $path = "/etc/passwd"; - $file = dirname ($path); +$path = "/etc/passwd"; +$file = dirname ($path); // $file vaut "/etc" ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - En &php; 4.0.3, <function>dirname</function> a été modifié pour être - compatible POSIX. Cela signifie notamment que s'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>/</literal> supprimé. Notez que cela signifie - que vous allez obtenir un slash ou un point là où l'ancien - comportement de <function>dirname</function> retournait une - chaîne vide. - </para> - </note> - <para> - <function>dirname</function> a changé de comportement en &php; 4.3.0. - Voyez les exemples suivants : - <example> - <title>Différents comportements de <function>dirname</function></title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <note> + <para> + En &php; 4.0.3, <function>dirname</function> a été modifié pour être + compatible POSIX. Cela signifie notamment que s'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>/</literal> supprimé. Notez que cela signifie + que vous allez obtenir un slash ou un point là où l'ancien + comportement de <function>dirname</function> retournait une + chaîne vide. + </para> + </note> + <para> + <function>dirname</function> a changé de comportement en &php; 4.3.0. + Voyez les exemples suivants : + <example> + <title>Différents comportements de <function>dirname</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -68,20 +69,20 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>dirname</function> a été protégé des données binaires depuis &php; 5.0.0. - </para> - <para> - Voir aussi - <function>basename</function>, - <function>pathinfo</function> et - <function>realpath</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + <function>dirname</function> a été protégé des données binaires depuis &php; 5.0.0. + </para> + <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 Local variables: @@ -102,4 +103,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/disk-free-space.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/disk-free-space.xml diff -u phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.10 phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/disk-free-space.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/disk-free-space.xml Wed Feb 7 22:06:29 2007 @@ -1,44 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.disk-free-space"> - <refnamediv> - <refname>disk_free_space</refname> - <refpurpose> - Renvoie l'espace disque disponible dans le répertoire - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>float</type><methodname>disk_free_space</methodname> - <methodparam><type>string</type><parameter>directory</parameter></methodparam> - </methodsynopsis> - <para> - <function>disk_free_space</function> retournera le nombre d'octets disponibles sur - le disque contenant le dossier <parameter>directory</parameter>. - </para> - <para> - <example> - <title>Exemple avec <function>disk_free_space</function></title> - <programlisting role="php"> + +<refentry id="function.disk-free-space"> + <refnamediv> + <refname>disk_free_space</refname> + <refpurpose> + Renvoie l'espace disque disponible dans le répertoire + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>float</type><methodname>disk_free_space</methodname> + <methodparam><type>string</type><parameter>directory</parameter></methodparam> + </methodsynopsis> + <para> + <function>disk_free_space</function> retournera le nombre d'octets disponibles sur + le disque contenant le dossier <parameter>directory</parameter>. + </para> + <para> + <example> + <title>Exemple avec <function>disk_free_space</function></title> + <programlisting role="php"> <![CDATA[ <?php - $df = disk_free_space("/"); - // $df contient le nombre d'octets libres sur "/" +$df = disk_free_space("/"); +// $df contient le nombre d'octets libres sur "/" ?> ]]> - </programlisting> - </example> - </para> - &note.no-remote; - <simpara> - Voir aussi - <function>disk_total_space</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.no-remote; + <simpara> + Voir aussi + <function>disk_total_space</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -59,4 +60,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/diskfreespace.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/diskfreespace.xml diff -u phpdoc-fr/reference/filesystem/functions/diskfreespace.xml:1.9 phpdoc-fr/reference/filesystem/functions/diskfreespace.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/diskfreespace.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/diskfreespace.xml Wed Feb 7 22:06:29 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.diskfreespace"> <refnamediv> <refname>diskfreespace</refname> @@ -36,4 +37,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/disk-total-space.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/disk-total-space.xml diff -u phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.11 phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/disk-total-space.xml:1.11 Mon Jan 22 20:52:08 2007 +++ phpdoc-fr/reference/filesystem/functions/disk-total-space.xml Wed Feb 7 22:06:29 2007 @@ -1,43 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.disk-total-space"> - <refnamediv> - <refname>disk_total_space</refname> - <refpurpose>Retourne la taille d'un dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>float</type><methodname>disk_total_space</methodname> - <methodparam><type>string</type><parameter>directory</parameter></methodparam> - </methodsynopsis> - <para> - <function>disk_total_space</function> lit récursivement toutes les tailles - du dossier <parameter>directory</parameter> et retourne la somme en octets. - <parameter>directory</parameter> peut être aussi une partition - de disque. - </para> - <para> - <example> - <title>Exemple avec <function>disk_total_space</function></title> - <programlisting role="php"> + +<refentry id="function.disk-total-space"> + <refnamediv> + <refname>disk_total_space</refname> + <refpurpose>Retourne la taille d'un dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>float</type><methodname>disk_total_space</methodname> + <methodparam><type>string</type><parameter>directory</parameter></methodparam> + </methodsynopsis> + <para> + <function>disk_total_space</function> lit récursivement toutes les tailles + du dossier <parameter>directory</parameter> et retourne la somme en octets. + <parameter>directory</parameter> peut être aussi une partition + de disque. + </para> + <para> + <example> + <title>Exemple avec <function>disk_total_space</function></title> + <programlisting role="php"> <![CDATA[ <?php - $df = disk_total_space("/"); // $df contient le nombre d'octets du dossier "/" +$df = disk_total_space("/"); // $df contient le nombre d'octets du dossier "/" ?> ]]> - </programlisting> - </example> - </para> - &note.no-remote; - <simpara> - Voir aussi - <function>disk_free_space</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.no-remote; + <simpara> + Voir aussi + <function>disk_free_space</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -58,4 +59,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fclose.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fclose.xml diff -u phpdoc-fr/reference/filesystem/functions/fclose.xml:1.9 phpdoc-fr/reference/filesystem/functions/fclose.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/fclose.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fclose.xml Wed Feb 7 22:06:29 2007 @@ -1,47 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fclose"> - <refnamediv> - <refname>fclose</refname> - <refpurpose>Ferme un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>fclose</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>fclose</function> ferme le fichier <parameter>handle</parameter>. - </para> - <para> - &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"> + +<refentry id="function.fclose"> + <refnamediv> + <refname>fclose</refname> + <refpurpose>Ferme un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>fclose</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>fclose</function> ferme le fichier <parameter>handle</parameter>. + </para> + <para> + &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); - +$handle = fopen('un_fichier.txt', 'r'); + +fclose($handle); + ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -62,4 +63,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/feof.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/feof.xml diff -u phpdoc-fr/reference/filesystem/functions/feof.xml:1.13 phpdoc-fr/reference/filesystem/functions/feof.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/feof.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/feof.xml Wed Feb 7 22:06:29 2007 @@ -1,57 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.12 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.feof"> - <refnamediv> - <refname>feof</refname> - <refpurpose>Teste la fin du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>handle</parameter> est à la fin du fichier ou si - une erreur survient, sinon, retourne &false;. - </para> - <warning> - <simpara> - Si une connexion ouverte avec <function>fsockopen</function> n'est pas fermée - par le serveur, <function>feof</function> attendra qu'un délai limite ne soit atteint - pour retourner &true;. Le délai par défaut vaut 60 secondes. Vous devez utiliser - la fonction <function>stream_set_timeout</function> pour modifier cette valeur. - </simpara> - </warning> - &fs.validfp.all; - <warning> - <para> - Si le pointeur de fichier passé n'est pas valide, vous obtiendrez une boucle infinie parceque - EOF échoue à retourner TRUE. - <example> - <title>Exemple avec <function>feof</function> et un pointeur de fichier invalide</title> - <programlisting role="php"> + +<refentry id="function.feof"> + <refnamediv> + <refname>feof</refname> + <refpurpose>Teste la fin du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>handle</parameter> est à la fin du fichier ou si + une erreur survient, sinon, retourne &false;. + </para> + <warning> + <simpara> + Si une connexion ouverte avec <function>fsockopen</function> n'est pas fermée + par le serveur, <function>feof</function> attendra qu'un délai limite ne soit atteint + pour retourner &true;. Le délai par défaut vaut 60 secondes. Vous devez utiliser + la fonction <function>stream_set_timeout</function> pour modifier cette valeur. + </simpara> + </warning> + &fs.validfp.all; + <warning> + <para> + Si le pointeur de fichier passé n'est pas valide, vous obtiendrez une boucle infinie parceque + EOF échoue à retourner TRUE. + <example> + <title>Exemple avec <function>feof</function> et un pointeur de fichier invalide</title> + <programlisting role="php"> <![CDATA[ <?php // Si le fichier ne peut être lu ou n'existe pas, la fonction fopen retourne FALSE $file = @fopen("no_such_file", "r"); // FALSE issu de fopen emmetra une alerte et fera quel'on aura une boucle infinie ici -while (!feof($file)) { + while (!feof($file)) { } fclose($file); ?> ]]> - </programlisting> - </example> - </para> - </warning> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </warning> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fflush.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fflush.xml diff -u phpdoc-fr/reference/filesystem/functions/fflush.xml:1.9 phpdoc-fr/reference/filesystem/functions/fflush.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/fflush.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fflush.xml Wed Feb 7 22:06:29 2007 @@ -1,32 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fflush"> - <refnamediv> - <refname>fflush</refname> - <refpurpose>Envoie tout le contenu généré dans un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>handle</parameter>. <function>fflush</function> retourne - &true; en cas de succès, et &false; - sinon. - </para> - <para> - <parameter>handle</parameter> est un pointeur de fichier ouvert - avec <function>fopen</function>, <function>popen</function>, ou - <function>fsockopen</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.fflush"> + <refnamediv> + <refname>fflush</refname> + <refpurpose>Envoie tout le contenu généré dans un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>handle</parameter>. <function>fflush</function> retourne + &true; en cas de succès, et &false; + sinon. + </para> + <para> + <parameter>handle</parameter> est un pointeur de fichier ouvert + avec <function>fopen</function>, <function>popen</function>, ou + <function>fsockopen</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +48,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fgetcsv.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fgetcsv.xml diff -u phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.17 phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.18 --- phpdoc-fr/reference/filesystem/functions/fgetcsv.xml:1.17 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fgetcsv.xml Wed Feb 7 22:06:29 2007 @@ -1,109 +1,110 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.20 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.21 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fgetcsv"> - <refnamediv> - <refname>fgetcsv</refname> - <refpurpose>Renvoie la ligne courante et cherche les champs CSV</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>fgetcsv</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam choice="opt"><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> - <para> - <variablelist> - <varlistentry> - <term><parameter>handle</parameter></term> - <listitem> - <simpara> - Un pointeur valide sur un fichier ouvert avec <function>fopen</function>, - <function>popen</function> ou <function>fsockopen</function>. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>length</parameter> (Optionnel)</term> - <listitem> - <simpara> - Doit être plus grand que la plus grande ligne (en terme de caractères) - à lire dans le fichier (y compris le caractère de fin de ligne). Ce - paramètre est optionnel depuis &php; 5. Omettre ce paramètre - (ou le définir à 0 en &php; 5.0.4 et suivant) fait que la longueur maximale - de la ligne n'est pas limitée, ce qui est légèrement plus lent. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>delimiter</parameter> (Optionnel)</term> - <listitem> - <simpara> - Spécifie le séparateur (un seul caractère). Par défaut, c'est - la virgule. - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>enclosure</parameter> (Optionnel)</term> - <listitem> - <simpara> - Spécifie le caractère de délimitation (un seul caractère). - Par défaut, c'est les guillemets doubles. Ce paramètre a été - ajouté en &php; 4.3.0. - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> +<refentry id="function.fgetcsv"> + <refnamediv> + <refname>fgetcsv</refname> + <refpurpose>Renvoie la ligne courante et cherche les champs CSV</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>fgetcsv</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam choice="opt"><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> + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <simpara> + Un pointeur valide sur un fichier ouvert avec <function>fopen</function>, + <function>popen</function> ou <function>fsockopen</function>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>length</parameter> (Optionnel)</term> + <listitem> + <simpara> + Doit être plus grand que la plus grande ligne (en terme de caractères) + à lire dans le fichier (y compris le caractère de fin de ligne). Ce + paramètre est optionnel depuis &php; 5. Omettre ce paramètre + (ou le définir à 0 en &php; 5.0.4 et suivant) fait que la longueur maximale + de la ligne n'est pas limitée, ce qui est légèrement plus lent. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>delimiter</parameter> (Optionnel)</term> + <listitem> + <simpara> + Spécifie le séparateur (un seul caractère). Par défaut, c'est + la virgule. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>enclosure</parameter> (Optionnel)</term> + <listitem> + <simpara> + Spécifie le caractère de délimitation (un seul caractère). + Par défaut, c'est les guillemets doubles. Ce paramètre a été + ajouté en &php; 4.3.0. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + + <simpara> + <function>fgetcsv</function> est identique à + <function>fgets</function> mais <function>fgetcsv</function> + analyse la ligne qu'il lit et recherche les champs + <acronym>CSV</acronym>, 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> - <function>fgetcsv</function> est identique à - <function>fgets</function> mais <function>fgetcsv</function> - analyse la ligne qu'il lit et recherche les champs - <acronym>CSV</acronym>, 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>handle</parameter> doit être un pointeur valide, et avoir - été correctement ouvert par <function>fopen</function>, - <function>popen</function>, ou <function>fsockopen</function>. - </simpara> - <simpara> - <parameter>length</parameter> doit être plus grand que la plus - grande ligne trouvée dans un fichier CSV (en comptant les - caractères de fin de ligne). - Il est devenu optionnl en &php; 5. + Le paramètre <parameter>enclosure</parameter> a été + ajouté en &php; 4.3.0. </simpara> + </note> + <simpara> + <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> + <simpara> + <parameter>length</parameter> doit être plus grand que la plus + grande ligne trouvée dans un fichier CSV (en comptant les + caractères de fin de ligne). + Il est devenu optionnl en &php; 5. + </simpara> + <simpara> + <function>fgetcsv</function> retourne &false; en cas + d'erreur, ou en cas de fin du fichier. + </simpara> + <note> <simpara> - <function>fgetcsv</function> retourne &false; en cas - d'erreur, ou en cas de fin du fichier. + 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> - <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> - Lit et affiche le contenu d'un fichier CSV avec <function>fgetcsv</function> - </title> - <programlisting role="php"> + </note> + <example> + <title> + Lit et affiche le contenu d'un fichier CSV avec <function>fgetcsv</function> + </title> + <programlisting role="php"> <![CDATA[ <?php $row = 1; @@ -119,27 +120,27 @@ fclose($handle); ?> ]]> - </programlisting> - </example> - <para> - <function>fgetcsv</function> a été protégé des données binaires depuis &php; 4.3.5. - </para> - <note> - <simpara> - La définition des locales entre en jeux avec cette fonction. - Si <varname>LANG</varname> vaut, e.g. <literal>en_US.UTF-8</literal>, - les fichiers encodés sur un octet sont mal lus par cette fonction. - </simpara> - </note> - <para> - Voir aussi - <function>explode</function>, - <function>file</function>, - <function>pack</function> et - <function>fputcsv</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + <para> + <function>fgetcsv</function> a été protégé des données binaires depuis &php; 4.3.5. + </para> + <note> + <simpara> + La définition des locales entre en jeux avec cette fonction. + Si <varname>LANG</varname> vaut, e.g. <literal>en_US.UTF-8</literal>, + les fichiers encodés sur un octet sont mal lus par cette fonction. + </simpara> + </note> + <para> + Voir aussi + <function>explode</function>, + <function>file</function>, + <function>pack</function> et + <function>fputcsv</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -160,4 +161,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fgetc.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fgetc.xml diff -u phpdoc-fr/reference/filesystem/functions/fgetc.xml:1.13 phpdoc-fr/reference/filesystem/functions/fgetc.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/fgetc.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fgetc.xml Wed Feb 7 22:06:29 2007 @@ -1,34 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fgetc"> - <refnamediv> - <refname>fgetc</refname> - <refpurpose>Lit un caractère dans un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fgetc</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>fgetc</function> retourne une chaîne contenant un - seul caractère, lu depuis le fichier pointé par - <parameter>handle</parameter>. <function>fgetc</function> retourne - &false; à la fin du fichier (contrairement à <function>feof</function>). - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - correctement ouvert par <function>fopen</function>, <function>popen</function>, - ou <function>fsockopen</function>. - </para> - &return.falseproblem; - <para> - <example> - <title>Exemple avec <function>fgetc</function></title> - <programlisting role="php"> + +<refentry id="function.fgetc"> + <refnamediv> + <refname>fgetc</refname> + <refpurpose>Lit un caractère dans un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fgetc</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>fgetc</function> retourne une chaîne contenant un + seul caractère, lu depuis le fichier pointé par + <parameter>handle</parameter>. <function>fgetc</function> retourne + &false; à la fin du fichier (contrairement à <function>feof</function>). + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + correctement ouvert par <function>fopen</function>, <function>popen</function>, + ou <function>fsockopen</function>. + </para> + &return.falseproblem; + <para> + <example> + <title>Exemple avec <function>fgetc</function></title> + <programlisting role="php"> <![CDATA[ <?php $fp = fopen('unfichier.txt', 'r'); @@ -40,21 +41,21 @@ } ?> ]]> - </programlisting> - </example> - </para> - - &note.bin-safe; - <para> - Voir aussi - <function>fread</function>, - <function>fopen</function>, - <function>popen</function>, - <function>fsockopen</function> et - <function>fgets</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + + &note.bin-safe; + <para> + Voir aussi + <function>fread</function>, + <function>fopen</function>, + <function>popen</function>, + <function>fsockopen</function> et + <function>fgets</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fgetss.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fgetss.xml diff -u phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.11 phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/fgetss.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fgetss.xml Wed Feb 7 22:06:29 2007 @@ -1,53 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fgetss"> - <refnamediv> - <refname>fgetss</refname> - <refpurpose> - Renvoie la ligne courante du fichier et élimine les balises HTML - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>fgetss</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam> - </methodsynopsis> - <para> - <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. - <function>fgetss</function> lit jusqu'à <parameter>length</parameter> octets - dans la ressource de fichier <parameter>handle</parameter>. - </para> - <para> - Vous pouvez aussi préciser les balises qui seront ignorées dans - le troisième paramètre optionnel. - <note> - <para> - <parameter>allowable_tags</parameter> a été ajouté en - &php; 3.0.13 et &php; 4.0.0. - </para> - </note> - </para> - <para> - Le paramètre <parameter>length</parameter> est optionnel depuis &php; 5. - </para> - &note.line-endings; + +<refentry id="function.fgetss"> + <refnamediv> + <refname>fgetss</refname> + <refpurpose> + Renvoie la ligne courante du fichier et élimine les balises HTML + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>fgetss</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>allowable_tags</parameter></methodparam> + </methodsynopsis> + <para> + <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. + <function>fgetss</function> lit jusqu'à <parameter>length</parameter> octets + dans la ressource de fichier <parameter>handle</parameter>. + </para> + <para> + Vous pouvez aussi préciser les balises qui seront ignorées dans + le troisième paramètre optionnel. + <note> <para> - Voir aussi - <function>fgets</function>, - <function>fopen</function>, - <function>fsockopen</function>, - <function>popen</function> et - <function>strip_tags</function>. - </para> - </refsect1> - </refentry> + <parameter>allowable_tags</parameter> a été ajouté en + &php; 3.0.13 et &php; 4.0.0. + </para> + </note> + </para> + <para> + Le paramètre <parameter>length</parameter> est optionnel depuis &php; 5. + </para> + &note.line-endings; + <para> + Voir aussi + <function>fgets</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function> et + <function>strip_tags</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -68,4 +69,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fgets.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fgets.xml diff -u phpdoc-fr/reference/filesystem/functions/fgets.xml:1.19 phpdoc-fr/reference/filesystem/functions/fgets.xml:1.20 --- phpdoc-fr/reference/filesystem/functions/fgets.xml:1.19 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fgets.xml Wed Feb 7 22:06:29 2007 @@ -1,93 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> -<!-- EN-Revision: 1.16 Maintainer: dams Status: ready --> +<!-- $Revision: 1.20 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fgets"> - <refnamediv> - <refname>fgets</refname> - <refpurpose> - Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 depuis le pointeur de fichier - <parameter>handle</parameter>, ou bien la fin du - fichier, ou une nouvelle ligne (qui inclut la valeur retournée), ou encore un EOF (celui - qui arrive en premier). Si aucune longueur n'est fournie, la fonction lira le flux jusqu'à la fin - de la ligne. - </para> - <para> - Si une erreur survient, <function>fgets</function> retourne &false;. - </para> - <para> - Erreur courante : - </para> - <simpara> - Les programmeurs habitués à la programmation 'C' noteront que - <function>fgets</function> ne se comporte pas comme son équivalent C - lors de la rencontre de la fin du fichier. - </simpara> +<refentry id="function.fgets"> + <refnamediv> + <refname>fgets</refname> + <refpurpose> + Renvoie la ligne courante sur laquelle se trouve le pointeur du fichier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 depuis le pointeur de fichier + <parameter>handle</parameter>, ou bien la fin du + fichier, ou une nouvelle ligne (qui inclut la valeur retournée), ou encore un EOF (celui + qui arrive en premier). Si aucune longueur n'est fournie, la fonction lira le flux jusqu'à la fin + de la ligne. + </para> + <para> + Si une erreur survient, <function>fgets</function> retourne &false;. + </para> + <para> + Erreur courante : + </para> + <simpara> + Les programmeurs habitués à la programmation 'C' noteront que + <function>fgets</function> ne se comporte pas comme son équivalent C + lors de la rencontre de la fin du fichier. + </simpara> - &fs.validfp.all; + &fs.validfp.all; - <para> - Un exemple simple : - <example> - <title>Lecture d'un fichier ligne par ligne</title> - <programlisting role="php"> + <para> + Un exemple simple : + <example> + <title>Lecture d'un fichier ligne par ligne</title> + <programlisting role="php"> <![CDATA[ <?php $handle = @fopen("/tmp/inputfile.txt", "r"); if ($handle) { - while (!feof($handle)) { - $buffer = fgets($handle, 4096); - echo $buffer; - } - fclose($handle); + while (!feof($handle)) { + $buffer = fgets($handle, 4096); + echo $buffer; + } + fclose($handle); } ?> ]]> - </programlisting> - </example> - </para> - <note> - <simpara> - Le paramètre <parameter>length</parameter> est devenu optionnel depuis - &php; 4.2.0. Depuis &php; 4.3.0, le fait d'ommettre ce paramètre fait que - la fonction lira 1024 octets de la ligne. - 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> - &note.line-endings; - <para> - Voir aussi - <function>fgetss</function> - <function>fread</function>, - <function>fgetc</function>, - <function>stream_get_line</function>, - <function>fopen</function>, - <function>popen</function>, - <function>fsockopen</function> et - <function>stream_set_timeout</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <note> + <simpara> + Le paramètre <parameter>length</parameter> est devenu optionnel depuis + &php; 4.2.0. Depuis &php; 4.3.0, le fait d'ommettre ce paramètre fait que + la fonction lira 1024 octets de la ligne. + 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> + &note.line-endings; + <para> + Voir aussi + <function>fgetss</function> + <function>fread</function>, + <function>fgetc</function>, + <function>stream_get_line</function>, + <function>fopen</function>, + <function>popen</function>, + <function>fsockopen</function> et + <function>stream_set_timeout</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -108,4 +108,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fileatime.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fileatime.xml diff -u phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.16 phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.17 --- phpdoc-fr/reference/filesystem/functions/fileatime.xml:1.16 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fileatime.xml Wed Feb 7 22:06:29 2007 @@ -1,42 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fileatime"> - <refnamediv> - <refname>fileatime</refname> - <refpurpose> - Renvoie la date à laquelle le fichier a été accédé pour la dernière fois - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fileatime</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>fileatime</function> renvoie la date à laquelle le fichier - <parameter>filename</parameter> a été accédé pour la dernière fois, ou - &false; en cas d'erreur. - </simpara> - <simpara> - Note : La date de dernière modification d'un fichier est supposé changer - à chaque fois que les blocks de données du fichier ont commencés - à être lus. Cela peut être très couteux en terme de performance lorsqu'une - application accède régulièrement à beaucoup de fichiers ou de répertoires. - La plupart des systèmes de fichiers Unix peuvent être montés en ayant - désactivés cette information pour accroître les performances d'une telle - application ; les nouvelles <literal>USENET</literal> sont un bon exemple. - Sur de telles systèmes de fichiers, cette fonction devient totalement inutile. - </simpara> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - <para> - <example> - <title>Exemple avec <function>fileatime</function></title> - <programlisting role="php"> + +<refentry id="function.fileatime"> + <refnamediv> + <refname>fileatime</refname> + <refpurpose> + Renvoie la date à laquelle le fichier a été accédé pour la dernière fois + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fileatime</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <simpara> + <function>fileatime</function> renvoie la date à laquelle le fichier + <parameter>filename</parameter> a été accédé pour la dernière fois, ou + &false; en cas d'erreur. + </simpara> + <simpara> + Note : La date de dernière modification d'un fichier est supposé changer + à chaque fois que les blocks de données du fichier ont commencés + à être lus. Cela peut être très couteux en terme de performance lorsqu'une + application accède régulièrement à beaucoup de fichiers ou de répertoires. + La plupart des systèmes de fichiers Unix peuvent être montés en ayant + désactivés cette information pour accroître les performances d'une telle + application ; les nouvelles <literal>USENET</literal> sont un bon exemple. + Sur de telles systèmes de fichiers, cette fonction devient totalement inutile. + </simpara> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> + <example> + <title>Exemple avec <function>fileatime</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -49,17 +50,17 @@ ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>filemtime</function>, - <function>fileinode</function> et - <function>date</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>filemtime</function>, + <function>fileinode</function> et + <function>date</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -80,4 +81,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/filectime.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/filectime.xml diff -u phpdoc-fr/reference/filesystem/functions/filectime.xml:1.13 phpdoc-fr/reference/filesystem/functions/filectime.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/filectime.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/filectime.xml Wed Feb 7 22:06:29 2007 @@ -1,48 +1,49 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.filectime"> - <refnamediv> - <refname>filectime</refname> - <refpurpose> - Renvoie la date de dernier accès à un inode - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>filectime</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>filectime</function> renvoie l'heure à laquelle l'inode - <parameter>filename</parameter> a été accédé pour - la dernière fois, ou &false; en cas d'erreur. - </para> - <para> - Note : Sur la plupart des serveurs UNIX, un fichier est considéré - comme modifié si les données de son inode sont modifiées. - C'est-à-dire lorsque les permissions (utilisateur, groupe ou autre) ont - été modifiées. Voyez aussi <function>filemtime</function> - (que vous pourrez utiliser lorsque vous créerez des indications - telles que "Dernière modification : " sur les pages web) et - <function>fileatime</function>. - </para> - <para> - Notez aussi que sur certains systèmes UNIX, le ctime d'un fichier - texte est considéré comme sa date de création. Cela est faux ! - Il n'y a pas de date de création de fichier sous la plupart - des systèmes UNIX. - </para> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - - <para> - <example> - <title>Exemple avec <function>filectime</function></title> - <programlisting role="php"> + +<refentry id="function.filectime"> + <refnamediv> + <refname>filectime</refname> + <refpurpose> + Renvoie la date de dernier accès à un inode + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>filectime</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>filectime</function> renvoie l'heure à laquelle l'inode + <parameter>filename</parameter> a été accédé pour + la dernière fois, ou &false; en cas d'erreur. + </para> + <para> + Note : Sur la plupart des serveurs UNIX, un fichier est considéré + comme modifié si les données de son inode sont modifiées. + C'est-à-dire lorsque les permissions (utilisateur, groupe ou autre) ont + été modifiées. Voyez aussi <function>filemtime</function> + (que vous pourrez utiliser lorsque vous créerez des indications + telles que "Dernière modification : " sur les pages web) et + <function>fileatime</function>. + </para> + <para> + Notez aussi que sur certains systèmes UNIX, le ctime d'un fichier + texte est considéré comme sa date de création. Cela est faux ! + Il n'y a pas de date de création de fichier sous la plupart + des systèmes UNIX. + </para> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + + <para> + <example> + <title>Exemple avec <function>filectime</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -55,15 +56,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>filemtime</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>filemtime</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -84,4 +85,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/file-exists.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/file-exists.xml diff -u phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.12 phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/file-exists.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/file-exists.xml Wed Feb 7 22:06:29 2007 @@ -1,32 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.14 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.file-exists"> - <refnamediv> - <refname>file_exists</refname> - <refpurpose>Vérifie si un fichier existe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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. - </simpara> - <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> - <para> - <example> - <title>Test d'existence d'un fichier</title> - <programlisting role="php"> + +<refentry id="function.file-exists"> + <refnamediv> + <refname>file_exists</refname> + <refpurpose>Vérifie si un fichier existe</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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. + </simpara> + <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> + <para> + <example> + <title>Test d'existence d'un fichier</title> + <programlisting role="php"> <![CDATA[ <?php $filename = '/chemin/jusqu/a/fichier.txt'; @@ -38,32 +39,32 @@ } ?> ]]> - </programlisting> - </example> - </para> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - - <warning> - <para> - Cette fonction retourne &false; pour les fichiers non accessibles en raison - des restrictions du <link linkend="features.safe-mode">safe mode</link>. - Cependant, ces fichiers peuvent toujours être <link - linkend="function.include">inclus</link> s'ils sont dans le dossier <link - linkend="ini.safe-mode-include-dir">safe_mode_include_dir</link>. - </para> - </warning> - - <para> - Voir aussi - <function>is_readable</function>, - <function>is_writable</function>, - <function>is_file</function> et - <function>file</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + + <warning> + <para> + Cette fonction retourne &false; pour les fichiers non accessibles en raison + des restrictions du <link linkend="features.safe-mode">safe mode</link>. + Cependant, ces fichiers peuvent toujours être <link + linkend="function.include">inclus</link> s'ils sont dans le dossier <link + linkend="ini.safe-mode-include-dir">safe_mode_include_dir</link>. + </para> + </warning> + + <para> + Voir aussi + <function>is_readable</function>, + <function>is_writable</function>, + <function>is_file</function> et + <function>file</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -84,4 +85,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/file-get-contents.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/file-get-contents.xml diff -u phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.21 phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.22 --- phpdoc-fr/reference/filesystem/functions/file-get-contents.xml:1.21 Sat Nov 18 15:07:50 2006 +++ phpdoc-fr/reference/filesystem/functions/file-get-contents.xml Wed Feb 7 22:06:29 2007 @@ -1,104 +1,105 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.25 Maintainer: dams Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.25 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.file-get-contents"> - <refnamediv> - <refname>file_get_contents</refname> - <refpurpose>Lit tout un fichier dans une chaîne</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>file_get_contents</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> - <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>maxlen</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, à partir - de la position <parameter>offset</parameter>, et jusqu'à - <parameter>maxlen</parameter> octets. - En cas d'erreur, <function>file_get_contents</function> retourne - &false;. - </para> + +<refentry id="function.file-get-contents"> + <refnamediv> + <refname>file_get_contents</refname> + <refpurpose>Lit tout un fichier dans une chaîne</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>file_get_contents</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> + <methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>maxlen</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, à partir + de la position <parameter>offset</parameter>, et jusqu'à + <parameter>maxlen</parameter> octets. + En cas d'erreur, <function>file_get_contents</function> retourne + &false;. + </para> + <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"><option>include_path</option></link>. + </para> + <note> <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"><option>include_path</option></link>. + Si vous ouvrez une URI avec des caractères spéciaux, comme des espaces, vous + devez encoder cette URI avec la fonction <function>urlencode</function>. </para> - <note> - <para> - Si vous ouvrez une URI avec des caractères spéciaux, comme des espaces, vous - devez encoder cette URI avec la fonction <function>urlencode</function>. - </para> - </note> - <note> - <para> - Le paramètre <parameter>context</parameter> peut être éludé par la valeur &null;. - </para> - </note> - </refsect1> - - <refsect1 role="changelog"> - &reftitle.changelog; + </note> + <note> <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - Ajout du support du contexte. - </entry> - </row> - <row> - <entry>5.1.0</entry> - <entry> - Ajout des paramètres <parameter>offset</parameter> et - <parameter>maxlen</parameter>. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> + Le paramètre <parameter>context</parameter> peut être éludé par la valeur &null;. </para> - </refsect1> + </note> + </refsect1> - <refsect1 role="notes"> - &reftitle.notes; - &note.bin-safe; - &tip.fopen-wrapper; - &note.context-support; - &warn.ssl-non-standard; - </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Ajout du support du contexte. + </entry> + </row> + <row> + <entry>5.1.0</entry> + <entry> + Ajout des paramètres <parameter>offset</parameter> et + <parameter>maxlen</parameter>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>file</function></member> - <member><function>fgets</function></member> - <member><function>fread</function></member> - <member><function>readfile</function></member> - <member><function>file_put_contents</function></member> - <member><function>stream_get_contents</function></member> - <member><function>stream_context_create</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + <refsect1 role="notes"> + &reftitle.notes; + &note.bin-safe; + &tip.fopen-wrapper; + &note.context-support; + &warn.ssl-non-standard; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>file</function></member> + <member><function>fgets</function></member> + <member><function>fread</function></member> + <member><function>readfile</function></member> + <member><function>file_put_contents</function></member> + <member><function>stream_get_contents</function></member> + <member><function>stream_context_create</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -119,4 +120,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/filegroup.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/filegroup.xml diff -u phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.12 phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/filegroup.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/filegroup.xml Wed Feb 7 22:06:29 2007 @@ -1,35 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.filegroup"> - <refnamediv> - <refname>filegroup</refname> - <refpurpose>Lire le nom du groupe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>filegroup</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>filegroup</function> renvoie le groupe qui possède le fichier - <parameter>filename</parameter>, ou &false; en cas d'erreur. - L'identifiant de groupe est retourné au format numérique, utilisez - <function>posix_getgrgid</function> pour retrouver le nom du groupe. - En cas d'erreur, &false; est retourné, et &php; génère un erreur de - niveau <constant>E_WARNING</constant>. - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <simpara> - Voir aussi - <function>fileowner</function> et - <link linkend="ini.safe-mode-gid">safe_mode_gid</link>. - </simpara> - </refsect1> - </refentry> + +<refentry id="function.filegroup"> + <refnamediv> + <refname>filegroup</refname> + <refpurpose>Lire le nom du groupe</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>filegroup</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>filegroup</function> renvoie le groupe qui possède le fichier + <parameter>filename</parameter>, ou &false; en cas d'erreur. + L'identifiant de groupe est retourné au format numérique, utilisez + <function>posix_getgrgid</function> pour retrouver le nom du groupe. + En cas d'erreur, &false; est retourné, et &php; génère un erreur de + niveau <constant>E_WARNING</constant>. + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <simpara> + Voir aussi + <function>fileowner</function> et + <link linkend="ini.safe-mode-gid">safe_mode_gid</link>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,4 +51,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fileinode.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fileinode.xml diff -u phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.12 phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/fileinode.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fileinode.xml Wed Feb 7 22:06:29 2007 @@ -1,29 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fileinode"> - <refnamediv> - <refname>fileinode</refname> - <refpurpose>Renvoie le numéro d'inode du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fileinode</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>fileinode</function> renvoie le numéro d'inode du fichier - <parameter>filename</parameter>, ou &false; en cas d'erreur. - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <simpara> - Voir aussi <function>stat</function>. - </simpara> - </refsect1> - </refentry> + +<refentry id="function.fileinode"> + <refnamediv> + <refname>fileinode</refname> + <refpurpose>Renvoie le numéro d'inode du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fileinode</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>fileinode</function> renvoie le numéro d'inode du fichier + <parameter>filename</parameter>, ou &false; en cas d'erreur. + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <simpara> + Voir aussi <function>stat</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -44,4 +45,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/filemtime.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/filemtime.xml diff -u phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.12 phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/filemtime.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/filemtime.xml Wed Feb 7 22:06:29 2007 @@ -1,35 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.filemtime"> - <refnamediv> - <refname>filemtime</refname> - <refpurpose> - Renvoie la date de dernière modification du fichier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>filemtime</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>filemtime</function> renvoie la date de dernière - modification du fichier <parameter>filename</parameter>, ou &false; - en cas d'erreur. - </para> - <para> - <function>filemtime</function> retourne l'heure d'écriture - des blocs données d'un fichier. Utilisez <function>date</function> - sur ce résultat pour obtenir une date de modification humainement - lisible. - </para> - <para> - <example> - <title>Exemple avec <function>filemtime</function></title> - <programlisting role="php"> + +<refentry id="function.filemtime"> + <refnamediv> + <refname>filemtime</refname> + <refpurpose> + Renvoie la date de dernière modification du fichier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>filemtime</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>filemtime</function> renvoie la date de dernière + modification du fichier <parameter>filename</parameter>, ou &false; + en cas d'erreur. + </para> + <para> + <function>filemtime</function> retourne l'heure d'écriture + des blocs données d'un fichier. Utilisez <function>date</function> + sur ce résultat pour obtenir une date de modification humainement + lisible. + </para> + <para> + <example> + <title>Exemple avec <function>filemtime</function></title> + <programlisting role="php"> <![CDATA[ <?php // l'affichage sera : lefichier.txt a été modifié le : December 29 2002 22:16:23. @@ -40,21 +41,21 @@ } ?> ]]> - </programlisting> - </example> - </para> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>filectime</function>, - <function>stat</function>, - <function>touch</function> et - <function>getlastmod</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>filectime</function>, + <function>stat</function>, + <function>touch</function> et + <function>getlastmod</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fileowner.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fileowner.xml diff -u phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.12 phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/fileowner.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fileowner.xml Wed Feb 7 22:06:29 2007 @@ -1,33 +1,34 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fileowner"> - <refnamediv> - <refname>fileowner</refname> - <refpurpose>Renvoie le nom du propriétaire du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fileowner</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>fileowner</function> renvoie le nom du possesseur du fichier - <parameter>filename</parameter>, ou &false; en cas d'erreur. - L'identification du possesseur de fichier est numérique : il faut utiliser - <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur. - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <simpara> - Voir aussi - <function>stat</function>. - </simpara> - </refsect1> - </refentry> +<refentry id="function.fileowner"> + <refnamediv> + <refname>fileowner</refname> + <refpurpose>Renvoie le nom du propriétaire du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fileowner</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>fileowner</function> renvoie le nom du possesseur du fichier + <parameter>filename</parameter>, ou &false; en cas d'erreur. + L'identification du possesseur de fichier est numérique : il faut utiliser + <function>posix_getpwuid</function> pour retrouver le nom d'utilisateur. + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <simpara> + Voir aussi + <function>stat</function>. + </simpara> + + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -48,4 +49,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fileperms.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fileperms.xml diff -u phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.15 phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.16 --- phpdoc-fr/reference/filesystem/functions/fileperms.xml:1.15 Mon Apr 17 20:06:26 2006 +++ phpdoc-fr/reference/filesystem/functions/fileperms.xml Wed Feb 7 22:06:29 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.fileperms"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/file-put-contents.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/file-put-contents.xml diff -u phpdoc-fr/reference/filesystem/functions/file-put-contents.xml:1.14 phpdoc-fr/reference/filesystem/functions/file-put-contents.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/file-put-contents.xml:1.14 Wed Dec 6 14:50:58 2006 +++ phpdoc-fr/reference/filesystem/functions/file-put-contents.xml Wed Feb 7 22:06:29 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.file-put-contents"> @@ -114,7 +114,6 @@ </para> </refsect1> - <refsect1 role="notes"> &reftitle.notes; &note.bin-safe; @@ -122,7 +121,6 @@ &tip.fopen-wrapper; </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -155,4 +153,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/filesize.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/filesize.xml diff -u phpdoc-fr/reference/filesystem/functions/filesize.xml:1.13 phpdoc-fr/reference/filesystem/functions/filesize.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/filesize.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/filesize.xml Wed Feb 7 22:06:29 2007 @@ -1,39 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.filesize"> - <refnamediv> - <refname>filesize</refname> - <refpurpose>Renvoie la taille d'un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>filesize</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>filesize</function> renvoie la taille du fichier - <parameter>filename</parameter>, ou &false; (et génère une - erreur de niveau <constant>E_WARNING</constant>) en cas d'erreur. - </para> - <note> - <simpara> - Comme le type entier de &php; est signé et que de nombreuses plates-formes - utilisent des entiers de 32 bits, <function>filesize</function> peut retourner - des résultats étranges pour les fichiers de taille supérieure à 2 Go. Pour - les fichiers entre 2Go et 4 Go, cela peut être contourné avec - <literal>sprintf("%u", filesize($file))</literal>. - </simpara> - </note> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - <para> - <example> - <title>Exemple avec <function>filesize</function></title> - <programlisting role="php"> + +<refentry id="function.filesize"> + <refnamediv> + <refname>filesize</refname> + <refpurpose>Renvoie la taille d'un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>filesize</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>filesize</function> renvoie la taille du fichier + <parameter>filename</parameter>, ou &false; (et génère une + erreur de niveau <constant>E_WARNING</constant>) en cas d'erreur. + </para> + <note> + <simpara> + Comme le type entier de &php; est signé et que de nombreuses plates-formes + utilisent des entiers de 32 bits, <function>filesize</function> peut retourner + des résultats étranges pour les fichiers de taille supérieure à 2 Go. Pour + les fichiers entre 2Go et 4 Go, cela peut être contourné avec + <literal>sprintf("%u", filesize($file))</literal>. + </simpara> + </note> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> + <example> + <title>Exemple avec <function>filesize</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -44,15 +45,15 @@ ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>file_exists</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>file_exists</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +74,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/filetype.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/filetype.xml diff -u phpdoc-fr/reference/filesystem/functions/filetype.xml:1.10 phpdoc-fr/reference/filesystem/functions/filetype.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/filetype.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/filetype.xml Wed Feb 7 22:06:29 2007 @@ -1,38 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.filetype"> - <refnamediv> - <refname>filetype</refname> - <refpurpose>Retourne le type de fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>filetype</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>filetype</function> renvoie le type du fichier - <parameter>filename</parameter>. Les réponses possibles sont : - <literal>fifo</literal>, <literal>char</literal>, <literal>dir</literal>, - <literal>block</literal>, <literal>link</literal>, <literal>file</literal> - et <literal>unknown</literal>. - </para> - <para> - <function>filetype</function> retourne &false; en cas d'erreur. - <function>filetype</function> va aussi émettre une erreur - <constant>E_NOTICE</constant> si l'appel stat échoue, - ou si le type de fichier est inconnu. - </para> - &note.clearstatcache; - - &tip.fopen-wrapper.stat; - <para> - <example> - <title>Exemple avec <function>filetype</function></title> - <programlisting role="php"> + +<refentry id="function.filetype"> + <refnamediv> + <refname>filetype</refname> + <refpurpose>Retourne le type de fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>filetype</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>filetype</function> renvoie le type du fichier + <parameter>filename</parameter>. Les réponses possibles sont : + <literal>fifo</literal>, <literal>char</literal>, <literal>dir</literal>, + <literal>block</literal>, <literal>link</literal>, <literal>file</literal> + et <literal>unknown</literal>. + </para> + <para> + <function>filetype</function> retourne &false; en cas d'erreur. + <function>filetype</function> va aussi émettre une erreur + <constant>E_NOTICE</constant> si l'appel stat échoue, + ou si le type de fichier est inconnu. + </para> + &note.clearstatcache; + + &tip.fopen-wrapper.stat; + <para> + <example> + <title>Exemple avec <function>filetype</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -41,20 +42,20 @@ ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>is_dir</function>, - <function>is_file</function>, - <function>is_link</function>, - <function>file_exists</function>, - <function>stat</function> et - <function>mime_content_type</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>is_dir</function>, + <function>is_file</function>, + <function>is_link</function>, + <function>file_exists</function>, + <function>stat</function> et + <function>mime_content_type</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/file.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/file.xml diff -u phpdoc-fr/reference/filesystem/functions/file.xml:1.15 phpdoc-fr/reference/filesystem/functions/file.xml:1.16 --- phpdoc-fr/reference/filesystem/functions/file.xml:1.15 Sat Nov 18 15:07:50 2006 +++ phpdoc-fr/reference/filesystem/functions/file.xml Wed Feb 7 22:06:29 2007 @@ -1,47 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.19 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.20 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.file"> - <refnamediv> - <refname>file</refname> - <refpurpose> - Lit le fichier et renvoie le résultat dans un tableau - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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> - <function>file</function> est identique à <function>file_get_contents</function>, - hormis le fait que <function>file</function> retourne le fichier - <parameter>filename</parameter> 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>rtrim</function> sur cette valeur - pour la supprimer. - </para> - </note> + +<refentry id="function.file"> + <refnamediv> + <refname>file</refname> + <refpurpose> + Lit le fichier et renvoie le résultat dans un tableau + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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> + <function>file</function> est identique à <function>file_get_contents</function>, + hormis le fait que <function>file</function> retourne le fichier + <parameter>filename</parameter> 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> - 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>. - <function>file</function> utilise le contexte <parameter>context</parameter>, - pour les connexions réseau. + Chaque élément du tableau résultat contiendra la nouvelle ligne de fin de chaîne. + Il faudra donc utiliser <function>rtrim</function> sur cette valeur + pour la supprimer. </para> - <para> - <example> - <title>Exemple avec <function>file</function></title> - <programlisting role="php"> + </note> + <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>. + <function>file</function> utilise le contexte <parameter>context</parameter>, + pour les connexions réseau. + </para> + <para> + <example> + <title>Exemple avec <function>file</function></title> + <programlisting role="php"> <![CDATA[ <?php // Lit une page web dans un tableau. @@ -56,33 +57,33 @@ $html = implode ('', file ('http://www.example.com/')); ?> ]]> - </programlisting> - </example> + </programlisting> + </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> - <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> - &note.context-support; - &warn.ssl-non-standard; - <para> - Voir aussi - <function>readfile</function>, - <function>fopen</function>, - <function>fsockopen</function>, - <function>popen</function>, - <function>file_get_contents</function>, - <function>include</function> et - <function>stream_context_create</function>. - </para> - </refsect1> - </refentry> + </note> + &note.context-support; + &warn.ssl-non-standard; + <para> + Voir aussi + <function>readfile</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function>, + <function>file_get_contents</function>, + <function>include</function> et + <function>stream_context_create</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -103,4 +104,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/flock.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/flock.xml diff -u phpdoc-fr/reference/filesystem/functions/flock.xml:1.14 phpdoc-fr/reference/filesystem/functions/flock.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/flock.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/flock.xml Wed Feb 7 22:06:29 2007 @@ -1,85 +1,86 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.flock"> - <refnamediv> - <refname>flock</refname> - <refpurpose>Verrouille le fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 role="reference">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> - <note> - <para> - <function>flock</function> est obligatoire sous Windows. - </para> - </note> - <simpara> - <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> + +<refentry id="function.flock"> + <refnamediv> + <refname>flock</refname> + <refpurpose>Verrouille le fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 role="reference">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> + <note> <para> - <itemizedlist> - <listitem> - <simpara> - 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 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> = <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 <constant>LOCK_NB</constant> à - <parameter>operation</parameter> - (valeur de 4 pour les versions plus anciennes que &php; 4.0.1). - </simpara> - </listitem> - </itemizedlist> + <function>flock</function> est obligatoire sous Windows. </para> - <simpara> - <function>flock</function> permet de réaliser un système simple de - verrous écriture/lecture, qui peut être utilisé sur - n'importe quelle plate-forme (Unix et Windows compris). Le troisième - paramètre optionnel <parameter>&amp;wouldblock</parameter> vaut par défaut &true;, - si le verrou doit bloquer le script (condition d'erreur - <literal>EWOULDBLOCK</literal>). Le verrou est également levé avec la - fonction <function>fclose</function> - (qui est également automatiquement appelée lors de la fin du script). - </simpara> - <simpara> - &return.success; - </simpara> - <para> - <example> - <title>Exemple avec <function>flock</function></title> - <programlisting role="php"> + </note> + <simpara> + <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> + <para> + <itemizedlist> + <listitem> + <simpara> + 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 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> = <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 <constant>LOCK_NB</constant> à + <parameter>operation</parameter> + (valeur de 4 pour les versions plus anciennes que &php; 4.0.1). + </simpara> + </listitem> + </itemizedlist> + </para> + <simpara> + <function>flock</function> permet de réaliser un système simple de + verrous écriture/lecture, qui peut être utilisé sur + n'importe quelle plate-forme (Unix et Windows compris). Le troisième + paramètre optionnel <parameter>&amp;wouldblock</parameter> vaut par défaut &true;, + si le verrou doit bloquer le script (condition d'erreur + <literal>EWOULDBLOCK</literal>). Le verrou est également levé avec la + fonction <function>fclose</function> + (qui est également automatiquement appelée lors de la fin du script). + </simpara> + <simpara> + &return.success; + </simpara> + <para> + <example> + <title>Exemple avec <function>flock</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -96,39 +97,39 @@ ?> ]]> - </programlisting> - </example> - </para> - <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 parallèle sur d'autres threads 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 environnements (ceci est particulièrement vrai pour les - utilisateurs de Windows 98). - </para> - </warning> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <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 parallèle sur d'autres threads 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 environnements (ceci est particulièrement vrai pour les + utilisateurs de Windows 98). + </para> + </warning> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -149,4 +150,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fnmatch.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fnmatch.xml diff -u phpdoc-fr/reference/filesystem/functions/fnmatch.xml:1.10 phpdoc-fr/reference/filesystem/functions/fnmatch.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/fnmatch.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fnmatch.xml Wed Feb 7 22:06:29 2007 @@ -1,64 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fnmatch"> - <refnamediv> - <refname>fnmatch</refname> - <refpurpose>Repère un fichier à partir d'un masque</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</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>. - <parameter>flags</parameter> est un nom de type de masque. - </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, leurs - expressions 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"> + +<refentry id="function.fnmatch"> + <refnamediv> + <refname>fnmatch</refname> + <refpurpose>Repère un fichier à partir d'un masque</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</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>. + <parameter>flags</parameter> est un nom de type de masque. + </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, leurs + expressions 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)) { +if(fnmatch("*gr[ae]y", $color)) { echo "some form of gray ..."; - } +} ?> ]]> - </programlisting> - </example> - <warning> - <para> - Actuellement, cette fonction n'est pas disponible pour - Windows et les autres systèmes non-POSIX. - </para> - </warning> - <para> - Voir aussi - <function>glob</function>, - <function>ereg</function> et - <function>preg_match</function>. - Vous pouvez aussi consulter le manuel Unix pour - <literal>fnmatch(3)</literal> les valeurs - de <parameter>flags</parameter>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + <warning> + <para> + Actuellement, cette fonction n'est pas disponible pour + Windows et les autres systèmes non-POSIX. + </para> + </warning> + <para> + Voir aussi + <function>glob</function>, + <function>ereg</function> et + <function>preg_match</function>. + Vous pouvez aussi consulter le manuel Unix pour + <literal>fnmatch(3)</literal> les valeurs + de <parameter>flags</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -79,4 +80,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fopen.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fopen.xml diff -u phpdoc-fr/reference/filesystem/functions/fopen.xml:1.21 phpdoc-fr/reference/filesystem/functions/fopen.xml:1.22 --- phpdoc-fr/reference/filesystem/functions/fopen.xml:1.21 Sat Nov 18 15:07:50 2006 +++ phpdoc-fr/reference/filesystem/functions/fopen.xml Wed Feb 7 22:06:29 2007 @@ -1,233 +1,234 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.29 Maintainer: dams Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.30 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fopen"> - <refnamediv> - <refname>fopen</refname> - <refpurpose>Ouverture d'un fichier ou d'une URL</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>bool</type><parameter>use_include_path</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>context</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 flux. - 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> - Si &php; décide que le fichier <parameter>filename</parameter> est un fichier - local, il va essayer d'ouvrir un flux 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 activez 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'ouverture - va échouer. - </simpara> - <note> - <simpara> - La liste des protocoles supportés est disponible sur <xref linkend="wrappers"/>. - Certains protocoles (appelés aussi <literal>wrappers</literal> ou gestionnaires) - supportent des <literal>context</literal> et/ou des options dans le fichier - &php.ini;. Référez-vous aux pages du manuel traitant le protocole, pour connaître - la liste des options qui sont disponibles. ( e.g. l'option de &php.ini; - <literal>user_agent</literal> est utilisée par le gestionnaire <literal>http</literal>). - </simpara> - </note> - &note.context-support; - <note> - <simpara> - Depuis &php; 4.3.2, le mode par défaut est le mode binaire pour toutes - les plates-formes qui font la distinction entre les modes binaire et texte. - Si vous rencontrez des problèmes dans vos scripts après une mise à jour, - essayez d'utiliser le flag <literal>'t'</literal> en attendant que vous rendiez - votre script plus portable comme mentionné ci-dessous. - </simpara> - </note> - <para> - Le paramètre <parameter>mode</parameter> spécifie le type d'accès désiré - au flux. Il peut prendre les valeurs suivantes : - <table> - <title> - Liste des modes possibles pour la fonction <function>fopen</function> en utilisant - le paramètre <parameter>mode</parameter> - </title> - <tgroup cols="2"> - <thead> - <row> - <entry><parameter>mode</parameter></entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>'r'</literal></entry> - <entry> - Ouvre en lecture seule, et place le pointeur de fichier au - début du fichier. - </entry> - </row> - <row> - <entry><literal>'r+'</literal></entry> - <entry> - Ouvre en lecture et écriture, et place le pointeur de - fichier au début du fichier. + +<refentry id="function.fopen"> + <refnamediv> + <refname>fopen</refname> + <refpurpose>Ouverture d'un fichier ou d'une URL</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>bool</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</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 flux. + 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> + Si &php; décide que le fichier <parameter>filename</parameter> est un fichier + local, il va essayer d'ouvrir un flux 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 activez 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'ouverture + va échouer. + </simpara> + <note> + <simpara> + La liste des protocoles supportés est disponible sur <xref linkend="wrappers"/>. + Certains protocoles (appelés aussi <literal>wrappers</literal> ou gestionnaires) + supportent des <literal>context</literal> et/ou des options dans le fichier + &php.ini;. Référez-vous aux pages du manuel traitant le protocole, pour connaître + la liste des options qui sont disponibles. ( e.g. l'option de &php.ini; + <literal>user_agent</literal> est utilisée par le gestionnaire <literal>http</literal>). + </simpara> + </note> + &note.context-support; + <note> + <simpara> + Depuis &php; 4.3.2, le mode par défaut est le mode binaire pour toutes + les plates-formes qui font la distinction entre les modes binaire et texte. + Si vous rencontrez des problèmes dans vos scripts après une mise à jour, + essayez d'utiliser le flag <literal>'t'</literal> en attendant que vous rendiez + votre script plus portable comme mentionné ci-dessous. + </simpara> + </note> + <para> + Le paramètre <parameter>mode</parameter> spécifie le type d'accès désiré + au flux. Il peut prendre les valeurs suivantes : + <table> + <title> + Liste des modes possibles pour la fonction <function>fopen</function> en utilisant + le paramètre <parameter>mode</parameter> + </title> + <tgroup cols="2"> + <thead> + <row> + <entry><parameter>mode</parameter></entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>'r'</literal></entry> + <entry> + Ouvre en lecture seule, et place le pointeur de fichier au + début du fichier. + </entry> + </row> + <row> + <entry><literal>'r+'</literal></entry> + <entry> + Ouvre en lecture et écriture, et place le pointeur de + fichier au début du fichier. + </entry> + </row> + <row> + <entry><literal>'w'</literal></entry> + <entry> + Ouvre en écriture seule ; place le pointeur de fichier au + début du fichier et réduit la taille du fichier à 0. + Si le fichier n'existe pas, on tente de le créer. + </entry> + </row> + <row> + <entry><literal>'w+'</literal></entry> + <entry> + Ouvre en lecture et écriture ; place le pointeur de fichier + au début du fichier et réduit la taille du fichier à + 0. Si le fichier n'existe pas, on tente de le créer. </entry> - </row> - <row> - <entry><literal>'w'</literal></entry> - <entry> - Ouvre en écriture seule ; place le pointeur de fichier au - début du fichier et réduit la taille du fichier à 0. - Si le fichier n'existe pas, on tente de le créer. - </entry> - </row> - <row> - <entry><literal>'w+'</literal></entry> - <entry> - Ouvre en lecture et écriture ; place le pointeur de fichier - au début du fichier et réduit la taille du fichier à - 0. Si le fichier n'existe pas, on tente de le créer. - </entry> - </row> - <row> - <entry><literal>'a'</literal></entry> - <entry> - Ouvre en écriture seule ; place le pointeur de fichier à - la fin du fichier. Si le fichier n'existe pas, on tente - de le créer. - </entry> - </row> - <row> - <entry><literal>'a+'</literal></entry> - <entry> - Ouvre en lecture et écriture ; place le pointeur de fichier - à la fin du fichier. Si le fichier n'existe pas, on tente - de le créer. - </entry> - </row> - <row> - <entry><literal>'x'</literal></entry> - <entry> - Crée et ouvre le fichier en lecture seule ; place le pointeur de - fichier au début du fichier. Si le fichier existe déjà, - <function>fopen</function> va échouer, en retournant &false; et - en générant une erreur de niveau <constant>E_WARNING</constant>. - Si le fichier n'existe pas, <function>fopen</function> tente de le - créer. Ce mode est l'équivalent des options <literal>O_EXCL|O_CREAT</literal> - pour l'appel système <literal>open(2)</literal> sous-jacent. Cette - option est supportée à partir de &php; 4.3.2 et fonctionne uniquement - avec des fichiers locaux. - </entry> - </row> - <row> - <entry><literal>'x+'</literal></entry> - <entry> - Crée et ouvre le fichier en lecture et écriture ; place le pointeur de - fichier au début du fichier. Si le fichier existe déjà, - <function>fopen</function> va échouer, en retournant &false; et - en générant une erreur de niveau <constant>E_WARNING</constant>. - Si le fichier n'existe pas, <function>fopen</function> tente de le - créer. Ce mode est l'équivalent des options <literal>O_EXCL|O_CREAT</literal> - pour l'appel système <literal>open(2)</literal> sous-jacent. Cette - option est supportée à partir de &php; 4.3.2, et fonctionne uniquement - avec des fichiers locaux. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <note> - <para> - Les systèmes d'exploitation utilisent différents caractères - pour les nouvelles lignes. Lorsque vous écrivez un fichier - texte, et insérez une nouvelle ligne, vous devez utiliser le bon - caractère pour votre système d'exploitation. Les systèmes Unix - utilisent <literal>\n</literal> comme nouvelle ligne, les systèmes - Windows utilisent <literal>\r\n</literal>, et les systèmes - Macintosh utilisent <literal>\r</literal>. - </para> - <para> - Si vous n'utilisez pas le bon caractère de nouvelle ligne lors de - l'écriture de vos fichiers, vous risquez d'ouvrir vos fichiers avec - des applications qui donneront un aspect 'bizarre' au texte. - </para> - <para> - Windows propose un mode de traduction (<literal>'t'</literal>), - qui va traduire automatiquement les caractères <literal>\n</literal> en - <literal>\r\n</literal> lorsque vous travaillez sur le fichier. - À l'inverse, vous pouvez utiliser l'option <literal>'b'</literal> pour forcer - le fichier a être écrit en mode binaire, sans traduction des données. - Pour utiliser ces options, ajoutez <literal>'b'</literal> ou <literal>'t'</literal> - comme dernier caractère du paramètre <parameter>mode</parameter>. - </para> - <para> - Le mode de traduction par défaut dépend de l'interface SAPI et de la - version de &php; que vous utilisez. Nous vous recommandons de toujours - spécifier les options de traductions pour des raisons de portabilité. - Vous devriez utiliser <literal>'t'</literal> lorsque vous écrivez des - fichiers de texte, et le caractère <literal>\n</literal> pour définir - vos fin de ligne, dans les scripts, mais que vous vous attendez à ce - que le fichier soit relu par une application comme Notepad. Vous devriez - toujours utiliser l'option <literal>'b'</literal> dans les autres cas. - </para> - <para> - Si vous ne précisez pas <literal>'b'</literal> lorsque vous travaillez - avec des fichiers binaires, vous pourriez rencontrer des problèmes - avec vos données, comme des images corrompues ou des caractères - <literal>\r\n</literal> inopinés. - </para> - </note> - <note> - <para> - Pour des raisons de portabilité, il est recommandé de toujours - utiliser l'option <literal>'b'</literal> lorsque vous ouvrez des - fichiers avec <function>fopen</function>. - </para> - </note> - <note> - <para> - À nouveau, pour des raisons de portabilité, il est fortement - recommandé de réécrire les scripts qui utilisent l'option - <literal>'t'</literal>, pour qu'ils utilisent le bon caractère - de nouvelle ligne, et le mode <literal>'b'</literal>. - </para> - </note> + </row> + <row> + <entry><literal>'a'</literal></entry> + <entry> + Ouvre en écriture seule ; place le pointeur de fichier à + la fin du fichier. Si le fichier n'existe pas, on tente + de le créer. + </entry> + </row> + <row> + <entry><literal>'a+'</literal></entry> + <entry> + Ouvre en lecture et écriture ; place le pointeur de fichier + à la fin du fichier. Si le fichier n'existe pas, on tente + de le créer. + </entry> + </row> + <row> + <entry><literal>'x'</literal></entry> + <entry> + Crée et ouvre le fichier en lecture seule ; place le pointeur de + fichier au début du fichier. Si le fichier existe déjà, + <function>fopen</function> va échouer, en retournant &false; et + en générant une erreur de niveau <constant>E_WARNING</constant>. + Si le fichier n'existe pas, <function>fopen</function> tente de le + créer. Ce mode est l'équivalent des options <literal>O_EXCL|O_CREAT</literal> + pour l'appel système <literal>open(2)</literal> sous-jacent. Cette + option est supportée à partir de &php; 4.3.2 et fonctionne uniquement + avec des fichiers locaux. + </entry> + </row> + <row> + <entry><literal>'x+'</literal></entry> + <entry> + Crée et ouvre le fichier en lecture et écriture ; place le pointeur de + fichier au début du fichier. Si le fichier existe déjà, + <function>fopen</function> va échouer, en retournant &false; et + en générant une erreur de niveau <constant>E_WARNING</constant>. + Si le fichier n'existe pas, <function>fopen</function> tente de le + créer. Ce mode est l'équivalent des options <literal>O_EXCL|O_CREAT</literal> + pour l'appel système <literal>open(2)</literal> sous-jacent. Cette + option est supportée à partir de &php; 4.3.2, et fonctionne uniquement + avec des fichiers locaux. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <note> <para> - Le troisième paramètre optionnel <parameter>use_include_path</parameter> - peut être défini à 1 ou à &true; pour chercher le fichier dans - l'<link linkend="ini.include-path">include_path</link>. + Les systèmes d'exploitation utilisent différents caractères + pour les nouvelles lignes. Lorsque vous écrivez un fichier + texte, et insérez une nouvelle ligne, vous devez utiliser le bon + caractère pour votre système d'exploitation. Les systèmes Unix + utilisent <literal>\n</literal> comme nouvelle ligne, les systèmes + Windows utilisent <literal>\r\n</literal>, et les systèmes + Macintosh utilisent <literal>\r</literal>. + </para> + <para> + Si vous n'utilisez pas le bon caractère de nouvelle ligne lors de + l'écriture de vos fichiers, vous risquez d'ouvrir vos fichiers avec + des applications qui donneront un aspect 'bizarre' au texte. </para> - <simpara> - Si l'ouverture échoue, la fonction retourne &false; et une alerte - <constant>E_WARNING</constant> sera générée. Vous pouvez utiliser - le caractère <link linkend="language.operators.errorcontrol">@</link> - pour supprimer cette alerte. - </simpara> <para> - <example> - <title>Exemple avec <function>fopen</function></title> - <programlisting role="php"> + Windows propose un mode de traduction (<literal>'t'</literal>), + qui va traduire automatiquement les caractères <literal>\n</literal> en + <literal>\r\n</literal> lorsque vous travaillez sur le fichier. + À l'inverse, vous pouvez utiliser l'option <literal>'b'</literal> pour forcer + le fichier a être écrit en mode binaire, sans traduction des données. + Pour utiliser ces options, ajoutez <literal>'b'</literal> ou <literal>'t'</literal> + comme dernier caractère du paramètre <parameter>mode</parameter>. + </para> + <para> + Le mode de traduction par défaut dépend de l'interface SAPI et de la + version de &php; que vous utilisez. Nous vous recommandons de toujours + spécifier les options de traductions pour des raisons de portabilité. + Vous devriez utiliser <literal>'t'</literal> lorsque vous écrivez des + fichiers de texte, et le caractère <literal>\n</literal> pour définir + vos fin de ligne, dans les scripts, mais que vous vous attendez à ce + que le fichier soit relu par une application comme Notepad. Vous devriez + toujours utiliser l'option <literal>'b'</literal> dans les autres cas. + </para> + <para> + Si vous ne précisez pas <literal>'b'</literal> lorsque vous travaillez + avec des fichiers binaires, vous pourriez rencontrer des problèmes + avec vos données, comme des images corrompues ou des caractères + <literal>\r\n</literal> inopinés. + </para> + </note> + <note> + <para> + Pour des raisons de portabilité, il est recommandé de toujours + utiliser l'option <literal>'b'</literal> lorsque vous ouvrez des + fichiers avec <function>fopen</function>. + </para> + </note> + <note> + <para> + À nouveau, pour des raisons de portabilité, il est fortement + recommandé de réécrire les scripts qui utilisent l'option + <literal>'t'</literal>, pour qu'ils utilisent le bon caractère + de nouvelle ligne, et le mode <literal>'b'</literal>. + </para> + </note> + <para> + Le troisième paramètre optionnel <parameter>use_include_path</parameter> + peut être défini à 1 ou à &true; pour chercher le fichier dans + l'<link linkend="ini.include-path">include_path</link>. + </para> + <simpara> + Si l'ouverture échoue, la fonction retourne &false; et une alerte + <constant>E_WARNING</constant> sera générée. Vous pouvez utiliser + le caractère <link linkend="language.operators.errorcontrol">@</link> + pour supprimer cette alerte. + </simpara> + <para> + <example> + <title>Exemple avec <function>fopen</function></title> + <programlisting role="php"> <![CDATA[ <?php $handle = fopen("/home/rasmus/file.txt", "r"); @@ -236,48 +237,48 @@ $handle = fopen("ftp://user:password@example.com/somefile.txt", "w"); ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Si vous rencontrez des problèmes en lecture ou écriture - de fichier et que vous utilisez &php; en version module de serveur, - n'oubliez pas que les fichiers auxquels vous accédez ne sont - pas nécessairement accessibles au processus serveur. - </simpara> - <para> - Sous Windows, assurez-vous de bien protéger les anti-slash - utilisés dans le chemin du fichier, ou bien utilisez des slash. - <example> - <title>Exemple avec <function>fopen</function> sous Windows</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + <simpara> + Si vous rencontrez des problèmes en lecture ou écriture + de fichier et que vous utilisez &php; en version module de serveur, + n'oubliez pas que les fichiers auxquels vous accédez ne sont + pas nécessairement accessibles au processus serveur. + </simpara> + <para> + Sous Windows, assurez-vous de bien protéger les anti-slash + utilisés dans le chemin du fichier, ou bien utilisez des slash. + <example> + <title>Exemple avec <function>fopen</function> sous Windows</title> + <programlisting role="php"> <![CDATA[ <?php $handle = fopen("c:\\data\\info.txt", "r"); ?> ]]> - </programlisting> - </example> - </para> - &warn.ssl-non-standard; - &note.sm.uidcheck.dir; - <simpara> - Voir aussi - <xref linkend="wrappers"/>, - <function>fclose</function>, - <function>fgets</function>, - <function>fread</function>, - <function>fwrite</function>, - <function>fsockopen</function>, - <function>file</function>, - <function>file_exists</function>, - <function>is_readable</function>, - <function>socket_set_timeout</function>, - <function>popen</function> et - <function>stream_context_create</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &warn.ssl-non-standard; + &note.sm.uidcheck.dir; + <simpara> + Voir aussi + <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, + <function>fread</function>, + <function>fwrite</function>, + <function>fsockopen</function>, + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>socket_set_timeout</function>, + <function>popen</function> et + <function>stream_context_create</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -298,4 +299,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fpassthru.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fpassthru.xml diff -u phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.16 phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.17 --- phpdoc-fr/reference/filesystem/functions/fpassthru.xml:1.16 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fpassthru.xml Wed Feb 7 22:06:29 2007 @@ -1,56 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fpassthru"> - <refnamediv> - <refname>fpassthru</refname> - <refpurpose>Affiche le reste du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 - lus dans <parameter>handle</parameter> et passés à la sortie standard. - </simpara> - &fs.validfp.all; - <simpara> - Vous devez appeler la fonction <function>rewind</function> pour réinitialiser - le pointeur de fichier au début si vous avez déjà écrit des données dans le - fichier. - </simpara> - <simpara> - Si vous voulez uniquement copier le contenu d'un fichier dans le buffer - de sortie, sans le modifier auparavant ou placer le pointeur à un endroit - particulier, vous devriez utiliser la fonction <function>readfile</function>, ce - qui vous évite d'appeler la fonction <function>fopen</function> call. - </simpara> - <note> - <para> - Lorsque 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é à 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> - <para> - <example> - <title>Utiliser <function>fpassthru</function> avec un fichier binaire</title> - <programlisting role="php"> + +<refentry id="function.fpassthru"> + <refnamediv> + <refname>fpassthru</refname> + <refpurpose>Affiche le reste du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 + lus dans <parameter>handle</parameter> et passés à la sortie standard. + </simpara> + &fs.validfp.all; + <simpara> + Vous devez appeler la fonction <function>rewind</function> pour réinitialiser + le pointeur de fichier au début si vous avez déjà écrit des données dans le + fichier. + </simpara> + <simpara> + Si vous voulez uniquement copier le contenu d'un fichier dans le buffer + de sortie, sans le modifier auparavant ou placer le pointeur à un endroit + particulier, vous devriez utiliser la fonction <function>readfile</function>, ce + qui vous évite d'appeler la fonction <function>fopen</function> call. + </simpara> + <note> + <para> + Lorsque 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é à 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> + <para> + <example> + <title>Utiliser <function>fpassthru</function> avec un fichier binaire</title> + <programlisting role="php"> <![CDATA[ <?php @@ -68,18 +69,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>readfile</function>, - <function>fopen</function>, - <function>popen</function> et - <function>fsockopen</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>readfile</function>, + <function>fopen</function>, + <function>popen</function> et + <function>fsockopen</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -100,4 +101,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fputcsv.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fputcsv.xml diff -u phpdoc-fr/reference/filesystem/functions/fputcsv.xml:1.4 phpdoc-fr/reference/filesystem/functions/fputcsv.xml:1.5 --- phpdoc-fr/reference/filesystem/functions/fputcsv.xml:1.4 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fputcsv.xml Wed Feb 7 22:06:29 2007 @@ -1,42 +1,43 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: dams Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fputcsv"> - <refnamediv> - <refname>fputcsv</refname> - <refpurpose> - Formate une ligne en CSV et l'écrit dans un fichier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>fputcsv</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>fields</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam> - </methodsynopsis> - <para> - <function>fputcsv</function> formate la ligne passée sous forme de - tableau <parameter>fields</parameter>, puis écrit le résultat dans le - fichier <parameter>handle</parameter>. <function>fputcsv</function> retourne - la taille de la chaîne écrite, ou bien &false; en cas d'échec. - </para> - <para> - Le paramètre optionnel <parameter>delimiter</parameter> spécifie le - délimiteur (un seul caractère). Par défaut, c'est la virgule. - </para> - <para> - Le paramètre <parameter>enclosure</parameter> spécifie le caractère - d'encadrement (un seul caractère), et par défaut, c'est le guillemet - double ". - </para> - <para> - <example> - <title>Exemple avec <function>fputcsv</function></title> - <programlisting role="php"> + +<refentry id="function.fputcsv"> + <refnamediv> + <refname>fputcsv</refname> + <refpurpose> + Formate une ligne en CSV et l'écrit dans un fichier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>fputcsv</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>fields</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>enclosure</parameter></methodparam> + </methodsynopsis> + <para> + <function>fputcsv</function> formate la ligne passée sous forme de + tableau <parameter>fields</parameter>, puis écrit le résultat dans le + fichier <parameter>handle</parameter>. <function>fputcsv</function> retourne + la taille de la chaîne écrite, ou bien &false; en cas d'échec. + </para> + <para> + Le paramètre optionnel <parameter>delimiter</parameter> spécifie le + délimiteur (un seul caractère). Par défaut, c'est la virgule. + </para> + <para> + Le paramètre <parameter>enclosure</parameter> spécifie le caractère + d'encadrement (un seul caractère), et par défaut, c'est le guillemet + double ". + </para> + <para> + <example> + <title>Exemple avec <function>fputcsv</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -55,16 +56,16 @@ fclose($fp); ?> ]]> - </programlisting> - </example> - </para> - &note.line-endings; - <para> - Voir aussi - <function>fgetcsv</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.line-endings; + <para> + Voir aussi + <function>fgetcsv</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -85,4 +86,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fputs.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fputs.xml diff -u phpdoc-fr/reference/filesystem/functions/fputs.xml:1.10 phpdoc-fr/reference/filesystem/functions/fputs.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/fputs.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fputs.xml Wed Feb 7 22:06:29 2007 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.fputs"> <refnamediv> <refname>fputs</refname> @@ -36,4 +37,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fread.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fread.xml diff -u phpdoc-fr/reference/filesystem/functions/fread.xml:1.15 phpdoc-fr/reference/filesystem/functions/fread.xml:1.16 --- phpdoc-fr/reference/filesystem/functions/fread.xml:1.15 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fread.xml Wed Feb 7 22:06:29 2007 @@ -1,35 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.21 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.22 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fread"> - <refnamediv> - <refname>fread</refname> - <refpurpose>Lecture du fichier en mode binaire</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 réfé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 - lorsqu'un paquet devient disponible ou (après avoir ouvert les flux utilisateurs) lorsque 8192 octets - ont été lus, le premier des trois survenant. - </simpara> - <simpara> - Retourne la chaîne lue ou &false; si une erreur survient. - </simpara> - <para> - <example> - <title>Exemple avec <function>fread</function></title> - <programlisting role="php"> +<refentry id="function.fread"> + <refnamediv> + <refname>fread</refname> + <refpurpose>Lecture du fichier en mode binaire</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 réfé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 + lorsqu'un paquet devient disponible ou (après avoir ouvert les flux utilisateurs) lorsque 8192 octets + ont été lus, le premier des trois survenant. + </simpara> + <simpara> + Retourne la chaîne lue ou &false; si une erreur survient. + </simpara> + <para> + <example> + <title>Exemple avec <function>fread</function></title> + <programlisting role="php"> <![CDATA[ <?php // Lit un fichier, et le place dans une chaîne @@ -39,22 +39,22 @@ fclose ($handle); ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + <warning> + <para> + Sur les systèmes qui différencient les fichiers + textes et binaires (i.e. Windows) le fichier doit être + ouvert avec la lettre 'b' ajoutée au paramètre + de mode de la fonction <function>fopen</function>. </para> - <warning> - <para> - Sur les systèmes qui différencient les fichiers - textes et binaires (i.e. Windows) le fichier doit être - ouvert avec la lettre 'b' ajoutée au paramètre - de mode de la fonction <function>fopen</function>. - </para> - </warning> + </warning> - <para> - <example> - <title>Utilisation des fichiers binaires avec <function>fread</function></title> - <programlisting role="php"> + <para> + <example> + <title>Utilisation des fichiers binaires avec <function>fread</function></title> + <programlisting role="php"> <![CDATA[ <?php $filename = "c:\\fichiers\\uneimage.gif"; @@ -63,24 +63,24 @@ fclose ($handle); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> - <warning> - <para> - Lorsque vous lisez depuis n'importe quelle source qui n'est pas un fichier local, - comme des flux retournés lors de la lecture de - <link linkend="features.remote-files">fichiers distants</link> ou depuis - <function>popen</function> et <function>fsockopen</function>, la lecture - s'arrête après la réception d'un paquet. Il faut donc faire des - boucles pour collecter les données par paquet, comme présenté - ci-dessous. - </para> - </warning> + <warning> <para> - <informalexample> - <programlisting role="php"> + Lorsque vous lisez depuis n'importe quelle source qui n'est pas un fichier local, + comme des flux retournés lors de la lecture de + <link linkend="features.remote-files">fichiers distants</link> ou depuis + <function>popen</function> et <function>fsockopen</function>, la lecture + s'arrête après la réception d'un paquet. Il faut donc faire des + boucles pour collecter les données par paquet, comme présenté + ci-dessous. + </para> + </warning> + <para> + <informalexample> + <programlisting role="php"> <![CDATA[ <?php // Pour PHP 5 et suivant @@ -89,45 +89,45 @@ fclose($handle); ?> ]]> - </programlisting> - </informalexample> - </para> - <para> - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + <informalexample> + <programlisting role="php"> <![CDATA[ <?php $handle = fopen("http://www.example.com/", "rb"); $contents = ''; while (!feof($handle)) { - $contents .= fread($handle, 8192); + $contents .= fread($handle, 8192); } fclose($handle); ?> ]]> - </programlisting> - </informalexample> + </programlisting> + </informalexample> + </para> + <note> + <para> + Si vous voulez lire le contenu d'un fichier dans une chaîne de + caractères, utilisez plutôt <function>file_get_contents</function> + qui est bien plus rapide que le code ci-dessus. </para> - <note> - <para> - Si vous voulez lire le contenu d'un fichier dans une chaîne de - caractères, utilisez plutôt <function>file_get_contents</function> - qui est bien plus rapide que le code ci-dessus. - </para> - </note> - <simpara> - Voir aussi - <function>fwrite</function>, - <function>fopen</function>, - <function>fsockopen</function>, - <function>popen</function>, - <function>fgets</function>, - <function>fgetss</function>, - <function>file</function> et - <function>fpassthru</function>. - </simpara> - </refsect1> - </refentry> + </note> + <simpara> + Voir aussi + <function>fwrite</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function>, + <function>fgets</function>, + <function>fgetss</function>, + <function>file</function> et + <function>fpassthru</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fscanf.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fscanf.xml diff -u phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.17 phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.18 --- phpdoc-fr/reference/filesystem/functions/fscanf.xml:1.17 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fscanf.xml Wed Feb 7 22:06:29 2007 @@ -1,85 +1,86 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.16 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fscanf"> - <refnamediv> - <refname>fscanf</refname> - <refpurpose>Analyse un fichier en fonction d'un format</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>mixed</type><parameter role="reference">...</parameter></methodparam> - </methodsynopsis> - <para> - <function>fscanf</function> est similaire à <function>sscanf</function>, - mais elle prend comme entrée un fichier, associé à - <parameter>handle</parameter> et l'interprète en - fonction du format <parameter>format</parameter>. Si - seulement deux paramètres sont passés - à la fonction, les valeurs analysées seront - retournées sous forme de tableau. Si des arguments - optionnels <parameter>var1</parameter> 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 formatage correspondent - à autant d'espaces dans le flux d'entrée. Cela signifie qu'une tabulation - <literal>\t</literal> dans la chaîne de format peut remplacer - un espace simple dans le flux d'entrée. - </para> - <para> - <example> - <title>Exemple avec <function>fscanf</function></title> - <programlisting role="php"> + +<refentry id="function.fscanf"> + <refnamediv> + <refname>fscanf</refname> + <refpurpose>Analyse un fichier en fonction d'un format</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>mixed</type><parameter role="reference">...</parameter></methodparam> + </methodsynopsis> + <para> + <function>fscanf</function> est similaire à <function>sscanf</function>, + mais elle prend comme entrée un fichier, associé à + <parameter>handle</parameter> et l'interprète en + fonction du format <parameter>format</parameter>. Si + seulement deux paramètres sont passés + à la fonction, les valeurs analysées seront + retournées sous forme de tableau. Si des arguments + optionnels <parameter>var1</parameter> 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 formatage correspondent + à autant d'espaces dans le flux d'entrée. Cela signifie qu'une tabulation + <literal>\t</literal> dans la chaîne de format peut remplacer + un espace simple dans le flux d'entrée. + </para> + <para> + <example> + <title>Exemple avec <function>fscanf</function></title> + <programlisting role="php"> <![CDATA[ <?php - $handle = fopen ("users.txt","r"); - while ($userinfo = fscanf ($handle, "%s\t%s\t%s\n")) { +$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($handle); +} +fclose($handle); ?> ]]> </programlisting> - </example> - <example> - <title>Fichier <filename>utilisateurs.txt</filename></title> - <screen> + </example> + <example> + <title>Fichier <filename>utilisateurs.txt</filename></title> + <screen> <![CDATA[ javier argonaute pe hiroshi sculpteur jp robert hockeyuer us luigi fleuriste it ]]> - </screen> - </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 - "<literal>\n</literal>" : 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>, - <function>fgets</function>, - <function>fgetss</function>, - <function>sscanf</function>, - <function>printf</function> et - <function>sprintf</function>. - </para> - </refsect1> - </refentry> + </screen> + </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 + "<literal>\n</literal>" : 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>, + <function>fgets</function>, + <function>fgetss</function>, + <function>sscanf</function>, + <function>printf</function> et + <function>sprintf</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -100,4 +101,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fseek.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fseek.xml diff -u phpdoc-fr/reference/filesystem/functions/fseek.xml:1.14 phpdoc-fr/reference/filesystem/functions/fseek.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/fseek.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fseek.xml Wed Feb 7 22:06:29 2007 @@ -1,56 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fseek"> - <refnamediv> - <refname>fseek</refname> - <refpurpose>Modifie la position du pointeur de fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>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> + +<refentry id="function.fseek"> + <refnamediv> + <refname>fseek</refname> + <refpurpose>Modifie la position du pointeur de fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>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> <constant>SEEK_CUR</constant> - La position finale vaut la position courante ajoutée à <parameter>offset</parameter> octets. </member> <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 <constant>SEEK_SET</constant>. - </para> - <para> - <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> - <para> - <example> - <title>Exemple avec <function>fseek</function></title> - <programlisting role="php"> + <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 <constant>SEEK_SET</constant>. + </para> + <para> + <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> + <para> + <example> + <title>Exemple avec <function>fseek</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -65,33 +66,33 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - <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. - <function>fseek</function> donne également des résultats indéfinis - pour les flux "<literal>append-only</literal>" (ouvert avec le flag "a"). + </programlisting> + </example> + </para> + <para> + <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. + <function>fseek</function> donne également des résultats indéfinis + pour les flux "<literal>append-only</literal>" (ouvert avec le flag "a"). + </para> + <note> + <para> + Le paramètre <parameter>whence</parameter> a été ajouté en &php; 4.0.0. </para> - <note> - <para> - Le paramètre <parameter>whence</parameter> a été ajouté en &php; 4.0.0. - </para> - </note> - <note> - <para> - Si vous ouvrez le fichier avec le mode "a" ou "a+", toutes les données que vous - écrirez dans le fichier seront toujours ajoutées, sans se soucier de la position dans le fichier. - </para> - </note> - <para> - Voir aussi - <function>ftell</function> et - <function>rewind</function>. + </note> + <note> + <para> + Si vous ouvrez le fichier avec le mode "a" ou "a+", toutes les données que vous + écrirez dans le fichier seront toujours ajoutées, sans se soucier de la position dans le fichier. </para> - </refsect1> - </refentry> + </note> + <para> + Voir aussi + <function>ftell</function> et + <function>rewind</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -112,4 +113,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fstat.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fstat.xml diff -u phpdoc-fr/reference/filesystem/functions/fstat.xml:1.11 phpdoc-fr/reference/filesystem/functions/fstat.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/fstat.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fstat.xml Wed Feb 7 22:06:29 2007 @@ -1,34 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fstat"> - <refnamediv> - <refname>fstat</refname> - <refpurpose> - Lit les informations sur un fichier à partir d'un pointeur de fichier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>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> - Retourne un tableau contenant les statistiques pour le fichier ; le format de ce tableau - est décrit en détail sur la page de documentation de la fonction <function>stat</function>. - </para> - <para> - <example> - <title>Exemple avec <function>fstat</function></title> - <programlisting role="php"> + +<refentry id="function.fstat"> + <refnamediv> + <refname>fstat</refname> + <refpurpose> + Lit les informations sur un fichier à partir d'un pointeur de fichier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>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> + Retourne un tableau contenant les statistiques pour le fichier ; le format de ce tableau + est décrit en détail sur la page de documentation de la fonction <function>stat</function>. + </para> + <para> + <example> + <title>Exemple avec <function>fstat</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -46,9 +47,9 @@ ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -67,14 +68,14 @@ [blocks] => 8 ) ]]> - </screen> - </example> - </para> + </screen> + </example> + </para> - &note.no-remote; + &note.no-remote; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -95,4 +96,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/ftell.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/ftell.xml diff -u phpdoc-fr/reference/filesystem/functions/ftell.xml:1.11 phpdoc-fr/reference/filesystem/functions/ftell.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/ftell.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/ftell.xml Wed Feb 7 22:06:29 2007 @@ -1,36 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.ftell"> - <refnamediv> - <refname>ftell</refname> - <refpurpose>Renvoie la position du pointeur du fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>handle</parameter>, - i.e., son offset. - </para> - <para> - Si une erreur survient, retourne &false;. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir été - correctement ouvert par <function>fopen</function> ou <function>popen</function>. - <function>ftell</function> donne des résultats non définis pour les flux - "<literal>append-only</literal>" (ouvert avec le flag "a"). - </para> - <para> - <example> - <title>Exemple avec <function>ftell</function></title> - <programlisting role="php"> + +<refentry id="function.ftell"> + <refnamediv> + <refname>ftell</refname> + <refpurpose>Renvoie la position du pointeur du fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>handle</parameter>, + i.e., son offset. + </para> + <para> + Si une erreur survient, retourne &false;. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + correctement ouvert par <function>fopen</function> ou <function>popen</function>. + <function>ftell</function> donne des résultats non définis pour les flux + "<literal>append-only</literal>" (ouvert avec le flag "a"). + </para> + <para> + <example> + <title>Exemple avec <function>ftell</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -45,18 +46,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - Voir aussi - <function>fopen</function>, - <function>popen</function>, - <function>fseek</function> et - <function>rewind</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + Voir aussi + <function>fopen</function>, + <function>popen</function>, + <function>fseek</function> et + <function>rewind</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -77,4 +78,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/ftruncate.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/ftruncate.xml diff -u phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.12 phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/ftruncate.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/ftruncate.xml Wed Feb 7 22:06:29 2007 @@ -1,45 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.ftruncate"> - <refnamediv> - <refname>ftruncate</refname> - <refpurpose>Tronque un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>handle</parameter> et le tronque à la taille de - <parameter>size</parameter>. &return.success; - </para> - <note> - <para> - Le pointeur du fichier n'est changé qu'en mode <emphasis>aout</emphasis>. - En mode <emphasis>écriture</emphasis>, un appel additionnel à la fonction - <function>fseek</function> est nécessaire. - </para> - </note> - <note> - <para> - Avant &php; 4.3.3, <function>ftruncate</function> retournait un - &integer; de valeur 1, en cas de succès, au lieu - de la valeur <type>boolean</type> &true;. - </para> - </note> + +<refentry id="function.ftruncate"> + <refnamediv> + <refname>ftruncate</refname> + <refpurpose>Tronque un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>handle</parameter> et le tronque à la taille de + <parameter>size</parameter>. &return.success; + </para> + <note> + <para> + Le pointeur du fichier n'est changé qu'en mode <emphasis>aout</emphasis>. + En mode <emphasis>écriture</emphasis>, un appel additionnel à la fonction + <function>fseek</function> est nécessaire. + </para> + </note> + <note> <para> - Voir aussi - <function>fopen</function> et - <function>fseek</function>. + Avant &php; 4.3.3, <function>ftruncate</function> retournait un + &integer; de valeur 1, en cas de succès, au lieu + de la valeur <type>boolean</type> &true;. </para> - </refsect1> - </refentry> + </note> + <para> + Voir aussi + <function>fopen</function> et + <function>fseek</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -60,4 +61,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/fwrite.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/fwrite.xml diff -u phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.13 phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/fwrite.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/fwrite.xml Wed Feb 7 22:06:29 2007 @@ -1,50 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.fwrite"> - <refnamediv> - <refname>fwrite</refname> - <refpurpose>Ecrit un fichier en mode binaire</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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>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). - </simpara> - <simpara> - <function>fwrite</function> retourne le nombre d'octets écrits ou - &false; en cas d'erreur. - </simpara> - <simpara> - Notez que si <parameter>length</parameter> est fourni, alors l'option de - configuration - <link linkend="ini.magic-quotes-runtime"><option>magic_quotes_runtime</option></link> - sera ignorée, et les slash seront conservés. - </simpara> - <note> - <para> - 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 simple avec <function>fwrite</function></title> - <programlisting role="php"> + +<refentry id="function.fwrite"> + <refnamediv> + <refname>fwrite</refname> + <refpurpose>Ecrit un fichier en mode binaire</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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>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). + </simpara> + <simpara> + <function>fwrite</function> retourne le nombre d'octets écrits ou + &false; en cas d'erreur. + </simpara> + <simpara> + Notez que si <parameter>length</parameter> est fourni, alors l'option de + configuration + <link linkend="ini.magic-quotes-runtime"><option>magic_quotes_runtime</option></link> + sera ignorée, et les slash seront conservés. + </simpara> + <note> + <para> + 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 simple avec <function>fwrite</function></title> + <programlisting role="php"> <![CDATA[ <?php $filename = 'test.txt'; @@ -57,38 +58,38 @@ // Le pointeur de fichier est placé à la fin du fichier // c'est là que $somecontent sera placé if (!$handle = fopen($filename, 'a')) { - echo "Impossible d'ouvrir le fichier ($filename)"; - exit; + echo "Impossible d'ouvrir le fichier ($filename)"; + exit; } // Ecrivons quelque chose dans notre fichier. if (fwrite($handle, $somecontent) === FALSE) { - echo "Impossible d'écrire dans le fichier ($filename)"; - exit; + echo "Impossible d'écrire dans le fichier ($filename)"; + exit; } - + echo "L'écriture de ($somecontent) dans le fichier ($filename) a réussi"; - + fclose($handle); - + } else { - echo "Le fichier $filename n'est pas accessible en écriture."; +echo "Le fichier $filename n'est pas accessible en écriture."; } ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>fread</function>, - <function>fopen</function>, - <function>fsockopen</function>, - <function>popen</function>&listendand; - <function>file_put_contents</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + Voir aussi + <function>fread</function>, + <function>fopen</function>, + <function>fsockopen</function>, + <function>popen</function>&listendand; + <function>file_put_contents</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -109,4 +110,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/glob.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/glob.xml diff -u phpdoc-fr/reference/filesystem/functions/glob.xml:1.17 phpdoc-fr/reference/filesystem/functions/glob.xml:1.18 --- phpdoc-fr/reference/filesystem/functions/glob.xml:1.17 Fri Dec 8 09:13:56 2006 +++ phpdoc-fr/reference/filesystem/functions/glob.xml Wed Feb 7 22:06:29 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.22 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.glob"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-dir.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-dir.xml diff -u phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.12 phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/is-dir.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-dir.xml Wed Feb 7 22:06:29 2007 @@ -1,58 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-dir"> - <refnamediv> - <refname>is_dir</refname> - <refpurpose>Indique si le fichier est un dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_dir</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_dir</function> retourne &true; si - <parameter>filename</parameter> existe et est un dossier. - </para> - &note.clearstatcache; - <para> - <example> - <title>Exemple avec <function>is_dir</function></title> - <programlisting role="php"> + +<refentry id="function.is-dir"> + <refnamediv> + <refname>is_dir</refname> + <refpurpose>Indique si le fichier est un dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_dir</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_dir</function> retourne &true; si + <parameter>filename</parameter> existe et est un dossier. + </para> + &note.clearstatcache; + <para> + <example> + <title>Exemple avec <function>is_dir</function></title> + <programlisting role="php"> <![CDATA[ -<? +<?php var_dump(is_dir('un_fichier.txt')) . "\n"; var_dump(is_dir('bogus_dir/abc')) . "\n"; var_dump(is_dir('..')); //le dossier au-dessus ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ bool(false) bool(false) bool(true) ]]> - </screen> - </example> - </para> - - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>chdir</function>, - <link linkend="class.dir">dir</link>, - <function>opendir</function>, - <function>is_file</function> et - <function>is_link</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>chdir</function>, + <link linkend="class.dir">dir</link>, + <function>opendir</function>, + <function>is_file</function> et + <function>is_link</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +73,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-executable.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-executable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.12 phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/is-executable.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-executable.xml Wed Feb 7 22:06:29 2007 @@ -1,30 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.12 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-executable"> - <refnamediv> - <refname>is_executable</refname> - <refpurpose>Indique si le fichier est exécutable</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_executable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_executable</function> retourne &true; si - <parameter>filename</parameter> existe et est exécutable. - </para> - <para> - <function>is_executable</function> est disponible avec - <productname>Windows</productname> depuis &php; 5.0.0. - </para> - <para> - <example> - <title>Exemple avec <function>is_executable</function></title> - <programlisting role="php"> + +<refentry id="function.is-executable"> + <refnamediv> + <refname>is_executable</refname> + <refpurpose>Indique si le fichier est exécutable</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_executable</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_executable</function> retourne &true; si + <parameter>filename</parameter> existe et est exécutable. + </para> + <para> + <function>is_executable</function> est disponible avec + <productname>Windows</productname> depuis &php; 5.0.0. + </para> + <para> + <example> + <title>Exemple avec <function>is_executable</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -38,18 +39,18 @@ ?> ]]> - </programlisting> - </example> - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>is_file</function> et - <function>is_link</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>is_file</function> et + <function>is_link</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -70,4 +71,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-file.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-file.xml diff -u phpdoc-fr/reference/filesystem/functions/is-file.xml:1.13 phpdoc-fr/reference/filesystem/functions/is-file.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/is-file.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-file.xml Wed Feb 7 22:06:29 2007 @@ -1,52 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-file"> - <refnamediv> - <refname>is_file</refname> - <refpurpose>Indique si le fichier est un véritable fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_file</function> retourne &true; si - <parameter>filename</parameter> existe et est un fichier - (et pas un dossier). - </para> - <para> - <example> - <title>Exemple avec <function>is_file</function></title> - <programlisting role="php"> + +<refentry id="function.is-file"> + <refnamediv> + <refname>is_file</refname> + <refpurpose>Indique si le fichier est un véritable fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_file</function> retourne &true; si + <parameter>filename</parameter> existe et est un fichier + (et pas un dossier). + </para> + <para> + <example> + <title>Exemple avec <function>is_file</function></title> + <programlisting role="php"> <![CDATA[ <?php var_dump(is_file('a_file.txt')) . "\n"; var_dump(is_file('/usr/bin/')) . "\n"; ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ bool(true) bool(false) ]]> - </screen> - </example> - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>is_dir</function> et - <function>is_link</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>is_dir</function> et + <function>is_link</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -67,4 +68,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-link.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-link.xml diff -u phpdoc-fr/reference/filesystem/functions/is-link.xml:1.11 phpdoc-fr/reference/filesystem/functions/is-link.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/is-link.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-link.xml Wed Feb 7 22:06:29 2007 @@ -1,32 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-link"> - <refnamediv> - <refname>is_link</refname> - <refpurpose>Indique si le fichier est un lien symbolique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_link</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_link</function> retourne &true; si - <parameter>filename</parameter> existe et est un lien symbolique. - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>is_dir</function>, - <function>is_file</function> et - <function>readlink</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.is-link"> + <refnamediv> + <refname>is_link</refname> + <refpurpose>Indique si le fichier est un lien symbolique</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_link</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_link</function> retourne &true; si + <parameter>filename</parameter> existe et est un lien symbolique. + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>is_dir</function>, + <function>is_file</function> et + <function>readlink</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -47,4 +48,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-readable.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-readable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.15 phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.16 --- phpdoc-fr/reference/filesystem/functions/is-readable.xml:1.15 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-readable.xml Wed Feb 7 22:06:29 2007 @@ -1,54 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-readable"> - <refnamediv> - <refname>is_readable</refname> - <refpurpose>Indique si un fichier est autorisé en lecture</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_readable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_readable</function> retourne &true; si le fichier ou le dossier spécifié par le - paramètre <parameter>filename</parameter> existe et est accessible en lecture. - </para> - <para> - N'oubliez pas que &php; accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est 'nobody', personne). - </para> - <para> - <example> - <title>Exemple avec <function>is_readable</function></title> - <programlisting role="php"> + +<refentry id="function.is-readable"> + <refnamediv> + <refname>is_readable</refname> + <refpurpose>Indique si un fichier est autorisé en lecture</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_readable</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_readable</function> retourne &true; si le fichier ou le dossier spécifié par le + paramètre <parameter>filename</parameter> existe et est accessible en lecture. + </para> + <para> + N'oubliez pas que &php; accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est 'nobody', personne). + </para> + <para> + <example> + <title>Exemple avec <function>is_readable</function></title> + <programlisting role="php"> <![CDATA[ <?php $filename = 'test.txt'; if (is_readable($filename)) { - echo 'Le fichier est lisible'; + echo 'Le fichier est lisible'; } else { - echo 'Le fichier n\'est pas lisible'; + echo 'Le fichier n\'est pas lisible'; } ?> ]]> - </programlisting> - </example> - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>is_writable</function>, - <function>file_exists</function> et - <function>fgets</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>is_writable</function>, + <function>file_exists</function> et + <function>fgets</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml diff -u phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.14 phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-uploaded-file.xml Wed Feb 7 22:06:29 2007 @@ -1,79 +1,80 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-uploaded-file"> - <refnamediv> - <refname>is_uploaded_file</refname> - <refpurpose> - Indique si le fichier a été téléchargé par HTTP POST - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_uploaded_file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_uploaded_file</function> est disponible à partir des - versions &php; 3.0.16 et 4.0.2. - </para> - <para> - <function>is_uploaded_file</function> retourne &true; si le fichier - <parameter>filename</parameter> a été téléchargé - par HTTP POST. Cela est très utile pour vous assurer qu'un - utilisateur n'essaie pas d'accéder intentionnellement à - un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). - </para> - <para> - Ce type de vérification est spécialement important s'il est - possible que les fichiers téléchargés - révèlent leur contenu à l'utilisateur, ou - même aux utilisateurs du même système. - </para> - <para> - Pour un fonctionnement correct, la fonction <function>is_uploaded_file</function> - nécessite un argument comme $_FILES['userfile']['tmp_name'], - le nom du fichier - téléchargé sur la machine cliente $_FILES['userfile']['name'] ne fonctionne pas. - </para> - <example> - <title>Exemple avec <function>is_uploaded_file</function></title> - <programlisting role="php"> - <![CDATA[ + +<refentry id="function.is-uploaded-file"> + <refnamediv> + <refname>is_uploaded_file</refname> + <refpurpose> + Indique si le fichier a été téléchargé par HTTP POST + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_uploaded_file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_uploaded_file</function> est disponible à partir des + versions &php; 3.0.16 et 4.0.2. + </para> + <para> + <function>is_uploaded_file</function> retourne &true; si le fichier + <parameter>filename</parameter> a été téléchargé + par HTTP POST. Cela est très utile pour vous assurer qu'un + utilisateur n'essaie pas d'accéder intentionnellement à + un fichier auquel il n'a pas droit (comme <filename>/etc/passwd</filename>). + </para> + <para> + Ce type de vérification est spécialement important s'il est + possible que les fichiers téléchargés + révèlent leur contenu à l'utilisateur, ou + même aux utilisateurs du même système. + </para> + <para> + Pour un fonctionnement correct, la fonction <function>is_uploaded_file</function> + nécessite un argument comme $_FILES['userfile']['tmp_name'], - le nom du fichier + téléchargé sur la machine cliente $_FILES['userfile']['name'] ne fonctionne pas. + </para> + <example> + <title>Exemple avec <function>is_uploaded_file</function></title> + <programlisting role="php"> +<![CDATA[ <?php if (is_uploaded_file($_FILES['userfile']['tmp_name'])) { - echo "Fichier ". $_FILES['userfile']['name'] ." téléchargé avec succès.\n"; - echo "Affichage du contenu\n"; - readfile($_FILES['userfile']['tmp_name']); + echo "Fichier ". $_FILES['userfile']['name'] ." téléchargé avec succès.\n"; + echo "Affichage du contenu\n"; + readfile($_FILES['userfile']['tmp_name']); } else { - echo "Attaque possible par téléchargement de fichier : "; - echo "Nom du fichier : '". $_FILES['userfile']['tmp_name'] . "'."; + echo "Attaque possible par téléchargement de fichier : "; + echo "Nom du fichier : '". $_FILES['userfile']['tmp_name'] . "'."; } ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + <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> - <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> + 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> - <example> - <title>Exemple avec <function>is_uploaded_file</function> en &php; 4 &lt; 4.0.3.</title> - <programlisting role="php"> + </note> + </para> + <example> + <title>Exemple avec <function>is_uploaded_file</function> en &php; 4 &lt; 4.0.3.</title> + <programlisting role="php"> <![CDATA[ <?php /* Test utilisateur du fichier téléchargé. */ @@ -87,7 +88,7 @@ } /* Voici comment l'utiliser, car move_uploaded_file() n'est pas disponible - dans les anciennes versions : */ +dans les anciennes versions : */ if (is_uploaded_file_4_0_2($HTTP_POST_FILES['userfile'])) { copy($HTTP_POST_FILES['userfile'], "/dossier/ou/placer/un/fichier/uploadé"); } else { @@ -95,16 +96,16 @@ } ?> ]]> - </programlisting> - </example> - <para> - Voir aussi - <function>move_uploaded_file</function>, et la section sur - <link linkend="features.file-upload">la gestion des téléchargements</link> - pour un exemple simple. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + <para> + Voir aussi + <function>move_uploaded_file</function>, et la section sur + <link linkend="features.file-upload">la gestion des téléchargements</link> + pour un exemple simple. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -125,4 +126,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-writable.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-writable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.13 phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/is-writable.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-writable.xml Wed Feb 7 22:06:29 2007 @@ -1,54 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-writable"> - <refnamediv> - <refname>is_writable</refname> - <refpurpose>Indique si un fichier est autorisé en écriture</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_writable</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_writable</function> retourne &true; si - <parameter>filename</parameter> existe et est accessible en écriture. - </para> - <para> - N'oubliez pas que &php; accède aux fichiers avec les mêmes - autorisations que l'utilisateur qui fait tourner le serveur web - (souvent, c'est '<literal>nobody</literal>', personne). - </para> - <para> - <example> - <title>Exemple avec <function>is_writable</function></title> - <programlisting role="php"> + +<refentry id="function.is-writable"> + <refnamediv> + <refname>is_writable</refname> + <refpurpose>Indique si un fichier est autorisé en écriture</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_writable</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>is_writable</function> retourne &true; si + <parameter>filename</parameter> existe et est accessible en écriture. + </para> + <para> + N'oubliez pas que &php; accède aux fichiers avec les mêmes + autorisations que l'utilisateur qui fait tourner le serveur web + (souvent, c'est '<literal>nobody</literal>', personne). + </para> + <para> + <example> + <title>Exemple avec <function>is_writable</function></title> + <programlisting role="php"> <![CDATA[ <?php $filename = 'test.txt'; if (is_writable($filename)) { - echo 'Le fichier est accessible en écriture'; + echo 'Le fichier est accessible en écriture'; } else { - echo 'Le fichier n\'est pas accessible en écriture'; + echo 'Le fichier n\'est pas accessible en écriture'; } ?> ]]> - </programlisting> - </example> - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; + </programlisting> + </example> + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; <para> Voir aussi - <function>is_readable</function>, - <function>file_exists</function> et - <function>fwrite</function>. - </para> - </refsect1> - </refentry> + <function>is_readable</function>, + <function>file_exists</function> et + <function>fwrite</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/is-writeable.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/is-writeable.xml diff -u phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.10 phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.11 --- phpdoc-fr/reference/filesystem/functions/is-writeable.xml:1.10 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/is-writeable.xml Wed Feb 7 22:06:29 2007 @@ -1,13 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.is-writeable"> <refnamediv> <refname>is_writeable</refname> <refpurpose>&Alias; <function>is_writable</function></refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <simpara> @@ -36,4 +37,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/lchgrp.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/lchgrp.xml diff -u phpdoc-fr/reference/filesystem/functions/lchgrp.xml:1.1 phpdoc-fr/reference/filesystem/functions/lchgrp.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/lchgrp.xml:1.1 Tue May 2 22:56:56 2006 +++ phpdoc-fr/reference/filesystem/functions/lchgrp.xml Wed Feb 7 22:06:29 2007 @@ -1,40 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.lchgrp"> - <refnamediv> - <refname>lchgrp</refname> - <refpurpose>Change l'appartenance du groupe d'un lien symbolique</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>lchgrp</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>group</parameter></methodparam> - </methodsynopsis> - <para> - Essaie de remplacer le groupe du lien symbolique - <parameter>filename</parameter> par le groupe - <parameter>group</parameter> (spécifié par son nom ou son numéro). Seul le - super-utilisateur peut changer le groupe d'un lien symbolique - arbitrairement; les autres utilisateurs peuvent changer le groupe d'un - lien symbolique vers un groupe auquel cet utilisateur est membre. - </para> - <para> - &return.success; - </para> - &note.no-remote; - &note.sm.uidcheck; - <para> - Voir aussi <function>chgrp</function>, - <function>lchown</function> - <function>chown</function>&listendand; - <function>chmod</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.lchgrp"> + <refnamediv> + <refname>lchgrp</refname> + <refpurpose>Change l'appartenance du groupe d'un lien symbolique</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>lchgrp</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>mixed</type><parameter>group</parameter></methodparam> + </methodsynopsis> + <para> + Essaie de remplacer le groupe du lien symbolique + <parameter>filename</parameter> par le groupe + <parameter>group</parameter> (spécifié par son nom ou son numéro). Seul le + super-utilisateur peut changer le groupe d'un lien symbolique + arbitrairement; les autres utilisateurs peuvent changer le groupe d'un + lien symbolique vers un groupe auquel cet utilisateur est membre. + </para> + <para> + &return.success; + </para> + &note.no-remote; + &note.sm.uidcheck; + <para> + Voir aussi <function>chgrp</function>, + <function>lchown</function> + <function>chown</function>&listendand; + <function>chmod</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -55,4 +56,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/lchown.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/lchown.xml diff -u phpdoc-fr/reference/filesystem/functions/lchown.xml:1.1 phpdoc-fr/reference/filesystem/functions/lchown.xml:1.2 --- phpdoc-fr/reference/filesystem/functions/lchown.xml:1.1 Tue May 2 22:56:56 2006 +++ phpdoc-fr/reference/filesystem/functions/lchown.xml Wed Feb 7 22:06:29 2007 @@ -1,38 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: jsgoupil Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.lchown"> - <refnamediv> - <refname>lchown</refname> - <refpurpose>Change l'appartenance du propriétaire d'un lien symbolique</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>lchown</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>mixed</type><parameter>user</parameter></methodparam> - </methodsynopsis> - <para> - Essaie de remplacer le propriétaire du lien symbolique - <parameter>filename</parameter> par l'utilisateur - <parameter>user</parameter> (spécifié par son nom ou son numéro). Seul le - super-utilisateur peut changer le propriétaire d'un lien symbolique. - </para> - <para> - &return.success; - </para> - &note.no-remote; - &note.sm.uidcheck; - <para> - Voyez aussi <function>chown</function>, - <function>lchgrp</function>, - <function>chgrp</function>&listendand; - <function>chmod</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.lchown"> + <refnamediv> + <refname>lchown</refname> + <refpurpose>Change l'appartenance du propriétaire d'un lien symbolique</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>lchown</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>mixed</type><parameter>user</parameter></methodparam> + </methodsynopsis> + <para> + Essaie de remplacer le propriétaire du lien symbolique + <parameter>filename</parameter> par l'utilisateur + <parameter>user</parameter> (spécifié par son nom ou son numéro). Seul le + super-utilisateur peut changer le propriétaire d'un lien symbolique. + </para> + <para> + &return.success; + </para> + &note.no-remote; + &note.sm.uidcheck; + <para> + Voyez aussi <function>chown</function>, + <function>lchgrp</function>, + <function>chgrp</function>&listendand; + <function>chmod</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -53,4 +54,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/linkinfo.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/linkinfo.xml diff -u phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.11 phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/linkinfo.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/linkinfo.xml Wed Feb 7 22:06:29 2007 @@ -1,32 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.linkinfo"> - <refnamediv> - <refname>linkinfo</refname> - <refpurpose>Renvoie les informations d'un lien</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>linkinfo</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - </methodsynopsis> - <para> - <function>linkinfo</function> renvoie les informations - du lien <parameter>path</parameter>, c'est-à-dire le champ <literal>st_dev</literal> - de la structure C UNIX retournée par <literal>lstat</literal>. - (comme en langage C). <function>linkinfo</function> sert à vérifier - si le lien identifié par <parameter>path</parameter> - existe, en utilisant la même méthode que la macro - <literal>S_ISLNK</literal> de <filename>stat.h</filename>. - <function>linkinfo</function> retourne &false; en cas d'erreur. - </para> - <para> - <example> - <title>Exemple avec <function>linkinfo</function></title> - <programlisting role="php"> + +<refentry id="function.linkinfo"> + <refnamediv> + <refname>linkinfo</refname> + <refpurpose>Renvoie les informations d'un lien</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>linkinfo</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + </methodsynopsis> + <para> + <function>linkinfo</function> renvoie les informations + du lien <parameter>path</parameter>, c'est-à-dire le champ <literal>st_dev</literal> + de la structure C UNIX retournée par <literal>lstat</literal>. + (comme en langage C). <function>linkinfo</function> sert à vérifier + si le lien identifié par <parameter>path</parameter> + existe, en utilisant la même méthode que la macro + <literal>S_ISLNK</literal> de <filename>stat.h</filename>. + <function>linkinfo</function> retourne &false; en cas d'erreur. + </para> + <para> + <example> + <title>Exemple avec <function>linkinfo</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -34,18 +35,18 @@ ?> ]]> - </programlisting> - </example> - </para> - &note.no-windows; - <para> - Voir aussi - <function>symlink</function>, - <function>link</function> et - <function>readlink</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.no-windows; + <para> + Voir aussi + <function>symlink</function>, + <function>link</function> et + <function>readlink</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -66,4 +67,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/link.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/link.xml diff -u phpdoc-fr/reference/filesystem/functions/link.xml:1.13 phpdoc-fr/reference/filesystem/functions/link.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/link.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/link.xml Wed Feb 7 22:06:29 2007 @@ -1,34 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.link"> - <refnamediv> - <refname>link</refname> - <refpurpose>Crée un lien</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>link</methodname> - <methodparam><type>string</type><parameter>target</parameter></methodparam> - <methodparam><type>string</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para> - <function>link</function> crée un lien entre le fichier source - <parameter>link</parameter> et le fichier de destination - <parameter>target</parameter>. &return.success; - </para> - &note.no-remote; - &note.no-windows; - <para> - Voir aussi - <function>symlink</function> pour créer des liens symboliques, - <function>readlink</function> et - <function>linkinfo</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.link"> + <refnamediv> + <refname>link</refname> + <refpurpose>Crée un lien</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>link</methodname> + <methodparam><type>string</type><parameter>target</parameter></methodparam> + <methodparam><type>string</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para> + <function>link</function> crée un lien entre le fichier source + <parameter>link</parameter> et le fichier de destination + <parameter>target</parameter>. &return.success; + </para> + &note.no-remote; + &note.no-windows; + <para> + Voir aussi + <function>symlink</function> pour créer des liens symboliques, + <function>readlink</function> et + <function>linkinfo</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -49,4 +50,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/lstat.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/lstat.xml diff -u phpdoc-fr/reference/filesystem/functions/lstat.xml:1.11 phpdoc-fr/reference/filesystem/functions/lstat.xml:1.12 --- phpdoc-fr/reference/filesystem/functions/lstat.xml:1.11 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/lstat.xml Wed Feb 7 22:06:29 2007 @@ -1,40 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.lstat"> - <refnamediv> - <refname>lstat</refname> - <refpurpose> - Retourne les informations sur n fichier ou un lien symbolique - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>lstat</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>lstat</function> renvoie les informations sur le - fichier <parameter>filename</parameter>. Cette fonction est identique à - la fonction <function>stat</function> hormis le fait que si - <parameter>filename</parameter> est un lien symbolique, les informations - seront alors basées sur le lien symbolique. - </para> - <para> - Voyez la page de manuel de <function>stat</function> pour plus d'informations - sur la structure du tableau retourné par <function>lstat</function>. - </para> - &tip.fopen-wrapper.stat; +<refentry id="function.lstat"> + <refnamediv> + <refname>lstat</refname> + <refpurpose> + Retourne les informations sur n fichier ou un lien symbolique + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>lstat</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>lstat</function> renvoie les informations sur le + fichier <parameter>filename</parameter>. Cette fonction est identique à + la fonction <function>stat</function> hormis le fait que si + <parameter>filename</parameter> est un lien symbolique, les informations + seront alors basées sur le lien symbolique. + </para> + <para> + Voyez la page de manuel de <function>stat</function> pour plus d'informations + sur la structure du tableau retourné par <function>lstat</function>. + </para> - &note.clearstatcache; - <simpara> - Voir aussi <function>stat</function>. - </simpara> - </refsect1> - </refentry> + &tip.fopen-wrapper.stat; + + &note.clearstatcache; + <simpara> + Voir aussi <function>stat</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -55,4 +56,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/mkdir.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/mkdir.xml diff -u phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.14 phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/mkdir.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/mkdir.xml Wed Feb 7 22:06:29 2007 @@ -1,78 +1,79 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.17 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.mkdir"> - <refnamediv> - <refname>mkdir</refname> - <refpurpose>Crée un dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>mkdir</methodname> - <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>recursive</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> - </methodsynopsis> - <para> - <function>mkdir</function> tente de créer un dossier dans - le chemin <parameter>pathname</parameter>. - </para> - <para> - Notez que vous aurez à préciser le mode en base octale, - ce qui signifie que vous aurez probablement un 0 comme premier chiffre. - Le mode sera aussi modifié par le umask courant, que vous pouvez - modifier avec la fonction <function>umask</function>. - </para> + +<refentry id="function.mkdir"> + <refnamediv> + <refname>mkdir</refname> + <refpurpose>Crée un dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>mkdir</methodname> + <methodparam><type>string</type><parameter>pathname</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>recursive</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> + <para> + <function>mkdir</function> tente de créer un dossier dans + le chemin <parameter>pathname</parameter>. + </para> + <para> + Notez que vous aurez à préciser le mode en base octale, + ce qui signifie que vous aurez probablement un 0 comme premier chiffre. + Le mode sera aussi modifié par le umask courant, que vous pouvez + modifier avec la fonction <function>umask</function>. + </para> + <para> + <note> <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> + Le paramètre <parameter>mode</parameter> est ignoré sous Windows, + et il est devenu optionnel depuis &php; 4.2.0. </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"> + </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"> <![CDATA[ <?php - mkdir ("/chemin/de/mon/dossier", 0700); +mkdir ("/chemin/de/mon/dossier", 0700); ?> ]]> - </programlisting> - </example> - </para> - <para> - &return.success; - </para> - <note> - <simpara> - Depuis &php; 5.0.0, la fonction <function>mkdir</function> peut aussi - être utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. - Reportez-vous à <xref linkend="wrappers"/>, pour une liste des - gestionnaires qui supportent <function>mkdir</function>. - </simpara> - </note> - &note.context-support; - <note> - <simpara> - Le paramètre <parameter>recursive</parameter>a été ajouté en &php; 5.0.0. - </simpara> - </note> - &note.sm.uidcheck.dir; - <para> - Voir aussi - <function>rmdir</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + &return.success; + </para> + <note> + <simpara> + Depuis &php; 5.0.0, la fonction <function>mkdir</function> peut aussi + être utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. + Reportez-vous à <xref linkend="wrappers"/>, pour une liste des + gestionnaires qui supportent <function>mkdir</function>. + </simpara> + </note> + &note.context-support; + <note> + <simpara> + Le paramètre <parameter>recursive</parameter>a été ajouté en &php; 5.0.0. + </simpara> + </note> + &note.sm.uidcheck.dir; + <para> + Voir aussi + <function>rmdir</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -93,4 +94,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml diff -u phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.12 phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/move-uploaded-file.xml Wed Feb 7 22:06:29 2007 @@ -1,69 +1,70 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.move-uploaded-file"> - <refnamediv> - <refname>move_uploaded_file</refname> - <refpurpose>Déplace un fichier téléchargé</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <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> s'assure que le fichier - <parameter>filename</parameter> est un fichier téléchargé - par HTTP POST. Si le fichier est valide, il est déplacé - jusqu'à <parameter>destination</parameter>. - </para> - <para> - Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, - et <function>move_uploaded_file</function> retournera &false;. - </para> - <para> - Si <parameter>filename</parameter> est un fichier - téléchargé, mais que pour une raison - quelconque, il ne peut être déplacé, rien ne se passe, - et <function>move_uploaded_file</function> retourne &false;. - De plus, une alerte sera affichée. - </para> + +<refentry id="function.move-uploaded-file"> + <refnamediv> + <refname>move_uploaded_file</refname> + <refpurpose>Déplace un fichier téléchargé</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <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> s'assure que le fichier + <parameter>filename</parameter> est un fichier téléchargé + par HTTP POST. Si le fichier est valide, il est déplacé + jusqu'à <parameter>destination</parameter>. + </para> + <para> + Si <parameter>filename</parameter> n'est pas valide, rien ne se passe, + et <function>move_uploaded_file</function> retournera &false;. + </para> + <para> + Si <parameter>filename</parameter> est un fichier + téléchargé, mais que pour une raison + quelconque, il ne peut être déplacé, rien ne se passe, + et <function>move_uploaded_file</function> retourne &false;. + De plus, une alerte sera affichée. + </para> + <para> + Ce type de vérification est spécialement important s'il + est possible que les fichiers téléchargés + révèlent leur contenu à l'utilisateur, + ou même aux utilisateurs du même système. + </para> + <note> <para> - Ce type de vérification est spécialement important s'il - est possible que les fichiers téléchargés - révèlent leur contenu à l'utilisateur, - ou même aux utilisateurs du même système. + <function>move_uploaded_file</function> n'est pas affectée par + les restrictions liées au &safemode; et à l'<link + linkend="ini.open-basedir">open_basedir</link>. + Cependant, les restrictions sont placées uniquement sur le + paramètre <parameter>destination</parameter> qui permet le + déplacement des fichiers chargés dans lesquels + <parameter>filename</parameter> peut entrer en conflit avec ces + restrictions. <function>move_uploaded_file</function> permet de + s'assurer de la sécurité de cette opération en autorisant le + déplacement des seuls fichiers chargés via &php;. </para> - <note> - <para> - <function>move_uploaded_file</function> n'est pas affectée par - les restrictions liées au &safemode; et à l'<link - linkend="ini.open-basedir">open_basedir</link>. - Cependant, les restrictions sont placées uniquement sur le - paramètre <parameter>destination</parameter> qui permet le - déplacement des fichiers chargés dans lesquels - <parameter>filename</parameter> peut entrer en conflit avec ces - restrictions. <function>move_uploaded_file</function> permet de - s'assurer de la sécurité de cette opération en autorisant le - déplacement des seuls fichiers chargés via &php;. - </para> - </note> - <warning> - <para> - Si le fichier de destination existe déjà, il sera écrasé. - </para> - </warning> + </note> + <warning> <para> - Voir aussi - <function>is_uploaded_file</function>, et la section sur la gestion - <link linkend="features.file-upload">des téléchargements de fichiers</link> - pour un exemple simple d'utilisation. + Si le fichier de destination existe déjà, il sera écrasé. </para> - </refsect1> - </refentry> + </warning> + <para> + Voir aussi + <function>is_uploaded_file</function>, et la section sur la gestion + <link linkend="features.file-upload">des téléchargements de fichiers</link> + pour un exemple simple d'utilisation. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -84,4 +85,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml?r1=1.23&r2=1.24&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.23 phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.24 --- phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml:1.23 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/parse-ini-file.xml Wed Feb 7 22:06:29 2007 @@ -1,92 +1,92 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.23 $ --> -<!-- EN-Revision: 1.23 Maintainer: dams Status: ready --> +<!-- $Revision: 1.24 $ --> +<!-- EN-Revision: 1.24 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.parse-ini-file"> - <refnamediv> - <refname>parse_ini_file</refname> - <refpurpose>Traite un fichier de configuration</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>parse_ini_file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>process_sections</parameter></methodparam> - </methodsynopsis> - <para> - <function>parse_ini_file</function> charge le fichier - <parameter>filename</parameter> et retourne les - configurations qui s'y trouvent sous forme d'un tableau - associatif. En passant le deuxième paramètre optionnel - à <parameter>process_sections</parameter>, vous obtiendrez - un tableau multi-dimensionnel avec les noms des sections. - La valeur par défaut de ce paramètre est &false; +<refentry id="function.parse-ini-file"> + <refnamediv> + <refname>parse_ini_file</refname> + <refpurpose>Traite un fichier de configuration</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>parse_ini_file</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>process_sections</parameter></methodparam> + </methodsynopsis> + <para> + <function>parse_ini_file</function> charge le fichier + <parameter>filename</parameter> et retourne les + configurations qui s'y trouvent sous forme d'un tableau + associatif. En passant le deuxième paramètre optionnel + à <parameter>process_sections</parameter>, vous obtiendrez + un tableau multi-dimensionnel avec les noms des sections. + La valeur par défaut de ce paramètre est &false; + </para> + <note> + <para> + Cette fonction n'a rien a voir avec le fichier + &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. </para> - <note> - <para> - Cette fonction n'a rien a voir avec le fichier - &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. - </para> - </note> - <para> - La structure des fichiers de configuration lus est similaire - à celle de &php.ini;. + </note> + <para> + La structure des fichiers de configuration lus est similaire + à celle de &php.ini;. + </para> + <note> + <para> + Si une valeur du fichier <filename>.ini</filename> contient des + données non-alphanumériques, il faut la protéger en la plaçant + entre guillemets doubles ("). </para> - <note> - <para> - Si une valeur du fichier <filename>.ini</filename> contient des - données non-alphanumériques, 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> - <note> - <para> - Depuis &php; 5.0, cette fonction gère aussi les nouvelles lignes dans les - valeurs. - </para> - </note> - <note> - <simpara> - Il y a des mots réservés qui ne doivent pas être utilisés en tant que clés - dans les fichiers ini. Cela inclut : - <literal>null</literal>, - <literal>yes</literal>, - <literal>no</literal>, - <literal>true</literal> et - <literal>false</literal>. - Les valeurs <literal>null</literal>, <literal>no</literal> et - <literal>false</literal> donnent "", <literal>yes</literal> et - <literal>true</literal> donnent "1". - Les caractères <literal>{}|&amp;~![()"</literal> ne doivent pas être utilisés - n'importe où dans la clé et ont une signification spéciale dans la valeur. - </simpara> - </note> - <para> - La structure 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 constantes. Par exemple : - </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> + <note> <para> - <example> - <title>Contenu de <filename>sample.ini</filename></title> - <programlisting> + Depuis &php; 5.0, cette fonction gère aussi les nouvelles lignes dans les + valeurs. + </para> + </note> + <note> + <simpara> + Il y a des mots réservés qui ne doivent pas être utilisés en tant que clés + dans les fichiers ini. Cela inclut : + <literal>null</literal>, + <literal>yes</literal>, + <literal>no</literal>, + <literal>true</literal> et + <literal>false</literal>. + Les valeurs <literal>null</literal>, <literal>no</literal> et + <literal>false</literal> donnent "", <literal>yes</literal> et + <literal>true</literal> donnent "1". + Les caractères <literal>{}|&amp;~![()"</literal> ne doivent pas être utilisés + n'importe où dans la clé et ont une signification spéciale dans la valeur. + </simpara> + </note> + <para> + La structure 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 constantes. Par exemple : + </para> + <para> + <example> + <title>Contenu de <filename>sample.ini</filename></title> + <programlisting> <![CDATA[ ; Ceci est un fichier de configuration ; Les commentaires commencent par ';', comme dans php.ini @@ -100,13 +100,13 @@ chemin = "/usr/local/bin" URL = "http://www.example.com/~utilisateur" ]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Exemple avec <function>parse_ini_file</function></title> - <programlisting> + </programlisting> + </example> + </para> + <para> + <example> + <title>Exemple avec <function>parse_ini_file</function></title> + <programlisting> <![CDATA[ <?php @@ -122,9 +122,9 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -137,31 +137,31 @@ Array ( [premiere_section] => Array - ( - [un] => 1 - [cinq] => 5 - [animal] => dodu dodo - ) + ( + [un] => 1 + [cinq] => 5 + [animal] => dodu dodo + ) [seconde_section] => Array - ( - [chemin] => /usr/local/bin - [URL] => http://www.example.com/~utilisateur - ) + ( + [chemin] => /usr/local/bin + [URL] => http://www.example.com/~utilisateur + ) ) ]]> - </screen> - </example> - </para> - <para> - Si les clés et les noms des sections sont des nombres, ils seront évalués - comme des &integer; &php;. Les nombres commençant par &zero; sont - évalués comme octal et les nombres commençant par 0x sont évalués - comme hexadécimal. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + Si les clés et les noms des sections sont des nombres, ils seront évalués + comme des &integer; &php;. Les nombres commençant par &zero; sont + évalués comme octal et les nombres commençant par 0x sont évalués + comme hexadécimal. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/pathinfo.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/pathinfo.xml diff -u phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.16 phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.17 --- phpdoc-fr/reference/filesystem/functions/pathinfo.xml:1.16 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/pathinfo.xml Wed Feb 7 22:06:29 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.12 Maintainer: dams Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> <refentry id="function.pathinfo"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/pclose.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/pclose.xml diff -u phpdoc-fr/reference/filesystem/functions/pclose.xml:1.9 phpdoc-fr/reference/filesystem/functions/pclose.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/pclose.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/pclose.xml Wed Feb 7 22:06:29 2007 @@ -1,36 +1,37 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.pclose"> - <refnamediv> - <refname>pclose</refname> - <refpurpose>Ferme un processus de pointeur de fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>pclose</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>pclose</function> ferme le processus de pointeur de fichier - <parameter>handle</parameter>, ouvert par <function>popen</function>. - </para> - <para> - Le pointeur de fichier doit être valide, et avoir - été ouvert correctement par <function>popen</function>. - </para> - <para> - <function>pclose</function> retourne le statut final du processus - exécuté. - </para> - <para> - Voir aussi - <function>popen</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.pclose"> + <refnamediv> + <refname>pclose</refname> + <refpurpose>Ferme un processus de pointeur de fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>pclose</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>pclose</function> ferme le processus de pointeur de fichier + <parameter>handle</parameter>, ouvert par <function>popen</function>. + </para> + <para> + Le pointeur de fichier doit être valide, et avoir + été ouvert correctement par <function>popen</function>. + </para> + <para> + <function>pclose</function> retourne le statut final du processus + exécuté. + </para> + <para> + Voir aussi + <function>popen</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -51,4 +52,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/popen.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/popen.xml diff -u phpdoc-fr/reference/filesystem/functions/popen.xml:1.13 phpdoc-fr/reference/filesystem/functions/popen.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/popen.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/popen.xml Wed Feb 7 22:06:29 2007 @@ -1,82 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.popen"> - <refnamediv> - <refname>popen</refname> - <refpurpose>Crée un processus de pointeur de fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 <parameter>command</parameter>. - </para> - <para> - <function>popen</function> retourne un pointeur de fichier - identique à celui retourné par <function>fopen</function>, - hormis le fait qu'il sera unidirectionnel (lecture seule, ou - écriture seule), et doit être terminé par - <function>pclose</function>. Ce pointeur peut être utilisé - avec <function>fgets</function>, <function>fgetss</function> et - <function>fputs</function>. - </para> - <para> - Si une erreur survient, retourne &false;. - </para> - <para> - <example> + +<refentry id="function.popen"> + <refnamediv> + <refname>popen</refname> + <refpurpose>Crée un processus de pointeur de fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 <parameter>command</parameter>. + </para> + <para> + <function>popen</function> retourne un pointeur de fichier + identique à celui retourné par <function>fopen</function>, + hormis le fait qu'il sera unidirectionnel (lecture seule, ou + écriture seule), et doit être terminé par + <function>pclose</function>. Ce pointeur peut être utilisé + avec <function>fgets</function>, <function>fgetss</function> et + <function>fputs</function>. + </para> + <para> + Si une erreur survient, retourne &false;. + </para> + <para> + <example> <title>Exemple avec <function>popen</function></title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php - $handle = popen ("/bin/ls", "r"); +$handle = popen ("/bin/ls", "r"); ?> ]]> - </programlisting> - </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'erreur qui ont été - retournés par le Shell : - <example> - <title>Lire des messages d'erreurs avec <function>popen</function></title> - <programlisting role="php"> + </programlisting> + </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'erreur qui ont été + retournés par le Shell : + <example> + <title>Lire des messages d'erreurs avec <function>popen</function></title> + <programlisting role="php"> <![CDATA[ <?php - error_reporting(E_ALL); +error_reporting(E_ALL); /* Ajoute une redirection pour que vous puissiez lire stderr */ - $handle = popen('/chemin/vers/spooge 2>&1', 'r'); - echo "'$handle'; " . gettype($handle) . "\n"; - $read = fread($handle, 2096); - echo $read; - pclose($handle); +$handle = popen('/chemin/vers/spooge 2>&1', 'r'); +echo "'$handle'; " . gettype($handle) . "\n"; +$read = fread($handle, 2096); +echo $read; +pclose($handle); ?> ]]> - </programlisting> - </example> - </para> - </note> - &note.exec-path; - &warn.sm.exec; - <para> - Voir aussi - <function>pclose</function>, - <function>fopen</function> et - <function>proc_open</function>. + </programlisting> + </example> </para> - </refsect1> - </refentry> + </note> + &note.exec-path; + &warn.sm.exec; + <para> + Voir aussi + <function>pclose</function>, + <function>fopen</function> et + <function>proc_open</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -97,4 +98,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/readfile.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/readfile.xml diff -u phpdoc-fr/reference/filesystem/functions/readfile.xml:1.12 phpdoc-fr/reference/filesystem/functions/readfile.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/readfile.xml:1.12 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/readfile.xml Wed Feb 7 22:06:29 2007 @@ -1,54 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.readfile"> - <refnamediv> - <refname>readfile</refname> - <refpurpose>Affiche un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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'envoie à la sortie standard. - </para> - <para> - <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. - 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 - <parameter>use_include_path</parameter> - pour explorer le dossier <link linkend="ini.include-path">include_path</link>, - en passant la valeur de &true;. - </para> - <para> - Vous pouvez utiliser le contexte <parameter>context</parameter> - pour configurer les accès aux fichiers distants. - </para> - &note.context-support; - <para> - Voir aussi - <function>fpassthru</function>, - <function>file</function>, - <function>fopen</function>, - <function>include</function>, - <function>file_get_contents</function>, - <xref linkend="wrappers"/>, - <function>require</function> et - <function>virtual</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.readfile"> + <refnamediv> + <refname>readfile</refname> + <refpurpose>Affiche un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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'envoie à la sortie standard. + </para> + <para> + <function>readfile</function> retourne le nombre d'octets lus depuis le fichier. + 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 + <parameter>use_include_path</parameter> + pour explorer le dossier <link linkend="ini.include-path">include_path</link>, + en passant la valeur de &true;. + </para> + <para> + Vous pouvez utiliser le contexte <parameter>context</parameter> + pour configurer les accès aux fichiers distants. + </para> + &note.context-support; + <para> + Voir aussi + <function>fpassthru</function>, + <function>file</function>, + <function>fopen</function>, + <function>include</function>, + <function>file_get_contents</function>, + <xref linkend="wrappers"/>, + <function>require</function> et + <function>virtual</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -69,4 +70,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/readlink.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/readlink.xml diff -u phpdoc-fr/reference/filesystem/functions/readlink.xml:1.13 phpdoc-fr/reference/filesystem/functions/readlink.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/readlink.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/readlink.xml Wed Feb 7 22:06:29 2007 @@ -1,30 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.readlink"> - <refnamediv> - <refname>readlink</refname> - <refpurpose> - Renvoie le nom du fichier vers lequel pointe un lien symbolique - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>readlink</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - </methodsynopsis> - <para> - <function>readlink</function> fait la même chose que la fonction - <literal>readlink</literal> en C. Elle retourne le contenu du lien symbolique - repéré par <parameter>path</parameter>, - ou &false; en cas d'erreur. - </para> - <para> - <example> - <title>Exemple avec <function>readlink</function></title> - <programlisting role="php"> + +<refentry id="function.readlink"> + <refnamediv> + <refname>readlink</refname> + <refpurpose> + Renvoie le nom du fichier vers lequel pointe un lien symbolique + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>readlink</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + </methodsynopsis> + <para> + <function>readlink</function> fait la même chose que la fonction + <literal>readlink</literal> en C. Elle retourne le contenu du lien symbolique + repéré par <parameter>path</parameter>, + ou &false; en cas d'erreur. + </para> + <para> + <example> + <title>Exemple avec <function>readlink</function></title> + <programlisting role="php"> <![CDATA[ <?php @@ -33,18 +34,18 @@ ?> ]]> - </programlisting> - </example> - </para> - &note.no-windows; - <para> - Voir aussi - <function>is_link</function>, - <function>symlink</function> et - <function>linkinfo</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + &note.no-windows; + <para> + Voir aussi + <function>is_link</function>, + <function>symlink</function> et + <function>linkinfo</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,4 +66,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/realpath.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/realpath.xml diff -u phpdoc-fr/reference/filesystem/functions/realpath.xml:1.13 phpdoc-fr/reference/filesystem/functions/realpath.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/realpath.xml:1.13 Sat Jan 27 14:44:43 2007 +++ phpdoc-fr/reference/filesystem/functions/realpath.xml Wed Feb 7 22:06:29 2007 @@ -1,61 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.realpath"> - <refnamediv> - <refname>realpath</refname> - <refpurpose>Retourne le chemin canonique absolu</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>realpath</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - </methodsynopsis> - <para> - <function>realpath</function> résout tous les liens symboliques, et - remplace toutes les références <literal>/./</literal>, <literal>/../</literal> - et <literal>/</literal> de - <parameter>path</parameter> puis retourne le chemin canonique absolu - ainsi trouvé. Le résultat ne contient aucun lien symbolique, - <literal>/./</literal> ou <literal>/../</literal>. - </para> - <para> - <function>realpath</function> retourne &false; si une erreur survient, e.g. - si le fichier n'existe pas. Sous les systèmes BSD, <function>realpath</function> - n'échouera pas s'il manque que le dernier composant du paramètre - <parameter>path</parameter>, alors que les autres systèmes retourneront - &false;. - </para> - <para> - <example> - <title>Exemple avec <function>realpath</function></title> - <programlisting role="php"> +<refentry id="function.realpath"> + <refnamediv> + <refname>realpath</refname> + <refpurpose>Retourne le chemin canonique absolu</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>realpath</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + </methodsynopsis> + <para> + <function>realpath</function> résout tous les liens symboliques, et + remplace toutes les références <literal>/./</literal>, <literal>/../</literal> + et <literal>/</literal> de + <parameter>path</parameter> puis retourne le chemin canonique absolu + ainsi trouvé. Le résultat ne contient aucun lien symbolique, + <literal>/./</literal> ou <literal>/../</literal>. + </para> + <para> + <function>realpath</function> retourne &false; si une erreur survient, e.g. + si le fichier n'existe pas. Sous les systèmes BSD, <function>realpath</function> + n'échouera pas s'il manque que le dernier composant du paramètre + <parameter>path</parameter>, alors que les autres systèmes retourneront + &false;. + </para> + <para> + <example> + <title>Exemple avec <function>realpath</function></title> + <programlisting role="php"> <![CDATA[ <?php chdir('/var/www/'); echo realpath('./../../etc/passwd'); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ /etc/passwd ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>basename</function>, - <function>dirname</function> et - <function>pathinfo</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + Voir aussi + <function>basename</function>, + <function>dirname</function> et + <function>pathinfo</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/rename.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/rename.xml diff -u phpdoc-fr/reference/filesystem/functions/rename.xml:1.14 phpdoc-fr/reference/filesystem/functions/rename.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/rename.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/rename.xml Wed Feb 7 22:06:29 2007 @@ -1,69 +1,70 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.rename"> - <refnamediv> - <refname>rename</refname> - <refpurpose>Renomme un fichier ou un dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>rename</methodname> - <methodparam><type>string</type><parameter>oldname</parameter></methodparam> - <methodparam><type>string</type><parameter>newname</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> - </methodsynopsis> - <para> - <function>rename</function> tente de renommer - <parameter>oldname</parameter> en <parameter>newname</parameter>. - </para> - <para> - &return.success; - </para> - <para> - <example> - <title>Exemple avec <function>rename</function></title> - <programlisting role="php"> + +<refentry id="function.rename"> + <refnamediv> + <refname>rename</refname> + <refpurpose>Renomme un fichier ou un dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>rename</methodname> + <methodparam><type>string</type><parameter>oldname</parameter></methodparam> + <methodparam><type>string</type><parameter>newname</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> + <para> + <function>rename</function> tente de renommer + <parameter>oldname</parameter> en <parameter>newname</parameter>. + </para> + <para> + &return.success; + </para> + <para> + <example> + <title>Exemple avec <function>rename</function></title> + <programlisting role="php"> <![CDATA[ <?php rename("/tmp/tmp_file.txt", "/home/user/login/docs/mon_file.txt"); ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + <note> + <para> + Avant &php; 4.3.3, <function>rename</function> ne pouvait pas renommer + des fichiers entre différentes partitions Unix. </para> - <note> - <para> - Avant &php; 4.3.3, <function>rename</function> ne pouvait pas renommer - des fichiers entre différentes partitions Unix. - </para> - </note> - <note> - <simpara> - Depuis &php; 5.0.0, <function>rename</function> peut aussi être - utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. Reportez - vous à <xref linkend="wrappers"/> pour une liste des gestionnaires - qui supportent <function>rename</function>. - </simpara> - </note> - <note> - <simpara> - Le gestionnaire utilisé dans le paramètre <parameter>oldname</parameter> - <emphasis>DOIT</emphasis> être le même que celui utilisé dans - <parameter>newname</parameter>. - </simpara> - </note> - &note.context-support; - <para> - Voir aussi - <function>copy</function>, - <function>unlink</function> et - <function>move_uploaded_file</function>. - </para> - </refsect1> - </refentry> + </note> + <note> + <simpara> + Depuis &php; 5.0.0, <function>rename</function> peut aussi être + utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. Reportez + vous à <xref linkend="wrappers"/> pour une liste des gestionnaires + qui supportent <function>rename</function>. + </simpara> + </note> + <note> + <simpara> + Le gestionnaire utilisé dans le paramètre <parameter>oldname</parameter> + <emphasis>DOIT</emphasis> être le même que celui utilisé dans + <parameter>newname</parameter>. + </simpara> + </note> + &note.context-support; + <para> + Voir aussi + <function>copy</function>, + <function>unlink</function> et + <function>move_uploaded_file</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -84,4 +85,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/rewind.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/rewind.xml diff -u phpdoc-fr/reference/filesystem/functions/rewind.xml:1.13 phpdoc-fr/reference/filesystem/functions/rewind.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/rewind.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/rewind.xml Wed Feb 7 22:06:29 2007 @@ -1,41 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.rewind"> - <refnamediv> - <refname>rewind</refname> - <refpurpose>Replace le pointeur de fichier au début</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>rewind</methodname> - <methodparam><type>resource</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>rewind</function> replace le pointeur du fichier - <parameter>handle</parameter> au début. - &return.success; - </para> + +<refentry id="function.rewind"> + <refnamediv> + <refname>rewind</refname> + <refpurpose>Replace le pointeur de fichier au début</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>rewind</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>rewind</function> replace le pointeur du fichier + <parameter>handle</parameter> au début. + &return.success; + </para> + <para> + Le pointeur de fichier doit être valide, et avoir été + correctement ouvert par <function>fopen</function>. + </para> + <note> <para> - Le pointeur de fichier doit être valide, et avoir été - correctement ouvert par <function>fopen</function>. + Si vous avez ouvert le fichier en mode d'ajout ("a" ou "a+"), toutes les données + que vous écrirez dans ce fichier seront toujours ajoutées, sans se soucier + de la position du pointeur de fichier. </para> - <note> - <para> - Si vous avez ouvert le fichier en mode d'ajout ("a" ou "a+"), toutes les données - que vous écrirez dans ce fichier seront toujours ajoutées, sans se soucier - de la position du pointeur de fichier. - </para> - </note> - <para> - Voir aussi - <function>fseek</function> et - <function>ftell</function>. - </para> - </refsect1> - </refentry> + </note> + <para> + Voir aussi + <function>fseek</function> et + <function>ftell</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -56,4 +57,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/rmdir.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/rmdir.xml diff -u phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.13 phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/rmdir.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/rmdir.xml Wed Feb 7 22:06:29 2007 @@ -1,50 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.rmdir"> - <refnamediv> - <refname>rmdir</refname> - <refpurpose>Efface un dossier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>rmdir</methodname> - <methodparam><type>string</type><parameter>dirname</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> - </methodsynopsis> - <para> - <function>rmdir</function> tente d'effacer le dossier dont le chemin est - <parameter>dirname</parameter>. Le dossier doit être vide, - et le script doit avoir les autorisations adéquates. - </para> - <para> - &return.success; - </para> - <note> - <simpara> - Depuis &php; 5.0.0, <function>rmdir</function> peut aussi être - utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. Reportez - vous à <xref linkend="wrappers"/> pour une liste des gestionnaires - qui supportent <function>rmdir</function>. - </simpara> - </note> - <note> - <simpara> - Le paramètre <parameter>context</parameter> a été ajouté en - &php; 5.0.0. - </simpara> - </note> - &note.context-support; - &note.sm.uidcheck.dir; - <para> - Voir aussi - <function>mkdir</function> et - <function>unlink</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.rmdir"> + <refnamediv> + <refname>rmdir</refname> + <refpurpose>Efface un dossier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>rmdir</methodname> + <methodparam><type>string</type><parameter>dirname</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> + <para> + <function>rmdir</function> tente d'effacer le dossier dont le chemin est + <parameter>dirname</parameter>. Le dossier doit être vide, + et le script doit avoir les autorisations adéquates. + </para> + <para> + &return.success; + </para> + <note> + <simpara> + Depuis &php; 5.0.0, <function>rmdir</function> peut aussi être + utilisée avec <emphasis>certains</emphasis> gestionnaires d'URL. Reportez + vous à <xref linkend="wrappers"/> pour une liste des gestionnaires + qui supportent <function>rmdir</function>. + </simpara> + </note> + <note> + <simpara> + Le paramètre <parameter>context</parameter> a été ajouté en + &php; 5.0.0. + </simpara> + </note> + &note.context-support; + &note.sm.uidcheck.dir; + <para> + Voir aussi + <function>mkdir</function> et + <function>unlink</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,4 +66,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml diff -u phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.9 phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.10 --- phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml:1.9 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/set-file-buffer.xml Wed Feb 7 22:06:29 2007 @@ -1,13 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> + <refentry id="function.set-file-buffer"> <refnamediv> <refname>set_file_buffer</refname> <refpurpose>&Alias; <function>stream_set_write_buffer</function></refpurpose> </refnamediv> - + <refsect1 role="description"> &reftitle.description; <simpara> @@ -36,4 +37,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/stat.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/stat.xml diff -u phpdoc-fr/reference/filesystem/functions/stat.xml:1.17 phpdoc-fr/reference/filesystem/functions/stat.xml:1.18 --- phpdoc-fr/reference/filesystem/functions/stat.xml:1.17 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/stat.xml Wed Feb 7 22:06:29 2007 @@ -1,133 +1,133 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.13 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.stat"> - <refnamediv> - <refname>stat</refname> - <refpurpose>Renvoie les informations à propos d'un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>stat</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <para> - <function>stat</function> renvoie les informations à propos du - fichier <parameter>filename</parameter>. Si <parameter>filename</parameter> - est un lien symbolique, les informations proviennent du fichier lui-même, - et non du lien symbolique. <function>lstat</function> est identique à - <function>stat</function> sauf que les informations seront alors basées - sur le lien symbolique. - </para> - <para> - En cas d'erreurs, <function>stat</function> retourne &false;. Elle - générera aussi un avertissement. - </para> - <para> - Retourne un tableau avec des informations sur le fichier avec les - éléments suivants. Ce tableau commence à zéro. - En plus de retourner ces attributs dans un tableau indexé, - ils peuvent être accédés par leurs clés, comme - mentionné à côté de chaque paramètre ; ceci est - disponible depuis &php; 4.0.6 : - </para> - <para> - <table> - <title>Résultat de <function>stat</function> et <function>fstat</function></title> - <tgroup cols="3"> - <thead> - <row> - <entry>Numéro</entry> - <entry>Nom (depuis &php; 4.0.6)</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>dev</entry> - <entry>volume</entry> - </row> - <row> - <entry>1</entry> - <entry>ino</entry> - <entry>inode</entry> - </row> - <row> - <entry>2</entry> - <entry>mode</entry> - <entry>droits d'accès à l'inode</entry> - </row> - <row> - <entry>3</entry> - <entry>nlink</entry> - <entry>nombre de liens</entry> - </row> - <row> - <entry>4</entry> - <entry>uid</entry> - <entry>userid du propriétaire</entry> - </row> - <row> - <entry>5</entry> - <entry>gid</entry> - <entry>groupid du propriétaire</entry> - </row> - <row> - <entry>6</entry> - <entry>rdev</entry> - <entry>type de volume, si le volume est *</entry> - </row> - <row> - <entry>7</entry> - <entry>size</entry> - <entry>taille en octets</entry> - </row> - <row> - <entry>8</entry> - <entry>atime</entry> - <entry>date de dernier accès (Unix timestamp)</entry> - </row> - <row> - <entry>9</entry> - <entry>mtime</entry> - <entry>date de dernière modification (Unix timestamp)</entry> - </row> - <row> - <entry>10</entry> - <entry>ctime</entry> - <entry>date de dernier changement d'inode (Unix timestamp)</entry> - </row> - <row> - <entry>11</entry> - <entry>blksize</entry> - <entry>taille de bloc</entry> - </row> - <row> - <entry>12</entry> - <entry>blocks</entry> - <entry>nombre de blocs alloués</entry> - </row> - </tbody> - </tgroup> - </table> - * - uniquement sur les systèmes qui supportent le type <literal>st_blksize</literal>. - Les autres systèmes (e.g. Windows) retournent -1. - </para> - &note.clearstatcache; - &tip.fopen-wrapper.stat; - <para> - Voir aussi - <function>lstat</function>, - <function>fstat</function>, - <function>filemtime</function> et - <function>filegroup</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.stat"> + <refnamediv> + <refname>stat</refname> + <refpurpose>Renvoie les informations à propos d'un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>stat</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + </methodsynopsis> + <para> + <function>stat</function> renvoie les informations à propos du + fichier <parameter>filename</parameter>. Si <parameter>filename</parameter> + est un lien symbolique, les informations proviennent du fichier lui-même, + et non du lien symbolique. <function>lstat</function> est identique à + <function>stat</function> sauf que les informations seront alors basées + sur le lien symbolique. + </para> + <para> + En cas d'erreurs, <function>stat</function> retourne &false;. Elle + générera aussi un avertissement. + </para> + <para> + Retourne un tableau avec des informations sur le fichier avec les + éléments suivants. Ce tableau commence à zéro. + En plus de retourner ces attributs dans un tableau indexé, + ils peuvent être accédés par leurs clés, comme + mentionné à côté de chaque paramètre ; ceci est + disponible depuis &php; 4.0.6 : + </para> + <para> + <table> + <title>Résultat de <function>stat</function> et <function>fstat</function></title> + <tgroup cols="3"> + <thead> + <row> + <entry>Numéro</entry> + <entry>Nom (depuis &php; 4.0.6)</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>dev</entry> + <entry>volume</entry> + </row> + <row> + <entry>1</entry> + <entry>ino</entry> + <entry>inode</entry> + </row> + <row> + <entry>2</entry> + <entry>mode</entry> + <entry>droits d'accès à l'inode</entry> + </row> + <row> + <entry>3</entry> + <entry>nlink</entry> + <entry>nombre de liens</entry> + </row> + <row> + <entry>4</entry> + <entry>uid</entry> + <entry>userid du propriétaire</entry> + </row> + <row> + <entry>5</entry> + <entry>gid</entry> + <entry>groupid du propriétaire</entry> + </row> + <row> + <entry>6</entry> + <entry>rdev</entry> + <entry>type de volume, si le volume est *</entry> + </row> + <row> + <entry>7</entry> + <entry>size</entry> + <entry>taille en octets</entry> + </row> + <row> + <entry>8</entry> + <entry>atime</entry> + <entry>date de dernier accès (Unix timestamp)</entry> + </row> + <row> + <entry>9</entry> + <entry>mtime</entry> + <entry>date de dernière modification (Unix timestamp)</entry> + </row> + <row> + <entry>10</entry> + <entry>ctime</entry> + <entry>date de dernier changement d'inode (Unix timestamp)</entry> + </row> + <row> + <entry>11</entry> + <entry>blksize</entry> + <entry>taille de bloc</entry> + </row> + <row> + <entry>12</entry> + <entry>blocks</entry> + <entry>nombre de blocs alloués</entry> + </row> + </tbody> + </tgroup> + </table> + * - uniquement sur les systèmes qui supportent le type <literal>st_blksize</literal>. + Les autres systèmes (e.g. Windows) retournent -1. + </para> + &note.clearstatcache; + &tip.fopen-wrapper.stat; + <para> + Voir aussi + <function>lstat</function>, + <function>fstat</function>, + <function>filemtime</function> et + <function>filegroup</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/symlink.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/symlink.xml diff -u phpdoc-fr/reference/filesystem/functions/symlink.xml:1.13 phpdoc-fr/reference/filesystem/functions/symlink.xml:1.14 --- phpdoc-fr/reference/filesystem/functions/symlink.xml:1.13 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/symlink.xml Wed Feb 7 22:06:29 2007 @@ -1,35 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.symlink"> - <refnamediv> - <refname>symlink</refname> - <refpurpose>Crée un lien symbolique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>symlink</methodname> - <methodparam><type>string</type><parameter>target</parameter></methodparam> - <methodparam><type>string</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para> - <function>symlink</function> crée un lien symbolique pour l'objet - <parameter>target</parameter> avec le nom de <parameter>link</parameter>. - </para> - <para> - &return.success; - </para> - &note.no-windows; - <para> - Voir aussi - <function>link</function>, - <function>readlink</function> et - <function>linkinfo</function>. - </para> - </refsect1> - </refentry> + +<refentry id="function.symlink"> + <refnamediv> + <refname>symlink</refname> + <refpurpose>Crée un lien symbolique</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>symlink</methodname> + <methodparam><type>string</type><parameter>target</parameter></methodparam> + <methodparam><type>string</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para> + <function>symlink</function> crée un lien symbolique pour l'objet + <parameter>target</parameter> avec le nom de <parameter>link</parameter>. + </para> + <para> + &return.success; + </para> + &note.no-windows; + <para> + Voir aussi + <function>link</function>, + <function>readlink</function> et + <function>linkinfo</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -50,4 +51,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/tempnam.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/tempnam.xml diff -u phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.17 phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.18 --- phpdoc-fr/reference/filesystem/functions/tempnam.xml:1.17 Sat May 20 15:02:46 2006 +++ phpdoc-fr/reference/filesystem/functions/tempnam.xml Wed Feb 7 22:06:29 2007 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.tempnam"> - <refnamediv> - <refname>tempnam</refname> - <refpurpose>Crée un fichier avec un nom unique</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>tempnam</methodname> - <methodparam><type>string</type><parameter>dir</parameter></methodparam> - <methodparam><type>string</type><parameter>prefix</parameter></methodparam> - </methodsynopsis> - <para> - <function>tempnam</function> crée un fichier temporaire unique - dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, - <function>tempnam</function> va générer un nom de fichier - dans le dossier temporaire du système. Le nom sera préfixé par le paramètre - <parameter>prefix</parameter>. - </para> - <para> - Avant &php; 4.0.6, le comportement de <function>tempnam</function> dépendait - de l'OS sous-jacent. Sous Windows, la variable d'environnement - <varname>TMP</varname> remplace le paramètre <parameter>dir</parameter>; - sous Linux, la variable d'environnement <varname>TMPDIR</varname> a la priorité, - tandis que pour les OS en système V R4, le paramètre <parameter>dir</parameter> - sera toujours utilisé, si le dossier qu'il représente existe. Consultez votre - documentation pour plus de détails. - </para> - <note> - <simpara> - Si &php; ne peut pas créer un fichier dans le dossier spécifié par le paramètre - <parameter>dir</parameter>, il tentera dans le dossier par défaut du système. - </simpara> - </note> - <para> - <function>tempnam</function> retourne le nom du fichier temporaire ou - &false; en cas d'échec. - <example> - <title>Exemple avec <function>tempnam</function></title> - <programlisting role="php"> +<refentry id="function.tempnam"> + <refnamediv> + <refname>tempnam</refname> + <refpurpose>Crée un fichier avec un nom unique</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>tempnam</methodname> + <methodparam><type>string</type><parameter>dir</parameter></methodparam> + <methodparam><type>string</type><parameter>prefix</parameter></methodparam> + </methodsynopsis> + <para> + <function>tempnam</function> crée un fichier temporaire unique + dans le dossier <parameter>dir</parameter>. Si le dossier n'existe pas, + <function>tempnam</function> va générer un nom de fichier + dans le dossier temporaire du système. Le nom sera préfixé par le paramètre + <parameter>prefix</parameter>. + </para> + <para> + Avant &php; 4.0.6, le comportement de <function>tempnam</function> dépendait + de l'OS sous-jacent. Sous Windows, la variable d'environnement + <varname>TMP</varname> remplace le paramètre <parameter>dir</parameter>; + sous Linux, la variable d'environnement <varname>TMPDIR</varname> a la priorité, + tandis que pour les OS en système V R4, le paramètre <parameter>dir</parameter> + sera toujours utilisé, si le dossier qu'il représente existe. Consultez votre + documentation pour plus de détails. + </para> + <note> + <simpara> + Si &php; ne peut pas créer un fichier dans le dossier spécifié par le paramètre + <parameter>dir</parameter>, il tentera dans le dossier par défaut du système. + </simpara> + </note> + <para> + <function>tempnam</function> retourne le nom du fichier temporaire ou + &false; en cas d'échec. + <example> + <title>Exemple avec <function>tempnam</function></title> + <programlisting role="php"> <![CDATA[ <?php $tmpfname = tempnam ("/tmp", "FOO"); @@ -56,28 +56,28 @@ 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 apparaît dans le système - de fichiers entre le moment où la chaîne est générée et avant que le - script n'ait terminé la création 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>, - <function>sys_get_tmp_dir</function> et - <function>unlink</function>. - </para> - </refsect1> - </refentry> + </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 apparaît dans le système + de fichiers entre le moment où la chaîne est générée et avant que le + script n'ait terminé la création 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>, + <function>sys_get_tmp_dir</function> et + <function>unlink</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/tmpfile.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/tmpfile.xml diff -u phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.12 phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.13 --- phpdoc-fr/reference/filesystem/functions/tmpfile.xml:1.12 Sat May 20 15:02:46 2006 +++ phpdoc-fr/reference/filesystem/functions/tmpfile.xml Wed Feb 7 22:06:29 2007 @@ -1,38 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.tmpfile"> - <refnamediv> - <refname>tmpfile</refname> - <refpurpose>Crée un fichier temporaire</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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 lecture - (<literal>w+</literal>), et retourne un - pointeur de fichier, identique à ceux retournés par - <function>fopen</function>. - Ce fichier sera automatiquement effacé lorsqu'il sera - fermé (avec <function>fclose</function>), ou lorsque le script - sera terminé. - </para> - <para> - Pour plus de détails, consultez votre documentation système - sur la fonction <literal>tmpfile(3)</literal>, et sur - <filename>stdio.h</filename>. - </para> - <para> - <example> - <title>Exemple avec <function>tmpfile</function></title> - <programlisting role="php"> +<refentry id="function.tmpfile"> + <refnamediv> + <refname>tmpfile</refname> + <refpurpose>Crée un fichier temporaire</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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 lecture + (<literal>w+</literal>), et retourne un + pointeur de fichier, identique à ceux retournés par + <function>fopen</function>. + Ce fichier sera automatiquement effacé lorsqu'il sera + fermé (avec <function>fclose</function>), ou lorsque le script + sera terminé. + </para> + <para> + Pour plus de détails, consultez votre documentation système + sur la fonction <literal>tmpfile(3)</literal>, et sur + <filename>stdio.h</filename>. + </para> + <para> + <example> + <title>Exemple avec <function>tmpfile</function></title> + <programlisting role="php"> <![CDATA[ <?php $temp = tmpfile(); @@ -42,22 +42,22 @@ fclose($temp); // Ceci supprime le fichier temporaire ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Ecriture dans le fichier temporaire ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>tempnam</function> et - <function>sys_get_temp_dir</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + Voir aussi + <function>tempnam</function> et + <function>sys_get_temp_dir</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/touch.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/touch.xml diff -u phpdoc-fr/reference/filesystem/functions/touch.xml:1.14 phpdoc-fr/reference/filesystem/functions/touch.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/touch.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/touch.xml Wed Feb 7 22:06:29 2007 @@ -1,62 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.touch"> - <refnamediv> - <refname>touch</refname> - <refpurpose> - Modifie la date de modification et de dernier accès d'un fichier - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</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> +<refentry id="function.touch"> + <refnamediv> + <refname>touch</refname> + <refpurpose> + Modifie la date de modification et de dernier accès d'un fichier + </refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</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 + désigné par le paramètre <parameter>filename</parameter> à la date de + spécifiée par le paramètre <parameter>time</parameter>. + Si <parameter>time</parameter> est omis, + c'est l'heure courante qui est utilisée. Si le troisième paramètre + <parameter>atime</parameter> est fourni, il est utilisé comme + date de dernier accès. Notez bien que la date de dernier accès + est modifiée, quelque soit le nombre de paramètres. + </para> + <para> + Si le fichier n'existe pas, &php; tente de le créer. &return.success; + </para> + <warning> <para> - <function>touch</function> tente de forcer la date de modification du fichier - désigné par le paramètre <parameter>filename</parameter> à la date de - spécifiée par le paramètre <parameter>time</parameter>. - Si <parameter>time</parameter> est omis, - c'est l'heure courante qui est utilisée. Si le troisième paramètre - <parameter>atime</parameter> est fourni, il est utilisé comme - date de dernier accès. Notez bien que la date de dernier accès - est modifiée, quelque soit le nombre de paramètres. + Il n'est pour le moment pas possible de changer la date de modification d'un dossier + avec cette fonction sous Windows. </para> - <para> - Si le fichier n'existe pas, &php; tente de le créer. &return.success; - </para> - <warning> - <para> - Il n'est pour le moment pas possible de changer la date de modification d'un dossier - avec cette fonction sous Windows. - </para> - </warning> - <para> - <example> - <title>Exemple avec <function>touch</function></title> - <programlisting role="php"> + </warning> + <para> + <example> + <title>Exemple avec <function>touch</function></title> + <programlisting role="php"> <![CDATA[ <?php if ( touch($NomDeFichier) ) { - echo "La date de modification de $NomDeFichier a - été fixée à maintenant"; + echo "La date de modification de $NomDeFichier a + été fixée à maintenant"; } else { - echo "Désolé, il est impossible de changer - la date de modification de $NomDeFichier"; + echo "Désolé, il est impossible de changer + la date de modification de $NomDeFichier"; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/umask.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/umask.xml diff -u phpdoc-fr/reference/filesystem/functions/umask.xml:1.14 phpdoc-fr/reference/filesystem/functions/umask.xml:1.15 --- phpdoc-fr/reference/filesystem/functions/umask.xml:1.14 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/umask.xml Wed Feb 7 22:06:29 2007 @@ -1,43 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.umask"> - <refnamediv> - <refname>umask</refname> - <refpurpose>Change le "umask" courant</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <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; et le - remplace par <parameter>mask</parameter> : - <literal>mask &amp; 0777</literal> - puis, retourne le vieux umask. Lorsque &php; est utilisé comme module de - serveur, le umask reprend sa valeur à la fin de chaque script. - </para> + +<refentry id="function.umask"> + <refnamediv> + <refname>umask</refname> + <refpurpose>Change le "umask" courant</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <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; et le + remplace par <parameter>mask</parameter> : + <literal>mask &amp; 0777</literal> + puis, retourne le vieux umask. Lorsque &php; est utilisé comme module de + serveur, le umask reprend sa valeur à la fin de chaque script. + </para> + <para> + <function>umask</function>, appelée sans arguments, + retourne simplement le umask courant. + </para> + <note> <para> - <function>umask</function>, appelée sans arguments, - retourne simplement le umask courant. + Évitez d'utiliser cette fonction sur un serveur Web multi-threadé. + Il vaut mieux changer les droits d'un dossier avec la fonction + <function>chmod</function>, après la création du dossier. En utilisant + <function>umask</function>, vous risquez de rencontrer des comportements + indéfinis au niveau des autres scripts et du serveur, car ils utilisent + tous le même umask. </para> - <note> - <para> - Évitez d'utiliser cette fonction sur un serveur Web multi-threadé. - Il vaut mieux changer les droits d'un dossier avec la fonction - <function>chmod</function>, après la création du dossier. En utilisant - <function>umask</function>, vous risquez de rencontrer des comportements - indéfinis au niveau des autres scripts et du serveur, car ils utilisent - tous le même umask. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>umask</function></title> - <programlisting role="php"> + </note> + <para> + <example> + <title>Exemple avec <function>umask</function></title> + <programlisting role="php"> <![CDATA[ <?php $old = umask(0); @@ -46,15 +47,15 @@ // vérification if ($old != umask()) { - die('An error occured while changing back the umask'); + die('Une erreur est intervenue durant la modification des droits'); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -75,4 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/filesystem/functions/unlink.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/filesystem/functions/unlink.xml diff -u phpdoc-fr/reference/filesystem/functions/unlink.xml:1.15 phpdoc-fr/reference/filesystem/functions/unlink.xml:1.16 --- phpdoc-fr/reference/filesystem/functions/unlink.xml:1.15 Mon Aug 28 12:10:34 2006 +++ phpdoc-fr/reference/filesystem/functions/unlink.xml Wed Feb 7 22:06:29 2007 @@ -1,39 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.10 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.unlink"> - <refnamediv> - <refname>unlink</refname> - <refpurpose>Efface un fichier</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>unlink</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> - </methodsynopsis> - <para> - <function>unlink</function> efface <parameter>filename</parameter>. - Identique à la fonction Unix C <literal>unlink()</literal>. - &return.success; - </para> - <note> - <simpara> - Depuis &php; 5.0.0, <function>unlink</function> peut - aussi être utilisée avec <emphasis>quelques</emphasis> protocoles d'URL. - Voyez <xref linkend="wrappers"/> pour une liste des protocoles supportant - <function>unlink</function>. - </simpara> - </note> - &note.context-support; - <para> - Voir aussi - <function>rmdir</function> pour la suppression de dossiers. - </para> - </refsect1> - </refentry> + +<refentry id="function.unlink"> + <refnamediv> + <refname>unlink</refname> + <refpurpose>Efface un fichier</refpurpose> + </refnamediv> + <refsect1> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>unlink</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam> + </methodsynopsis> + <para> + <function>unlink</function> efface <parameter>filename</parameter>. + Identique à la fonction Unix C <literal>unlink()</literal>. + &return.success; + </para> + <note> + <simpara> + Depuis &php; 5.0.0, <function>unlink</function> peut + aussi être utilisée avec <emphasis>quelques</emphasis> protocoles d'URL. + Voyez <xref linkend="wrappers"/> pour une liste des protocoles supportant + <function>unlink</function>. + </simpara> + </note> + &note.context-support; + <para> + Voir aussi + <function>rmdir</function> pour la suppression de dossiers. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -54,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file