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/outcontrol/constants.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

236 lines
7.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2a8768782512db2b95e5da2f032dd0347806d203 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="outcontrol.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
&extension.constants.core;
<variablelist xml:id="outcontrol.constants.flags-passed-to-handler">
<title>Indicateurs d'état transmis au gestionnaire de sortie</title>
<para>
Les indicateurs suivants sont transmis au deuxième paramètre (<parameter>phase</parameter>) du gestionnaire de sortie défini par
<function>ob_start</function> sous forme de masque de bits :
</para>
<varlistentry xml:id="constant.php-output-handler-start">
<term>
<constant>PHP_OUTPUT_HANDLER_START</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que l'affichage de la mémoire tampon a commencé.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-write">
<term>
<constant>PHP_OUTPUT_HANDLER_WRITE</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que la mémoire tampon de sortie a commencé à
être affichée, et qu'elle contient des données.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-flush">
<term>
<constant>PHP_OUTPUT_HANDLER_FLUSH</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que la mémoire tampon a été affichée.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-clean">
<term>
<constant>PHP_OUTPUT_HANDLER_CLEAN</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que la mémoire tampon de sortie a été nettoyée.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-final">
<term>
<constant>PHP_OUTPUT_HANDLER_FINAL</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que c'est l'opération finale d'affichage de la mémoire tampon.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-cont">
<term>
<constant>PHP_OUTPUT_HANDLER_CONT</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que la mémoire tampon a été affichée, mais que la mise
en mémoire tampon de la sortie continue.
</para>
<para>
C'est un alias de la constante
<constant>PHP_OUTPUT_HANDLER_WRITE</constant>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-end">
<term>
<constant>PHP_OUTPUT_HANDLER_END</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que la mise en mémoire tampon de la sortie est terminée.
</para>
<para>
C'est un alias de la constante
<constant>PHP_OUTPUT_HANDLER_FINAL</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist xml:id="outcontrol.constants.buffer-control-flags">
<title>Indicateurs de contrôle du tampon de sortie</title>
<para>
Les indicateurs suivants peuvent être transmis au troisième paramètre (<parameter>flags</parameter>) du gestionnaire de sortie défini par
<function>ob_start</function> sous forme de masque de bits :
</para>
<varlistentry xml:id="constant.php-output-handler-cleanable">
<term>
<constant>PHP_OUTPUT_HANDLER_CLEANABLE</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Contrôle si un tampon de sortie créé par la fonction
<function>ob_start</function> peut être nettoyé
par <function>ob_clean</function>.
Cet indicateur ne contrôle pas le comportement de
<function>ob_end_clean</function> ou <function>ob_get_clean</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-flushable">
<term>
<constant>PHP_OUTPUT_HANDLER_FLUSHABLE</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Contrôle si un tampon de sortie créé par la fonction
<function>ob_start</function> peut être envoyé à la sortie standard
par <function>ob_flush</function>.
Cet indicateur ne contrôle pas le comportement de
<function>ob_end_flush</function> ou <function>ob_get_flush</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-removable">
<term>
<constant>PHP_OUTPUT_HANDLER_REMOVABLE</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Contrôle si un tampon de sortie créé par la fonction
<function>ob_start</function> peut être supprimé avant la fin
du script ou lors de l'appel de <function>ob_end_clean</function>,
<function>ob_end_flush</function>, <function>ob_get_clean</function> ou <function>ob_get_flush</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-stdflags">
<term>
<constant>PHP_OUTPUT_HANDLER_STDFLAGS</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Le jeu par défaut des drapeaux pour le tampon de sortie ;
actuellement, équivalent à
<constant>PHP_OUTPUT_HANDLER_CLEANABLE</constant> |
<constant>PHP_OUTPUT_HANDLER_FLUSHABLE</constant> |
<constant>PHP_OUTPUT_HANDLER_REMOVABLE</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist xml:id="outcontrol.constants.flags-returned-by-handler">
<title>Indicateurs d'état du gestionnaire de sortie</title>
<para>
Les indicateurs suivants font partie du masque de bits <literal>flags</literal>
retourné par <function>ob_get_status</function> :
</para>
<varlistentry xml:id="constant.php-output-handler-started">
<term>
<constant>PHP_OUTPUT_HANDLER_STARTED</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que le gestionnaire de sortie a été appelé.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-disabled">
<term>
<constant>PHP_OUTPUT_HANDLER_DISABLED</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que le gestionnaire de sortie est désactivé.
Cet indicateur est défini lorsque le gestionnaire de sortie retourne &false;
ou échoue lors du traitement du tampon.
Avant PHP 8.4.0, ce drapeau pouvait être défini lors du démarrage d'un tampon de sortie.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-output-handler-processed">
<term>
<constant>PHP_OUTPUT_HANDLER_PROCESSED</constant>
(<type>int</type>)
</term>
<listitem>
<para>
Indique que le gestionnaire de sortie a traité avec succès le tampon.
Disponible à partir de PHP 8.4.0.
</para>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- 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
-->