cvs: phpdoc-fr /reference/dir constants.xml reference.xml /reference/dir/functions chdir.xml chroot.xml class.dir.xml closedir.xml dir.xml getcwd.xml
opendir.xml readdir.xml rewinddir.xml scandir.xml
| From: | Mehdi Achour | Date: | Thu, 04 Mar 2004 14:23:31 +0000 |
| Subject: | cvs: phpdoc-fr /reference/dir constants.xml reference.xml /reference/dir/functions chdir.xml chroot.xml class.dir.xml closedir.xml dir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml scandir.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-1988@lists.php.net to get a copy of this message | ||
didou Thu Mar 4 09:23:31 2004 EDT
Added files:
/phpdoc-fr/reference/dir/functions class.dir.xml
Removed files:
/phpdoc-fr/reference/dir/functions dir.xml
Modified files:
/phpdoc-fr/reference/dir constants.xml reference.xml
/phpdoc-fr/reference/dir/functions chdir.xml chroot.xml
closedir.xml getcwd.xml
opendir.xml readdir.xml
rewinddir.xml scandir.xml
Log:
sync with en
http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/constants.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/dir/constants.xml diff -u phpdoc-fr/reference/dir/constants.xml:1.3 phpdoc-fr/reference/dir/constants.xml:1.4 --- phpdoc-fr/reference/dir/constants.xml:1.3 Wed Feb 25 08:27:10 2004 +++ phpdoc-fr/reference/dir/constants.xml Thu Mar 4 09:23:30 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <section id="dir.constants"> &reftitle.constants; &extension.constants; @@ -28,6 +28,11 @@ </listitem> </varlistentry> </variablelist> + <note> + <simpara> + La constante <constant>PATH_SEPARATOR</constant> a été introduite en &php; 4.3.0-RC2. + </simpara> + </note> </section> <!-- Keep this comment at the end of the file http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/reference.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/reference.xml diff -u phpdoc-fr/reference/dir/reference.xml:1.5 phpdoc-fr/reference/dir/reference.xml:1.6 --- phpdoc-fr/reference/dir/reference.xml:1.5 Wed Feb 25 07:35:19 2004 +++ phpdoc-fr/reference/dir/reference.xml Thu Mar 4 09:23:30 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> <reference id="ref.dir"> <title>Accès aux dossiers</title> <titleabbrev>Dossiers</titleabbrev> @@ -39,8 +39,8 @@ <para> Pour des fonctions connexes telles que <function>dirname</function>, <function>is_dir</function>, <function>mkdir</function> et - <function>rmdir</function>, voyez donc les fonctions - <link linkend="ref.filesystem">Système de fichiers</link>. + <function>rmdir</function>, voyez donc la section + <link linkend="ref.filesystem">système de fichiers</link>. </para> </section> </partintro> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/chdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/chdir.xml diff -u phpdoc-fr/reference/dir/functions/chdir.xml:1.5 phpdoc-fr/reference/dir/functions/chdir.xml:1.6 --- phpdoc-fr/reference/dir/functions/chdir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/chdir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'chdir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> <refentry id="function.chdir"> <refnamediv> <refname>chdir</refname> @@ -16,9 +13,39 @@ <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> - <function>chdir</function> change le dossier courant de PHP en - <parameter>directory</parameter>. &return.success; + <function>chdir</function> change le dossier courant de &php; en + <parameter>directory</parameter>. &return.success; + </para> + <para> + <example> + <title>Exemple avec <function>chdir</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// dossier courant +echo getcwd() . "\n"; + +chdir('public_html'); + +// dossier courant +echo getcwd() . "\n"; + +?> +]]> + </programlisting> + <para> + Cet exemple va afficher : + </para> + <screen> +<![CDATA[ +/home/vincent +/home/vincent/public_html +]]> + </screen> + </example> </para> + ¬e.sm.uidcheck.dir; <para> Voir aussi <function>getcwd</function>. http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/chroot.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/chroot.xml diff -u phpdoc-fr/reference/dir/functions/chroot.xml:1.5 phpdoc-fr/reference/dir/functions/chroot.xml:1.6 --- phpdoc-fr/reference/dir/functions/chroot.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/chroot.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'chroot' in en/ tree in rev 1.11 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <refentry id="function.chroot"> <refnamediv> <refname>chroot</refname> @@ -21,16 +18,14 @@ &return.success;. </para> <para> - <note> - <para> - Il n'est pas conseillé d'utiliser cette fonction sur un - site web, car il n'est pas possible de restaurer la racine - à sa valeur initiale à la fin de la - requête. Cette fonction n'est viable que lorsque PHP est - utilisé en CGI. - </para> - </note> + Cette fonction n'est disponible que si votre système la supporte et que + vous utilisez le SAPI CLI, CGI ou Embed. </para> + <note> + <para> + <function>chroot</function> requière le privilège root. + </para> + </note> ¬e.no-windows; </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/closedir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/closedir.xml diff -u phpdoc-fr/reference/dir/functions/closedir.xml:1.5 phpdoc-fr/reference/dir/functions/closedir.xml:1.6 --- phpdoc-fr/reference/dir/functions/closedir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/closedir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'closedir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.closedir"> <refnamediv> <refname>closedir</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/getcwd.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/dir/functions/getcwd.xml diff -u phpdoc-fr/reference/dir/functions/getcwd.xml:1.4 phpdoc-fr/reference/dir/functions/getcwd.xml:1.5 --- phpdoc-fr/reference/dir/functions/getcwd.xml:1.4 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/getcwd.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'getcwd' in en/ tree in rev 1.7 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.getcwd"> <refnamediv> <refname>getcwd</refname> @@ -19,6 +16,35 @@ <function>getcwd</function> retourne le nom du dossier courant. </para> <para> + <example> + <title>Exemple avec <function>getcwd</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// dossier courant +echo getcwd() . "\n"; + +chdir('cvs'); + +// dossier courant +echo getcwd() . "\n"; + +?> +]]> + </programlisting> + <para> + Cet exemple affichera quelque chose comme : + </para> + <screen> +<![CDATA[ +/home/didou +/home/didou/cvs +]]> + </screen> + </example> + </para> + <para> Voir aussi <function>chdir</function>. </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/opendir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/opendir.xml diff -u phpdoc-fr/reference/dir/functions/opendir.xml:1.5 phpdoc-fr/reference/dir/functions/opendir.xml:1.6 --- phpdoc-fr/reference/dir/functions/opendir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/opendir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'opendir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> <refentry id="function.opendir"> <refnamediv> <refname>opendir</refname> @@ -19,7 +16,7 @@ </methodsynopsis> <para> <function>opendir</function> retourne un pointeur sur un dossier - pour être utilisé avec les fonctions + qui pour être utilisé avec les fonctions <function>closedir</function>, <function>readdir</function> et <function>rewinddir</function>. </para> @@ -28,9 +25,11 @@ valide, ou si le dossier ne peut être accédé pour des raisons de permissions ou des erreurs liées au système de fichiers, <function>opendir</function> retourne - &false; et génère une erreur PHP. + &false; et génère une erreur &php; de niveau <link + linkend="errorfunc.constants">E_WARNING</link>. Vous pouvez supprimer cette erreur en ajoutant - <literal>@</literal> avant le nom de la fonction. + '<link linkend="language.operators.errorcontrol">@</link>' + avant le nom de la fonction. </para> <para> <example> @@ -44,20 +43,22 @@ if (is_dir($dir)) { if ($dh = opendir($dir)) { while (($file = readdir($dh)) !== false) { - print "fichier : $file : type: " . filetype($dir . $file) . "\n"; + echo "fichier : $file : type: " . filetype($dir . $file) . "\n"; } - closedir($dh); + closedir($dh); } } -?>]]> </programlisting> +?> +]]> + </programlisting> </example> </para> - <para> - Voir aussi - <function>is_dir</function>, - <function>readdir</function> et - <link linkend="class.dir">dir</link> - </para> + <para> + Voir aussi + <function>is_dir</function>, + <function>readdir</function> et + <link linkend="class.dir">dir</link> + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/readdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/readdir.xml diff -u phpdoc-fr/reference/dir/functions/readdir.xml:1.5 phpdoc-fr/reference/dir/functions/readdir.xml:1.6 --- phpdoc-fr/reference/dir/functions/readdir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/readdir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'readdir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.readdir"> <refnamediv> <refname>readdir</refname> @@ -19,18 +16,39 @@ <function>readdir</function> retourne le nom du fichier suivant dans le dossier identifié par <parameter>dir_handle</parameter>. Les noms sont retournés dans n'importe quel ordre. + </para> + <para> + Notez la façon dont la valeur de retour de <function>dir</function> + est vérifiée dans l'exemple suivant. Nous testons si la valeur est + identique (égale et de même type que -- woyez <link + linkend="language.operators.comparison">opérateurs de comparaison</link> + pour plus de détails) &false; sinon, toute entrée dans le nom serait évalué + à &false; causera l'arrêt de la boucle (exemple, un répertoire nommé 0). + </para> + <para> <example> <title>Liste tous les fichiers du dossier courant</title> <programlisting role="php"> <![CDATA[ <?php - $handle=opendir('.'); - echo "Pointeur de dossier : $handle\n"; - echo "Fichiers :\n"; - while ($file = readdir($handle)) { - echo "$file\n"; - } - closedir($handle); +// Notez que !== n'existait pas avant 4.0.0-RC2 + +if ($handle = opendir('/chemin/vers/fichiers')) { + echo "Directory handle: $handle\n"; + echo "Files:\n"; + + /* Ceci est la façon correcte de traverser un dossier. */ + while (false !== ($file = readdir($handle))) { + echo "$file\n"; + } + + /* Ceci est la MAUVAISE façon de traverser un dossier. */ + while ($file = readdir($handle)) { + echo "$file\n"; + } + + closedir($handle); +} ?> ]]> </programlisting> @@ -46,13 +64,14 @@ <programlisting role="php"> <![CDATA[ <?php -$handle=opendir('.'); -while ($file = readdir($handle)) { - if ($file != "." && $file != "..") { - echo "$file\n"; +if ($handle = opendir('.')) { + while (false !== ($file = readdir($handle))) { + if ($file != "." && $file != "..") { + echo "$file\n"; + } } + closedir($handle); } -closedir($handle); ?> ]]> </programlisting> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/rewinddir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/rewinddir.xml diff -u phpdoc-fr/reference/dir/functions/rewinddir.xml:1.5 phpdoc-fr/reference/dir/functions/rewinddir.xml:1.6 --- phpdoc-fr/reference/dir/functions/rewinddir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/rewinddir.xml Thu Mar 4 09:23:31 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'rewinddir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> @@ -17,8 +14,7 @@ </methodsynopsis> <para> <function>rewinddir</function> retourne à la première - entrée du dossier identifié par <parameter>dir_handle</parameter> : - le prochain fichier lu sera le premier. + entrée du dossier identifié par <parameter>dir_handle</parameter>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/scandir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/dir/functions/scandir.xml diff -u phpdoc-fr/reference/dir/functions/scandir.xml:1.3 phpdoc-fr/reference/dir/functions/scandir.xml:1.4 --- phpdoc-fr/reference/dir/functions/scandir.xml:1.3 Wed Feb 25 07:35:19 2004 +++ phpdoc-fr/reference/dir/functions/scandir.xml Thu Mar 4 09:23:31 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.scandir"> <refnamediv> <refname>scandir</refname> @@ -17,9 +17,9 @@ </methodsynopsis> <para> <methodname>scandir</methodname> retourne un <type>array</type> de fichier - et dossier, issus de <parameter>directory</parameter>. Si + et dossier, issus de <parameter>directory</parameter>. Si <parameter>directory</parameter> n'est pas un dossier, le booléen - &false; est retourné, et une erreur de niveau <constant>E_WARNING</constant> + &false; est retourné, et une erreur de niveau <constant>E_WARNING</constant> est générée. </para> <para> @@ -39,8 +39,14 @@ print_r($files1); print_r($files2); - -/* Affichera ceci : +?> +]]> + </programlisting> + <para> + Affichera ceci : + </para> + <screen> +<![CDATA[ Array ( [0] => . @@ -57,10 +63,8 @@ [3] => .. [4] => . ) -*/ -?> ]]> - </programlisting> + </screen> </example> </para> <para> @@ -82,8 +86,14 @@ rsort($files); print_r($files); - -/* Affichera ceci : +?> +]]> + </programlisting> + <para> + Affichera ceci : + </para> + <screen> +<![CDATA[ Array ( [0] => . @@ -100,17 +110,15 @@ [3] => .. [4] => . ) -*/ -?> ]]> - </programlisting> + </screen> </example> </para> <para> Voir aussi <function>opendir</function>, <function>readdir</function>, - <function>glob</function>, + <function>glob</function>, <function>is_dir</function> et <function>sort</function>. </para> http://cvs.php.net/co.php/phpdoc-fr/reference/dir/functions/class.dir.xml?r=1.1&p=1 Index: phpdoc-fr/reference/dir/functions/class.dir.xml +++ phpdoc-fr/reference/dir/functions/class.dir.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="class.dir"> <refnamediv> <refname>dir</refname> <refpurpose>Classe dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> <methodname>dir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </constructorsynopsis> <fieldsynopsis> <type>string</type><varname>path</varname> </fieldsynopsis> <fieldsynopsis> <type>resource</type><varname>handle</varname> </fieldsynopsis> <methodsynopsis><type>string</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> <para> Un mécanisme pseudo-objet permet la lecture d'un dossier. L'argument <parameter>directory</parameter> est ouvert. Deux propriétés sont disponibles une fois le dossier ouvert : le pointeur peut être utilisé avec d'autres fonctions telles que <function>readdir</function>, <function>rewinddir</function> et <function>closedir</function>. Le chemin du dossier est le chemin fourni lors de la construction de l'objet. Trois méthodes permettent de lire, remettre à zéro et fermer le dossier. </para> <para> Notez la façon dont la valeur de retour de <function>dir</function> est vérifiée dans l'exemple suivant. Nous testons si la valeur est identique (égale et de même type que -- woyez <link linkend="language.operators.comparison">opérateurs de comparaison</link> pour plus de détails) &false; sinon, toute entrée dans le nom serait évalué à &false; causera l'arrêt de la boucle (exemple, un répertoire nommé 0). <example> <title>Exemple avec <function>dir</function></title> <programlisting role="php"> <![CDATA[ <?php $d = dir("/etc"); echo "Pointeur: " . $d->handle . "<br />\n"; echo "Chemin: " . $d->path . "<br />\n"; while (false !== ($entry = $d->read())) { echo $entry . "<br />\n"; } $d->close(); ?> ]]> </programlisting> </example> </para> <note> <para> L'ordre dans lequel les entrées du dossier sont retournées avec la méthode read dépend de votre système. </para> </note> <note> <para> Ceci défini la classe interne <classname>Directory</classname>, ce qui signifie que vous ne pourrez pas nommer votre classe avec ce nom. Pour une liste complète des classes prédéfinies en &php;, lisez <link linkend="reserved.classes">classes prédéfinies</link>. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/constants.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/dir/constants.xml diff -u phpdoc-fr/reference/dir/constants.xml:1.3 phpdoc-fr/reference/dir/constants.xml:1.4 --- phpdoc-fr/reference/dir/constants.xml:1.3 Wed Feb 25 08:27:10 2004 +++ phpdoc-fr/reference/dir/constants.xml Thu Mar 4 09:23:30 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <section id="dir.constants"> &reftitle.constants; &extension.constants; @@ -28,6 +28,11 @@ </listitem> </varlistentry> </variablelist> + <note> + <simpara> + La constante <constant>PATH_SEPARATOR</constant> a été introduite en &php; 4.3.0-RC2. + </simpara> + </note> </section> <!-- Keep this comment at the end of the file http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/reference.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/reference.xml diff -u phpdoc-fr/reference/dir/reference.xml:1.5 phpdoc-fr/reference/dir/reference.xml:1.6 --- phpdoc-fr/reference/dir/reference.xml:1.5 Wed Feb 25 07:35:19 2004 +++ phpdoc-fr/reference/dir/reference.xml Thu Mar 4 09:23:30 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> <reference id="ref.dir"> <title>Accès aux dossiers</title> <titleabbrev>Dossiers</titleabbrev> @@ -39,8 +39,8 @@ <para> Pour des fonctions connexes telles que <function>dirname</function>, <function>is_dir</function>, <function>mkdir</function> et - <function>rmdir</function>, voyez donc les fonctions - <link linkend="ref.filesystem">Système de fichiers</link>. + <function>rmdir</function>, voyez donc la section + <link linkend="ref.filesystem">système de fichiers</link>. </para> </section> </partintro> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/chdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/chdir.xml diff -u phpdoc-fr/reference/dir/functions/chdir.xml:1.5 phpdoc-fr/reference/dir/functions/chdir.xml:1.6 --- phpdoc-fr/reference/dir/functions/chdir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/chdir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'chdir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.9 Maintainer: didou Status: ready --> <refentry id="function.chdir"> <refnamediv> <refname>chdir</refname> @@ -16,9 +13,39 @@ <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> - <function>chdir</function> change le dossier courant de PHP en - <parameter>directory</parameter>. &return.success; + <function>chdir</function> change le dossier courant de &php; en + <parameter>directory</parameter>. &return.success; + </para> + <para> + <example> + <title>Exemple avec <function>chdir</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// dossier courant +echo getcwd() . "\n"; + +chdir('public_html'); + +// dossier courant +echo getcwd() . "\n"; + +?> +]]> + </programlisting> + <para> + Cet exemple va afficher : + </para> + <screen> +<![CDATA[ +/home/vincent +/home/vincent/public_html +]]> + </screen> + </example> </para> + ¬e.sm.uidcheck.dir; <para> Voir aussi <function>getcwd</function>. http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/chroot.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/chroot.xml diff -u phpdoc-fr/reference/dir/functions/chroot.xml:1.5 phpdoc-fr/reference/dir/functions/chroot.xml:1.6 --- phpdoc-fr/reference/dir/functions/chroot.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/chroot.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'chroot' in en/ tree in rev 1.11 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.7 Maintainer: didou Status: ready --> <refentry id="function.chroot"> <refnamediv> <refname>chroot</refname> @@ -21,16 +18,14 @@ &return.success;. </para> <para> - <note> - <para> - Il n'est pas conseillé d'utiliser cette fonction sur un - site web, car il n'est pas possible de restaurer la racine - à sa valeur initiale à la fin de la - requête. Cette fonction n'est viable que lorsque PHP est - utilisé en CGI. - </para> - </note> + Cette fonction n'est disponible que si votre système la supporte et que + vous utilisez le SAPI CLI, CGI ou Embed. </para> + <note> + <para> + <function>chroot</function> requière le privilège root. + </para> + </note> ¬e.no-windows; </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/closedir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/closedir.xml diff -u phpdoc-fr/reference/dir/functions/closedir.xml:1.5 phpdoc-fr/reference/dir/functions/closedir.xml:1.6 --- phpdoc-fr/reference/dir/functions/closedir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/closedir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'closedir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.closedir"> <refnamediv> <refname>closedir</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/getcwd.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-fr/reference/dir/functions/getcwd.xml diff -u phpdoc-fr/reference/dir/functions/getcwd.xml:1.4 phpdoc-fr/reference/dir/functions/getcwd.xml:1.5 --- phpdoc-fr/reference/dir/functions/getcwd.xml:1.4 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/getcwd.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'getcwd' in en/ tree in rev 1.7 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.getcwd"> <refnamediv> <refname>getcwd</refname> @@ -19,6 +16,35 @@ <function>getcwd</function> retourne le nom du dossier courant. </para> <para> + <example> + <title>Exemple avec <function>getcwd</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// dossier courant +echo getcwd() . "\n"; + +chdir('cvs'); + +// dossier courant +echo getcwd() . "\n"; + +?> +]]> + </programlisting> + <para> + Cet exemple affichera quelque chose comme : + </para> + <screen> +<![CDATA[ +/home/didou +/home/didou/cvs +]]> + </screen> + </example> + </para> + <para> Voir aussi <function>chdir</function>. </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/opendir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/opendir.xml diff -u phpdoc-fr/reference/dir/functions/opendir.xml:1.5 phpdoc-fr/reference/dir/functions/opendir.xml:1.6 --- phpdoc-fr/reference/dir/functions/opendir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/opendir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'opendir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.8 Maintainer: didou Status: ready --> <refentry id="function.opendir"> <refnamediv> <refname>opendir</refname> @@ -19,7 +16,7 @@ </methodsynopsis> <para> <function>opendir</function> retourne un pointeur sur un dossier - pour être utilisé avec les fonctions + qui pour être utilisé avec les fonctions <function>closedir</function>, <function>readdir</function> et <function>rewinddir</function>. </para> @@ -28,9 +25,11 @@ valide, ou si le dossier ne peut être accédé pour des raisons de permissions ou des erreurs liées au système de fichiers, <function>opendir</function> retourne - &false; et génère une erreur PHP. + &false; et génère une erreur &php; de niveau <link + linkend="errorfunc.constants">E_WARNING</link>. Vous pouvez supprimer cette erreur en ajoutant - <literal>@</literal> avant le nom de la fonction. + '<link linkend="language.operators.errorcontrol">@</link>' + avant le nom de la fonction. </para> <para> <example> @@ -44,20 +43,22 @@ if (is_dir($dir)) { if ($dh = opendir($dir)) { while (($file = readdir($dh)) !== false) { - print "fichier : $file : type: " . filetype($dir . $file) . "\n"; + echo "fichier : $file : type: " . filetype($dir . $file) . "\n"; } - closedir($dh); + closedir($dh); } } -?>]]> </programlisting> +?> +]]> + </programlisting> </example> </para> - <para> - Voir aussi - <function>is_dir</function>, - <function>readdir</function> et - <link linkend="class.dir">dir</link> - </para> + <para> + Voir aussi + <function>is_dir</function>, + <function>readdir</function> et + <link linkend="class.dir">dir</link> + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/readdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/readdir.xml diff -u phpdoc-fr/reference/dir/functions/readdir.xml:1.5 phpdoc-fr/reference/dir/functions/readdir.xml:1.6 --- phpdoc-fr/reference/dir/functions/readdir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/readdir.xml Thu Mar 4 09:23:30 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'readdir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.readdir"> <refnamediv> <refname>readdir</refname> @@ -19,18 +16,39 @@ <function>readdir</function> retourne le nom du fichier suivant dans le dossier identifié par <parameter>dir_handle</parameter>. Les noms sont retournés dans n'importe quel ordre. + </para> + <para> + Notez la façon dont la valeur de retour de <function>dir</function> + est vérifiée dans l'exemple suivant. Nous testons si la valeur est + identique (égale et de même type que -- woyez <link + linkend="language.operators.comparison">opérateurs de comparaison</link> + pour plus de détails) &false; sinon, toute entrée dans le nom serait évalué + à &false; causera l'arrêt de la boucle (exemple, un répertoire nommé 0). + </para> + <para> <example> <title>Liste tous les fichiers du dossier courant</title> <programlisting role="php"> <![CDATA[ <?php - $handle=opendir('.'); - echo "Pointeur de dossier : $handle\n"; - echo "Fichiers :\n"; - while ($file = readdir($handle)) { - echo "$file\n"; - } - closedir($handle); +// Notez que !== n'existait pas avant 4.0.0-RC2 + +if ($handle = opendir('/chemin/vers/fichiers')) { + echo "Directory handle: $handle\n"; + echo "Files:\n"; + + /* Ceci est la façon correcte de traverser un dossier. */ + while (false !== ($file = readdir($handle))) { + echo "$file\n"; + } + + /* Ceci est la MAUVAISE façon de traverser un dossier. */ + while ($file = readdir($handle)) { + echo "$file\n"; + } + + closedir($handle); +} ?> ]]> </programlisting> @@ -46,13 +64,14 @@ <programlisting role="php"> <![CDATA[ <?php -$handle=opendir('.'); -while ($file = readdir($handle)) { - if ($file != "." && $file != "..") { - echo "$file\n"; +if ($handle = opendir('.')) { + while (false !== ($file = readdir($handle))) { + if ($file != "." && $file != "..") { + echo "$file\n"; + } } + closedir($handle); } -closedir($handle); ?> ]]> </programlisting> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/rewinddir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/dir/functions/rewinddir.xml diff -u phpdoc-fr/reference/dir/functions/rewinddir.xml:1.5 phpdoc-fr/reference/dir/functions/rewinddir.xml:1.6 --- phpdoc-fr/reference/dir/functions/rewinddir.xml:1.5 Tue Feb 24 13:09:19 2004 +++ phpdoc-fr/reference/dir/functions/rewinddir.xml Thu Mar 4 09:23:31 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/dir.xml, last change in rev 1.11 --> -<!-- last change to 'rewinddir' in en/ tree in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.rewinddir"> <refnamediv> <refname>rewinddir</refname> @@ -17,8 +14,7 @@ </methodsynopsis> <para> <function>rewinddir</function> retourne à la première - entrée du dossier identifié par <parameter>dir_handle</parameter> : - le prochain fichier lu sera le premier. + entrée du dossier identifié par <parameter>dir_handle</parameter>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/dir/functions/scandir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/dir/functions/scandir.xml diff -u phpdoc-fr/reference/dir/functions/scandir.xml:1.3 phpdoc-fr/reference/dir/functions/scandir.xml:1.4 --- phpdoc-fr/reference/dir/functions/scandir.xml:1.3 Wed Feb 25 07:35:19 2004 +++ phpdoc-fr/reference/dir/functions/scandir.xml Thu Mar 4 09:23:31 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.scandir"> <refnamediv> <refname>scandir</refname> @@ -17,9 +17,9 @@ </methodsynopsis> <para> <methodname>scandir</methodname> retourne un <type>array</type> de fichier - et dossier, issus de <parameter>directory</parameter>. Si + et dossier, issus de <parameter>directory</parameter>. Si <parameter>directory</parameter> n'est pas un dossier, le booléen - &false; est retourné, et une erreur de niveau <constant>E_WARNING</constant> + &false; est retourné, et une erreur de niveau <constant>E_WARNING</constant> est générée. </para> <para> @@ -39,8 +39,14 @@ print_r($files1); print_r($files2); - -/* Affichera ceci : +?> +]]> + </programlisting> + <para> + Affichera ceci : + </para> + <screen> +<![CDATA[ Array ( [0] => . @@ -57,10 +63,8 @@ [3] => .. [4] => . ) -*/ -?> ]]> - </programlisting> + </screen> </example> </para> <para> @@ -82,8 +86,14 @@ rsort($files); print_r($files); - -/* Affichera ceci : +?> +]]> + </programlisting> + <para> + Affichera ceci : + </para> + <screen> +<![CDATA[ Array ( [0] => . @@ -100,17 +110,15 @@ [3] => .. [4] => . ) -*/ -?> ]]> - </programlisting> + </screen> </example> </para> <para> Voir aussi <function>opendir</function>, <function>readdir</function>, - <function>glob</function>, + <function>glob</function>, <function>is_dir</function> et <function>sort</function>. </para> http://cvs.php.net/co.php/phpdoc-fr/reference/dir/functions/class.dir.xml?r=1.1&p=1 Index: phpdoc-fr/reference/dir/functions/class.dir.xml +++ phpdoc-fr/reference/dir/functions/class.dir.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="class.dir"> <refnamediv> <refname>dir</refname> <refpurpose>Classe dossier</refpurpose> </refnamediv> <refsect1> <title>Description</title> <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> <methodname>dir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </constructorsynopsis> <fieldsynopsis> <type>string</type><varname>path</varname> </fieldsynopsis> <fieldsynopsis> <type>resource</type><varname>handle</varname> </fieldsynopsis> <methodsynopsis><type>string</type><methodname>read</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>rewind</methodname><void/></methodsynopsis> <methodsynopsis><type>void</type><methodname>close</methodname><void/></methodsynopsis> </classsynopsis> <para> Un mécanisme pseudo-objet permet la lecture d'un dossier. L'argument <parameter>directory</parameter> est ouvert. Deux propriétés sont disponibles une fois le dossier ouvert : le pointeur peut être utilisé avec d'autres fonctions telles que <function>readdir</function>, <function>rewinddir</function> et <function>closedir</function>. Le chemin du dossier est le chemin fourni lors de la construction de l'objet. Trois méthodes permettent de lire, remettre à zéro et fermer le dossier. </para> <para> Notez la façon dont la valeur de retour de <function>dir</function> est vérifiée dans l'exemple suivant. Nous testons si la valeur est identique (égale et de même type que -- woyez <link linkend="language.operators.comparison">opérateurs de comparaison</link> pour plus de détails) &false; sinon, toute entrée dans le nom serait évalué à &false; causera l'arrêt de la boucle (exemple, un répertoire nommé 0). <example> <title>Exemple avec <function>dir</function></title> <programlisting role="php"> <![CDATA[ <?php $d = dir("/etc"); echo "Pointeur: " . $d->handle . "<br />\n"; echo "Chemin: " . $d->path . "<br />\n"; while (false !== ($entry = $d->read())) { echo $entry . "<br />\n"; } $d->close(); ?> ]]> </programlisting> </example> </para> <note> <para> L'ordre dans lequel les entrées du dossier sont retournées avec la méthode read dépend de votre système. </para> </note> <note> <para> Ceci défini la classe interne <classname>Directory</classname>, ce qui signifie que vous ne pourrez pas nommer votre classe avec ce nom. Pour une liste complète des classes prédéfinies en &php;, lisez <link linkend="reserved.classes">classes prédéfinies</link>. </para> </note> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->