ob_implicit_flush
<<<		 ob_start Index des fonctions
>>>
7.77 Bufferisation de sortie
7 Index des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes prédefinies
. Exemples
. Voir aussi
. flush
. ob_clean
. ob_end_clean
. ob_end_flush
. ob_flush
. ob_get_clean
. ob_get_contents
. ob_get_length
. ob_get_level
. ob_get_status
. ob_gzhandler
. ob_implicit_flush
->ob_start

7.77.21 ob_start()Enclenche la bufferisation de sortie

[ Exemples avec ob_start ]   PHP 4

bool  ob_start ( callback   output_callback )

ob_start démarre la bufferisation de sortie. Tant qu'elle est enclenchée, aucune donnée, hormis les en-têtes, n'est envoyée au navigateur, mais temporairement mise en buffer.

Le contenu de ce buffer peut être copié dans une chaîne avec la fonction ob_get_contents . Pour afficher le contenu de ce buffer, utilisez ob_end_flush . Au contraire, ob_end_clean effacera le contenu de ce buffer.

Une fonction optionnelle de callback peut être spécifiée en troisième argument. ob_start prend une chaîne comme paramètre, et retourne une chaîne. Elle sera appelée par ob_end_flush ou lorsque le buffer sera envoyé au navigateur à la fin du script et recevra le contenu du buffer de sortie. Lorsque la fonction output_callback est appelée, elle doit retourner un nouveau contenu pour le buffer de sortie : celui-ci sera envoyé au navigateur.

Note

En PHP 4.0.4, ob_gzhandler a été introduit pour faciliter l'envoi de fichier compressé avec gz aux navigateurs web qui supportent les pages compressées. ob_gzhandler détermine le type d'encodage accepté par un navigateur, et retourne le contenu le plus adéquat.

Les buffers de sortie sont gérés par pile, c'est-à-dire que vous pouvez appeler plusieurs fois ob_start simultanément. Assurez-vous que vous appelez ob_end_flush suffisamment souvent. Si plusieurs fonctions de callback sont actives, les contenus seront filtrés séquentiellement, dans l'ordre d'emboîtement.

Exemple de gestion de sortie avec fonction utilisateur

<?php
function callback($buffer) {
  // remplace toutes les pommes par des carottes
  return (ereg_replace("pommes de terre", "carottes", $buffer));
}
ob_start("callback");
?>
<html>
<body>
<p>C'est comme comparer des carottes et des pommes de terre.
</body>
</html>
<?php
 ob_end_flush();
?>

Voir aussi ob_get_contents , ob_end_flush , ob_end_clean , ob_implicit_flush et ob_gzhandler .

<< ob_start >>
ob_implicit_flush Bufferisation de sortie Index des fonctions