Skip to content

Commit

Permalink
Sync outcontrol section (yet again) (#757)
Browse files Browse the repository at this point in the history
  • Loading branch information
devnexen authored Jan 20, 2024
1 parent 22ba090 commit 4265b3f
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 40 deletions.
63 changes: 27 additions & 36 deletions reference/outcontrol/functions/flush.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6ab6ea465889620fc2a8cdaf7b008cbaed83c523 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 91ab4f5f898023b0eed0e642e1482ac11f749d20 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.flush">
Expand All @@ -16,42 +16,33 @@
<void/>
</methodsynopsis>
<para>
Vide les tampons d'écriture système de PHP et tous ceux que PHP utilisait
(CGI, un serveur web, etc.). Cette fonction tente d'envoyer tout
l'affichage courant au navigateur, sous quelques conditions.
</para>
<para>
<function>flush</function> peut ne pas être capable d'écraser le schéma du
tampon de votre serveur web et ceci n'aura aucun effet sur le tampon du
navigateur côté client. De plus, cette fonction n'affecte pas le mécanisme
d'affichage du tampon de l'espace utilisateur de PHP.
Cela signifie que <function>ob_flush</function> devrait être appelé avant
<function>flush</function> pour vider les tampons de sortie s'ils sont utilisés.
</para>
<para>
De nombreux serveurs, essentiellement sous Windows,
continueront à temporiser l'affichage de votre script
jusqu'à ce qu'il soit terminé, avant de transmettre
les résultats à l'internaute.
</para>
<para>
Des modules Apache comme mod_gzip utilisent leur propre temporisation,
ce qui fait que <function>flush</function> n'enverra pas les données
jusqu'au navigateur client immédiatement.
</para>
<para>
Même le navigateur peut réaliser une temporisation avant
de l'afficher. Netscape, par exemple, met en cache le texte
jusqu'à ce qu'il reçoive une fin de ligne, ou un début d'une balise
et il n'affichera pas les tables tant que la balise
&lt;/table&gt; la plus externe ne soit vue.
</para>
<para>
Certaines versions de Microsoft Internet Explorer ne commenceront
l'affichage de la page qu'après avoir reçu 256 octets d'affichage.
Cela vous obligera à envoyer des espaces supplémentaires
pour afficher la page.
Vide les tampons d'écriture système de PHP et du backend utilisé par PHP
(par exemple : CGI, un serveur web).
Dans un environnement en ligne de commande, <function>flush</function>
tentera de vider uniquement le contenu des tampons,
tandis que dans un contexte web, les en-têtes et le contenu des tampons sont vidés.
</para>
<note>
<simpara>
<function>flush</function> peut ne pas pouvoir contourner
le schéma de mise en mémoire tampon du serveur web
et n'a aucun effet sur une mise en mémoire tampon côté client dans le navigateur.
</simpara>
</note>
<note>
<simpara>
Cette fonction n'a aucun effet sur les gestionnaires de sortie de niveau utilisateur
tels que ceux démarrés par <function>ob_start</function>
ou <function>output_add_rewrite_var</function>.
</simpara>
</note>
<warning>
<simpara>
<function>flush</function> peut interférer avec les gestionnaires de sortie
qui définissent et envoient des en-têtes dans un contexte web (par exemple, <function>ob_gzhandler</function>)
en envoyant des en-têtes avant que ces gestionnaires ne puissent le faire.
</simpara>
</warning>
</refsect1>

<refsect1 role="parameters">
Expand Down
14 changes: 10 additions & 4 deletions reference/outcontrol/functions/ob-implicit-flush.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6851c0f2ae24bf7fd9fd5ce4391c8527722f614b Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1cdb6d04aa0d5c15c73337d0dca75d67e0f2e48e Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ob-implicit-flush" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -16,10 +16,16 @@
</methodsynopsis>
<para>
<function>ob_implicit_flush</function> active/désactive l'envoi implicite.
L'envoi implicite signifie que toute fonction qui envoie des données au
navigateur verra ses données envoyées immédiatement (la fonction
<function>flush</function> est appelée automatiquement).
La mise en mémoire tampon implicite entraînera une opération de vidage après chaque bloc
de code produisant une sortie, de sorte que des appels explicites à <function>flush</function>
ne seront plus nécessaires.
</para>
<note>
<simpara>
Afficher des chaînes vides ou envoyer des en-têtes n'est pas considéré comme une sortie
et ne déclenchera pas d'opération de vidage.
</simpara>
</note>
<note>
<simpara>
Cette fonction n'a aucun effet sur les gestionnaires de sortie de niveau utilisateur,
Expand Down

0 comments on commit 4265b3f

Please sign in to comment.