Bufferisation de sortie
Introduction
Les fonctions de bufferisation de sortie vous permettent de contrôler quand les données ont été envoyées par le script. Cela peut être utile dans certaines situations, notamment si vous devez envoyer des en-têtes au navigateur après avoir envoyé des données. Ces fonctions n'affectent pas les en-têtes envoyés par la fonction header() ou les cookies envoyés par setcookie(). Seules les fonctions telles que echo() et les données entre blocs PHP sont affectées.
Note: Lors de la mise à jour depuis PHP 4.1.x (et 4.2.x) vers 4.3.x, à cause d'un bogue dans les versions précédentes, vous devez vous assurer que implict_flush vaut OFF dans votre php.ini, sinon, tout affichage avec la fonction ob_start() sera caché.
Pré-requis
Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.
Installation
Il n'y pas d'installation nécessaire pour utiliser ces fonctions, elles font parties du coeur de PHP.
Configuration à l'exécution
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| output_buffering | "0" | PHP_INI_PERDIR | |
| output_handler | NULL | PHP_INI_PERDIR | Disponible depuis PHP 4.0.4. |
| implicit_flush | "0" | PHP_INI_ALL | PHP_INI_PERDIR en PHP <= 4.2.3. |
Voici un éclaircissement sur l'utilisation des directives de configuration.
- output_buffering booléen/entier
-
Vous pouvez activer la bufferisation de sortie pour tous les fichiers avec cette directive, en lui passant la valeur On. Si vous souhaitez limiter la taille du buffer à une certaine taille, vous pouvez alors indiquer un nombre maximum d'octets à la place de On. Par exemple, output_buffering=4096). Depuis PHP 4.3.5, cette directive est toujours désactivée en ligne de commande.
- output_handler string
-
Vous pouvez rediriger le résultat de tous vos scripts à une fonction avant leur envoi au navigateur. Par exemple, si vous configurez output_handler à mb_output_handler(), l'encodage des caractères sera adapté de manière transparente. Configurer une telle fonction active automatiquement la bufferisation de sortie.
Note: Vous ne pouvez pas utiliser simultanément mb_output_handler() avec ob_iconv_handler(), non plus que ob_gzhandler() avec zlib.output_compression.
Note: Seules les fonctions internes peuvent être utilisées avec cette directive. Pour les fonctions utilisateurs, utilisez ob_start().
- implicit_flush booléen
-
FALSE par défaut. En changeant cette valeur pour TRUE vous indiquez à PHP que le buffer de sortie doit être vidé automatiquement après chaque fonction d'affichage. Cela revient à appeler la fonction flush() après chaque appel à print() ou echo() et pour tous les blocs HTML.
Lorsque vous utilisez PHP en environnement web, activer cette option a de sérieuses implications et généralement, cela n'est conseillé que pour les débogage. Cette valeur est par défaut à TRUE lorsque PHP fonctionne en mode CLI SAPI.
Voir aussi ob_implicit_flush().
Types de ressources
Cette extension ne définit aucune ressource.
Constantes pré-définies
Cette extension ne définit aucune constante.
Exemples
Example#1 Exemple de bufferisation de sortie
<?php
ob_start();
echo "Bonjour\n";
setcookie("nom_du_cookie", "valeur_du_cookie");
ob_end_flush();
?>
Dans l'exemple ci-dessus, la fonction echo() est stockée dans un buffer jusqu'à l'appel de la fonction ob_end_flush(). Dans le même temps, l'appel à setcookie() a réussi à créer un cookie, sans générer d'erreur. (D'habitude, vous devez envoyer les en-têtes avant les données).
Voir aussi
Voir aussi header() et setcookie().
Table of Contents
- flush — Vide les tampons de sortie
- ob_clean — Efface le 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_flush — Envoie le tampon de sortie
- ob_get_clean — Lit le contenu courant du tampon de sortie puis l'efface
- ob_get_contents — Retourne le contenu du tampon de sortie
- ob_get_flush — Vide le tampon, le retourne en tant que chaîne et stoppe la tamporisation
- ob_get_length — Retourne la longueur du contenu du tampon de sortie
- ob_get_level — Retourne le nombre de niveaux d'imbrications du système de tamporisation de sortie
- ob_get_status — Lit le statut du tampon de sortie
- ob_gzhandler — Fonction de callback pour la compression automatique des tampons
- ob_implicit_flush — Active/désactive l'envoi implicite
- ob_list_handlers — Liste les gestionnaires d'affichage utilisés
- ob_start — Enclenche la tamporisation de sortie
- output_add_rewrite_var — Ajoute une règle de réécriture d'URL
- output_reset_rewrite_vars — Annule la réécriture d'URL