ob_start
(PHP 4, PHP 5)
ob_start — Enclenche la temporisation de sortie
Description
ob_start() démarre la temporisation 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 tampon.
Le contenu de ce tampon peut être copié dans une chaîne avec la fonction ob_get_contents(). Pour afficher le contenu de ce tampon, utilisez ob_end_flush(). Au contraire, ob_end_clean() effacera le contenu de ce tampon.
Quelques serveurs web (par exemple Apache) modifient le dossier de travail d'un script lorsqu'il appelle une fonction de rappel. Vous pouvez revenir à un comportement normal en ajoutant chdir(dirname($_SERVER['SCRIPT_FILENAME'])) dans votre fonction de rappel.
Les tampons 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 rappel sont actives, les contenus seront filtrés séquentiellement, dans l'ordre d'emboîtement.
Liste de paramètres
-
output_callback
-
Une fonction optionnelle de rappel peut être spécifiée. Cette fonction prend une chaîne comme paramètre, et retourne une chaîne. Elle sera appelée lorsque le tampon sera envoyé ou supprimé (avec les fonctions ob_flush(), ob_clean() ou des fonctions similaires) ou lorsque le tampon sera envoyé au navigateur à la fin du script et recevra le contenu du tampon de sortie. Lorsque la fonction
output_callback
est appelée, elle doit retourner un nouveau contenu pour le tampon de sortie : celui-ci sera envoyé au navigateur. Sioutput_callback
n'est pas une fonction accessible, la fonction retourneraFALSE
. Voici la signature de la fonction de rappel :bool handler ( string$buffer
[, int$phase
] )-
buffer
- Contenu du buffer de sortie.
-
phase
-
Masque de constantes
PHP_OUTPUT_HANDLER_*
.
Si
output_callback
retourneFALSE
, l'entrée originale est envoyée au navigateur.Le paramètre
output_callback
peut être annulé en y passant la valeurNULL
.ob_end_clean(), ob_end_flush(), ob_clean(), ob_flush() et ob_start() ne doivent pas être appelés depuis une fonction de rappel. Si vous les appelez depuis une fonction de rappel, le comportement ne sera pas défini. Si vous voulez effacer le contenu du tampon, retournez "" (une chaîne vide) comme fonction de rappel. Vous ne pourrez jamais appeler les fonctions utilisant la fonction de temporisation de sortie comme print_r($expression, true) ou highlight_file($filename, true) depuis une fonction de rappel.
Note:
En PHP 4.0.4, ob_gzhandler() a été introduite pour faciliter l'envoi de fichiers compressés avec gzip 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.
-
-
chunk_size
-
Si le paramètre optionnel
chunk_size
est passé, la fonction de rappel est appelée à chaque nouvelle ligne aprèschunk_size
octets d'affichage. La valeur par défaut 0 (zéro) signifie que l'affichage de la fonction ne sera appelé que lorsque le buffer de sortie est clos.Avant la version PHP 5.4.0, la valeur 1 était une valeur spéciale qui définissait la taille du morceau à 4096 octets.
-
erase
-
Si le paramètre optionnel
erase
est défini àFALSE
, le tampon ne sera pas effacé tant que le script ne sera pas terminé. Ceci aura pour effet d'émettre une notice et de retournerFALSE
lors de l'appel aux fonctions d'affichage et de nettoyage.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Historique
Version | Description |
---|---|
5.4.0 | Une taille de morceau de 1 résulte maintenant en 1 octet envoyé au buffer de sortie. |
4.3.2 |
Cette fonction a été modifiée pour retourner FALSE dans le cas
où output_callback ne peut être exécuté.
|
4.2.0 |
Ajout du paramètre erase .
|
Exemples
Exemple #1 Exemple de gestion de sortie avec fonction de rappel
<?php function rappel($buffer) { // remplace toutes les pommes par des carottes return (ereg_replace("pommes de terre", "carottes", $buffer)); } ob_start("rappel"); ?> <html> <body> <p>C'est comme comparer des carottes et des pommes de terre.</p> </body> </html> <?php ob_end_flush(); ?>
L'exemple ci-dessus va afficher :
<html> <body> <p>C'est comme comparer des carottes et des carottes.</p> </body> </html>
Voir aussi
- ob_get_contents() - Retourne le contenu du tampon de sortie
- ob_end_clean() - Détruit les données du tampon de sortie et éteint la tamporisation de sortie
- ob_end_flush() - Envoie les données du tampon de sortie et éteint la tamporisation de sortie
- ob_implicit_flush() - Active/désactive l'envoi implicite
- ob_gzhandler() - Fonction de rappel pour la compression automatique des tampons
- ob_iconv_handler() - Gestionnaire de sortie pour maîtriser le jeu de caractères de sortie
- mb_output_handler() - Fonction de traitement des affichages
- ob_tidyhandler() - Fonction de rappel ob_start pour réparer le buffer