8.93 Bufferisation de sortie
8 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Exemples
. Voir aussi
. flush
. ob_clean
. ob_end_clean
. ob_end_flush
. ob_flush
. ob_get_clean
. ob_get_contents
. ob_get_flush
. ob_get_length
. ob_get_level
. ob_get_status
. ob_gzhandler
. ob_implicit_flush
. ob_list_handlers
->ob_start
. output_add_rewrite_var
. output_reset_rewrite_vars
|
8.93.23 ob_start()Enclenche la bufferisation de sortie[ Exemples avec ob_start ] PHP 4, PHP 5
bool
ob_start (
callback
output_callback
,
int
chunk_size
,
bool
erase
)
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. Si
output_callback
n'est pas une fonction accessible, la fonction retournera
FALSE
.
Si la fonction de callback a deux paramètres, le second est composé
du champ bits constitué par
PHP_OUTPUT_HANDLER_START
,
PHP_OUTPUT_HANDLER_CONT
et
PHP_OUTPUT_HANDLER_END
.
| Note | |
En PHP 4.0.4,
ob_gzhandler
a été
introduite pour faciliter l'envoi de fichiers compressés
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.
|
| Note | |
Avant PHP 4.3.2, cette fonction ne retournait pas
FALSE
dans le cas où
output_callback
ne pouvait être exécutée.
|
| Attention | |
Quelques serveurs web (e.g. Apache) modifient le dossier de travail d'un script
lorsqu'il appelle une fonction de callback. Vous pouvez revenir à un comportement
normal en ajoutant
chdir(dirname($_SERVER['SCRIPT_FILENAME']))
dans votre fonction de callback.
|
Si le paramètre optionnel
chunk_size
est passé,
la fonction de callback est appelée à chaque nouvelle ligne après
chunk_size
octets d'affichage.
Le paramètre
output_callback
peut être outrepassé en lui affectant la valeur
NULL
.
Si le paramètre optionnel
erase
est défini à
FALSE
, le buffer ne sera pas effacé tant que le script ne sera pas terminé
(depuis PHP 4.3.0).
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.
ob_end_clean
,
ob_end_flush
,
ob_clean
,
ob_flush
et
ob_start
ne doivent pas être appelés depuis une fonction de callback.
Si vous les appelez depuis une fonction de callback, le comportement
ne sera pas défini. Si vous voulez effacer le contenu du buffer, retournez ""
(une chaîne vide) comme fonction de callback.
Vous ne pourrez jamais appeler les fonctions utilisant la fonction de bufferisation de sortie
comme
print_r($expression, true)
ou
highlight_file($filename, true)
depuis une fonction de coolback.
| 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.</p>
</body>
</html>
<?php
ob_end_flush();
?>
|
Voir aussi
ob_get_contents
,
ob_end_flush
,
ob_end_clean
,
ob_implicit_flush
,
ob_gzhandler
,
ob_iconv_handler
,
mb_output_handler
et
ob_tidyhandler
.
|
