Files
doc-fr/reference/outcontrol/functions/flush.xml
2021-09-24 04:13:47 +01:00

103 lines
3.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6ab6ea465889620fc2a8cdaf7b008cbaed83c523 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.flush">
<refnamediv>
<refname>flush</refname>
<refpurpose>Vide les tampons de sortie du système</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>flush</methodname>
<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.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>ob_flush</function></member>
<member><function>ob_clean</function></member>
<member><function>ob_end_flush</function></member>
<member><function>ob_end_clean</function></member>
</simplelist>
</para>
</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:"~/.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
-->