1
0
mirror of https://github.com/php/doc-fr.git synced 2026-03-23 22:52:18 +01:00
Files
archived-doc-fr/reference/spl/filesystemiterator.xml
Louis-Arnaud 2d314f78aa CI: check-style + nettoyage TRADUCTIONS.txt (#2545)
* CI: add French style checker based on TRADUCTIONS.txt

Checks changed XML files in PRs for:
- Direct address forms (vous/votre/vos) → warnings
- French grammar errors (etc..., comme par exemple, si il) → errors
- Incorrect terminology (librairie, chiffrage, encryption) → warnings

Inspired by doc-ja's textlint+prh approach but simpler:
runs directly on XML sources, no PhD render needed.

Only errors (grammar/spelling) fail the CI.
Style warnings appear as PR annotations without blocking.

* test: introduce style errors to validate CI check

* Revert "test: introduce style errors to validate CI check"

This reverts commit 7c1d523c6bbef116f54fc6dad7b61a45ee4f7ddd.

* Corriger toutes les violations de style TRADUCTIONS.txt

- 174x "Notez que" → "Il est à noter que"
- 50x "depuis PHP X" → "à partir de PHP X"
- 50x "votre" → le/la/du
- 15x "si il" → "s'il"
- 14x "Vous pouvez" → "Il est possible de"
- 14x "encryption" (faux positifs entity refs exclus)
- 12x "assurez-vous" → "il faut s'assurer"
- 12x "Vous devez" → "Il faut"
- 11x "vos" → les/des
- 9x "comme par exemple" → "par exemple"
- 6x "Vous devriez" → "Il est recommandé de"
- 2x "optionel" → "optionnel"
- 2x "reportez-vous" → "se reporter"

Toutes les règles passent désormais en erreur dans la CI.

* Harmoniser les noms de workflows GitHub Actions

- integrate.yaml → build.yml (extension + nom cohérent)
- check-style-fr.yml → check-style.yml ("-fr" redondant)
- Aligner les noms de workflow et job

* Lire les règles dynamiquement depuis TRADUCTIONS.txt

Le script parse TRADUCTIONS.txt au démarrage et génère les règles
de vérification automatiquement. Plus aucune règle en dur.

* Règles dynamiques depuis TRADUCTIONS.txt

Le script CI lit les lignes INTERDIT de TRADUCTIONS.txt pour générer
les règles de vérification. Plus aucune règle en dur dans le script.
Corrige les 27 violations restantes (Depuis PHP → À partir de PHP).

* Corriger les trailing whitespace
2026-02-25 13:13:51 +01:00

265 lines
9.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.filesystemiterator" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>&class.theclass; <classname>FilesystemIterator</classname></title>
<titleabbrev>FilesystemIterator</titleabbrev>
<partintro>
<!-- {{{ FilesystemIterator intro -->
<section xml:id="filesystemiterator.intro">
&reftitle.intro;
<para>
L'itérateur <classname>FilesystemIterator</classname>.
</para>
</section>
<!-- }}} -->
<section xml:id="filesystemiterator.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>FilesystemIterator</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>DirectoryIterator</classname>
</ooclass>
<classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.current-mode-mask">FilesystemIterator::CURRENT_MODE_MASK</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.current-as-pathname">FilesystemIterator::CURRENT_AS_PATHNAME</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.current-as-fileinfo">FilesystemIterator::CURRENT_AS_FILEINFO</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.current-as-self">FilesystemIterator::CURRENT_AS_SELF</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.key-mode-mask">FilesystemIterator::KEY_MODE_MASK</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.key-as-pathname">FilesystemIterator::KEY_AS_PATHNAME</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.follow-symlinks">FilesystemIterator::FOLLOW_SYMLINKS</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.key-as-filename">FilesystemIterator::KEY_AS_FILENAME</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.new-current-and-key">FilesystemIterator::NEW_CURRENT_AND_KEY</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.other-mode-mask">FilesystemIterator::OTHER_MODE_MASK</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.skip-dots">FilesystemIterator::SKIP_DOTS</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="filesystemiterator.constants.unix-paths">FilesystemIterator::UNIX_PATHS</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.filesystemiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='FilesystemIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.filesystemiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='FilesystemIterator'])">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.directoryiterator')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DirectoryIterator'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.splfileinfo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='SplFileInfo'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
</section>
<!-- {{{ FilesystemIterator constants -->
<section xml:id="filesystemiterator.constants">
&reftitle.constants;
<variablelist>
<varlistentry xml:id="filesystemiterator.constants.current-as-pathname">
<term><constant>FilesystemIterator::CURRENT_AS_PATHNAME</constant></term>
<listitem>
<para>
<methodname>FilesystemIterator::current</methodname> retourne le nom
du chemin.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.current-as-fileinfo">
<term><constant>FilesystemIterator::CURRENT_AS_FILEINFO</constant></term>
<listitem>
<para>
<methodname>FilesystemIterator::current</methodname> retourne un
objet <classname>SplFileInfo</classname>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.current-as-self">
<term><constant>FilesystemIterator::CURRENT_AS_SELF</constant></term>
<listitem>
<para>
<methodname>FilesystemIterator::current</methodname> retourne
<literal>$this</literal> (le <classname>FilesystemIterator</classname>).
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.current-mode-mask">
<term><constant>FilesystemIterator::CURRENT_MODE_MASK</constant></term>
<listitem>
<para>
Masque <methodname>FilesystemIterator::current</methodname>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.key-as-pathname">
<term><constant>FilesystemIterator::KEY_AS_PATHNAME</constant></term>
<listitem>
<para>
<methodname>FilesystemIterator::key</methodname> retourne le nom de
chemin.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.key-as-filename">
<term><constant>FilesystemIterator::KEY_AS_FILENAME</constant></term>
<listitem>
<para>
<methodname>FilesystemIterator::key</methodname> retourne le nom
du fichier.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.follow-symlinks">
<term><constant>FilesystemIterator::FOLLOW_SYMLINKS</constant></term>
<listitem>
<para>Makes <methodname>RecursiveDirectoryIterator::hasChildren</methodname> follow symlinks.</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.key-mode-mask">
<term><constant>FilesystemIterator::KEY_MODE_MASK</constant></term>
<listitem>
<para>
Masque <methodname>FilesystemIterator::key</methodname>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.new-current-and-key">
<term><constant>FilesystemIterator::NEW_CURRENT_AND_KEY</constant></term>
<listitem>
<para>
Identique à <literal>FilesystemIterator::KEY_AS_FILENAME |
FilesystemIterator::CURRENT_AS_FILEINFO</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.other-mode-mask">
<term><constant>FilesystemIterator::OTHER_MODE_MASK</constant></term>
<listitem>
<para>
Masque utilisé pour <methodname>FilesystemIterator::getFlags</methodname> et <methodname>FilesystemIterator::setFlags</methodname>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.skip-dots">
<term><constant>FilesystemIterator::SKIP_DOTS</constant></term>
<listitem>
<para>Ignore les fichiers points
(<literal>.</literal> et <literal>..</literal>).
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="filesystemiterator.constants.unix-paths">
<term><constant>FilesystemIterator::UNIX_PATHS</constant></term>
<listitem>
<para>
Les chemins utilisent le séparateur de dossier de type Unix, soit
le slash, indépendamment du système de fonctionnement.
Il est à noter que le <parameter>chemin</parameter> qui est passé au constructeur
n'est pas modifié.
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- }}} -->
</partintro>
&reference.spl.entities.filesystemiterator;
</reference>
<!-- 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:"~/.phpdoc/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
-->