diff --git a/reference/outcontrol/constants.xml b/reference/outcontrol/constants.xml index de74e3fe82..7cb2be2b7b 100644 --- a/reference/outcontrol/constants.xml +++ b/reference/outcontrol/constants.xml @@ -1,12 +1,12 @@ - + &reftitle.constants; &extension.constants.core; - + Indicateurs d'état transmis au gestionnaire de sortie Les indicateurs suivants sont transmis au deuxième paramètre (phase) du gestionnaire de sortie défini par @@ -100,7 +100,7 @@ - + Indicateurs de contrôle du tampon de sortie Les indicateurs suivants peuvent être transmis au troisième paramètre (flags) du gestionnaire de sortie défini par @@ -166,7 +166,7 @@ - + Indicateurs d'état du gestionnaire de sortie Les indicateurs suivants font partie du masque de bits flags diff --git a/reference/outcontrol/functions/ob-clean.xml b/reference/outcontrol/functions/ob-clean.xml index 4ecf57142e..aae4d333a3 100644 --- a/reference/outcontrol/functions/ob-clean.xml +++ b/reference/outcontrol/functions/ob-clean.xml @@ -1,11 +1,11 @@ - + ob_clean - Efface le tampon de sortie + Nettoyer (effacer) le contenu du tampon de sortie actif. @@ -15,19 +15,19 @@ - Cette fonction vide le tampon de sortie sans - l'envoyer au navigateur. + Cette fonction appelle le gestionnaire de sortie + (avec le drapeau PHP_OUTPUT_HANDLER_CLEAN), + ignore sa valeur de retour + et nettoie (efface) le contenu du tampon de sortie actif. - Cette fonction ne détruit pas le contenu du tampon de - sortie comme peut le faire - ob_end_clean. + Cette fonction ne désactive pas le tampon de sortie actif comme le font + ob_end_clean ou ob_get_clean. - Le tampon de sortie doit avoir été démarré avec la fonction - ob_start et le drapeau PHP_OUTPUT_HANDLER_CLEANABLE. - Sinon, la fonction ob_clean ne fonctionnera pas. + ob_clean échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_CLEANABLE. @@ -43,6 +43,13 @@ + + &reftitle.errors; + + Si la fonction échoue, elle génère un E_NOTICE. + + + &reftitle.seealso; diff --git a/reference/outcontrol/functions/ob-end-clean.xml b/reference/outcontrol/functions/ob-end-clean.xml index 3b180ddd6e..6d2c85c48a 100644 --- a/reference/outcontrol/functions/ob-end-clean.xml +++ b/reference/outcontrol/functions/ob-end-clean.xml @@ -1,12 +1,12 @@ - + ob_end_clean - Détruit les données du tampon de sortie et éteint la temporisation de sortie + Effacez (nettoyez) le contenu du tampon de sortie actif et désactivez-le. @@ -16,20 +16,23 @@ - Cette fonction efface le contenu du premier - tampon de sortie et désactive la temporisation de sortie. - Si vous voulez traiter le contenu du tampon, vous devrez - appeler ob_get_contents avant - ob_end_clean, car le tampon est - détruit par ob_end_clean. + Cette fonction appelle le gestionnaire de sortie + (avec les drapeaux PHP_OUTPUT_HANDLER_CLEAN et + PHP_OUTPUT_HANDLER_FINAL), + ignore sa valeur de retour, + ignore le contenu du tampon de sortie actif + et désactive ce dernier. - Le tampon de sortie doit avoir été démarré avec la fonction - ob_start et les drapeaux PHP_OUTPUT_HANDLER_CLEANABLE - et PHP_OUTPUT_HANDLER_REMOVABLE. - Sinon, la fonction ob_end_clean ne fonctionnera pas. + ob_end_clean échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_REMOVABLE. + + + ob_end_clean + supprimera le contenu du tampon de sortie actif + même s'il a été démarré sans le drapeau + PHP_OUTPUT_HANDLER_CLEANABLE. @@ -41,9 +44,7 @@ &reftitle.returnvalues; - &return.success; Les raisons d'un tel échec sont que la - temporisation de sortie pouvait ne pas être activée, ou que, pour - une raison quelconque, le tampon n'a pu être détruit. + &return.success; @@ -57,8 +58,8 @@ &reftitle.examples; - L'exemple suivant montre comment se débarrasser de tous les - tampons de sortie : + L'exemple suivant montre une manière simple de se débarrasser du + contenu du tampon de sortie actif : @@ -82,7 +83,9 @@ ob_end_clean(); ob_start ob_get_contents - ob_flush + ob_clean + ob_get_clean + ob_end_flush diff --git a/reference/outcontrol/functions/ob-end-flush.xml b/reference/outcontrol/functions/ob-end-flush.xml index 2056f3e19b..21d54b1f19 100644 --- a/reference/outcontrol/functions/ob-end-flush.xml +++ b/reference/outcontrol/functions/ob-end-flush.xml @@ -1,12 +1,15 @@ - + ob_end_flush - Envoie les données du tampon de sortie et éteint la temporisation de sortie + + Vide (envoie) la valeur de retour du gestionnaire de sortie actif + et désactive le tampon de sortie actif + @@ -16,27 +19,23 @@ - Envoie le contenu du tampon de sortie (s'il existe) et éteint la - temporisation de sortie. Si vous voulez continuer à manipuler la - valeur du tampon, vous pouvez appeler ob_get_contents - avant ob_end_flush car le contenu du tampon - est détruit après un appel à ob_end_flush. + Cette fonction appelle le gestionnaire de sortie + (avec le drapeau PHP_OUTPUT_HANDLER_FINAL), + vide (envoie) sa valeur de retour, + ignore le contenu du tampon de sortie actif + et désactive ce dernier. - Le tampon de sortie doit avoir été démarré avec la fonction - ob_start et les drapeaux PHP_OUTPUT_HANDLER_FLUSHABLE - et PHP_OUTPUT_HANDLER_REMOVABLE. - Sinon, la fonction ob_end_flush ne fonctionnera pas. + ob_end_flush échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_REMOVABLE. + + + ob_end_flush videra (enverra) + la valeur de retour du gestionnaire de sortie + même si le tampon de sortie actif a été démarré sans le drapeau + PHP_OUTPUT_HANDLER_FLUSHABLE. - - - Cette fonction est similaire à ob_get_flush, excepté - que ob_get_flush retourne le tampon comme une chaîne - de caractères. - - @@ -47,10 +46,7 @@ &reftitle.returnvalues; - &return.success; Les raisons d'échec sont que vous pourriez avoir - appelé la fonction sans avoir de tampon actif, ou que, pour une - raison quelconque, le tampon n'a pu être effacé (possible pour un - tampon spécial). + &return.success; @@ -87,8 +83,8 @@ while (@ob_end_flush()); ob_start ob_get_contents - ob_get_flush ob_flush + ob_get_flush ob_end_clean diff --git a/reference/outcontrol/functions/ob-flush.xml b/reference/outcontrol/functions/ob-flush.xml index 56ffe2f100..5bc7bf07f5 100644 --- a/reference/outcontrol/functions/ob-flush.xml +++ b/reference/outcontrol/functions/ob-flush.xml @@ -1,11 +1,11 @@ - + ob_flush - Envoie le tampon de sortie + Vide (envoie) la valeur de retour du gestionnaire de sortie actif. @@ -15,14 +15,19 @@ - Envoie le contenu du tampon de sortie (s'il y en a un). Si vous voulez - vérifier le contenu du tampon, vous devez appeler la fonction - ob_get_contents avant ob_flush - car le contenu du tampon est effacé après l'appel de ob_flush. + Cette fonction appelle le gestionnaire de sortie + (avec le drapeau PHP_OUTPUT_HANDLER_FLUSH), + vide (envoie) sa valeur de retour + et ignore le contenu du tampon de sortie actif. - ob_flush ne désactive pas la temporisation de sortie - comme peut le faire ob_end_flush. + Cette fonction ne désactive pas le tampon de sortie actif comme le font + ob_end_flush ou ob_get_flush. + + + ob_flush échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_FLUSHABLE. @@ -38,14 +43,22 @@ + + &reftitle.errors; + + If the function fails it generates an E_NOTICE. + + + &reftitle.seealso; + ob_start ob_get_contents - ob_clean ob_end_flush - ob_end_clean + ob_get_flush + ob_clean diff --git a/reference/outcontrol/functions/ob-get-clean.xml b/reference/outcontrol/functions/ob-get-clean.xml index 07c494a0fc..b0e6e0ebf5 100644 --- a/reference/outcontrol/functions/ob-get-clean.xml +++ b/reference/outcontrol/functions/ob-get-clean.xml @@ -1,11 +1,11 @@ - + ob_get_clean - Lit le contenu courant du tampon de sortie puis l'efface + Obtiens le contenu du tampon de sortie actif et désactive-le @@ -15,20 +15,23 @@ - Lit le contenu courant du tampon de sortie puis l'efface. + Cette fonction appelle le gestionnaire de sortie + (avec les drapeaux PHP_OUTPUT_HANDLER_CLEAN et + PHP_OUTPUT_HANDLER_FINAL), + ignore sa valeur de retour, + retourne le contenu du tampon de sortie actif + et désactive ce dernier. - ob_get_clean exécute successivement - ob_get_contents et - ob_end_clean. + ob_get_clean échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_REMOVABLE. - Le tampon de sortie doit avoir été démarré avec la fonction - ob_start et le drapeau PHP_OUTPUT_HANDLER_CLEANABLE - et PHP_OUTPUT_HANDLER_REMOVABLE. - Sinon ob_get_clean ne fonctionnera pas. + ob_get_clean + supprimera le contenu du tampon de sortie actif + même s'il a été démarré sans le drapeau + PHP_OUTPUT_HANDLER_CLEANABLE. @@ -40,9 +43,22 @@ &reftitle.returnvalues; - Retourne le contenu du tampon de sortie et termine la session de - temporisation. Si la temporisation n'est pas activée, alors &false; - sera retourné. + Renvoie le contenu du tampon de sortie actif en cas de succès + ou &false; en cas d'échec. + + + + ob_get_clean renverra false + mais ne générera pas de E_NOTICE + s'il n'y a pas de tampon de sortie actif. + + + + + + &reftitle.errors; + + En cas d'échec de la fonction, elle génère un E_NOTICE. @@ -82,8 +98,11 @@ string(18) "bonjour le monde !" &reftitle.seealso; - ob_get_contents ob_start + ob_get_contents + ob_clean + ob_end_clean + ob_get_flush diff --git a/reference/outcontrol/functions/ob-get-flush.xml b/reference/outcontrol/functions/ob-get-flush.xml index b893a0e561..2b0da83513 100755 --- a/reference/outcontrol/functions/ob-get-flush.xml +++ b/reference/outcontrol/functions/ob-get-flush.xml @@ -1,11 +1,14 @@ - + ob_get_flush - Vide le tampon, le retourne en tant que chaîne et stoppe la temporisation + + Vide (envoie) la valeur de retour du gestionnaire de sortie actif, + renvoie le contenu du tampon de sortie actif et le désactive. + @@ -15,21 +18,23 @@ - ob_get_flush vide le tampon, le retourne en tant - que chaîne et stoppe la temporisation. + Cette fonction appelle le gestionnaire de sortie + (avec le drapeau PHP_OUTPUT_HANDLER_FINAL), + envoie (vide) sa valeur de retour, + renvoie le contenu du tampon de sortie actif + et désactive le tampon de sortie actif. - Le tampon de sortie doit avoir été démarré avec la fonction - ob_start et le drapeau PHP_OUTPUT_HANDLER_FLUSHABLE. - Sinon, la fonction ob_get_flush ne fonctionnera pas. + ob_get_flush échouera + sans un tampon de sortie actif démarré avec le drapeau + PHP_OUTPUT_HANDLER_REMOVABLE. + + + ob_get_flush videra (enverra) + la valeur de retour du gestionnaire de sortie + même si le tampon de sortie actif a été démarré sans le + drapeau PHP_OUTPUT_HANDLER_FLUSHABLE. - - - Cette fonction est similaire à ob_end_flush, sauf que - cette fonction retourne également le tampon sous forme de chaîne. - - @@ -40,8 +45,16 @@ &reftitle.returnvalues; - Retourne le tampon de sortie ou &false; s'il n'y en a aucun - d'actif. + Renvoie le contenu du tampon de sortie actif en cas de succès + ou &false; en cas d'échec. + + + + + &reftitle.errors; + + En cas d'échec de la fonction, elle génère un E_NOTICE. + @@ -84,9 +97,11 @@ Array &reftitle.seealso; - ob_end_clean + ob_start + ob_get_contents + ob_flush ob_end_flush - ob_list_handlers + ob_get_clean diff --git a/reference/outcontrol/functions/ob-get-level.xml b/reference/outcontrol/functions/ob-get-level.xml index e620de26e6..5d0c998162 100644 --- a/reference/outcontrol/functions/ob-get-level.xml +++ b/reference/outcontrol/functions/ob-get-level.xml @@ -1,6 +1,6 @@ - + @@ -31,6 +31,17 @@ Retourne le nombre de niveaux d'imbrications du système de temporisation de sortie, et zéro s'il n'est pas actif. + + + La valeur pour les niveaux identiques entre ob_get_level + et ob_get_status diffère de un. + + Pour ob_get_level, + le premier niveau est 1. + Tandis que pour ob_get_status, + le premier niveau est 0. + + @@ -38,6 +49,7 @@ ob_start + ob_get_status ob_get_contents diff --git a/reference/outcontrol/functions/ob-get-status.xml b/reference/outcontrol/functions/ob-get-status.xml index 0654e01ad3..63fb35728b 100644 --- a/reference/outcontrol/functions/ob-get-status.xml +++ b/reference/outcontrol/functions/ob-get-status.xml @@ -1,5 +1,5 @@ - + @@ -60,11 +60,8 @@ name - Nom du gestionnaire de sortie actif tel que défini par le paramètre callback - de la fonction ob_start, - output_handler si - output_buffering est activé - ou 'default output handler' si aucun n'est défini + Nom du gestionnaire de sortie actif (voir les valeurs de retour de + ob_list_handlers pour plus de détails) @@ -80,7 +77,7 @@ Masque de bits des indicateurs définis par la fonction ob_start, le type de gestionnaire de sortie (voir ci-dessus) et l'état du processus de mise en mémoire tampon - ( + ( PHP_OUTPUT_HANDLER_* constantes). Si le gestionnaire a traité avec succès le tampon et n'a pas retourné &false;, @@ -118,6 +115,7 @@ buffer_used Taille des données dans le tampon de sortie en octets + (la même que la valeur de retour entière de ob_get_length) @@ -186,6 +184,7 @@ Array ob_get_level ob_list_handlers + ob_get_length ob_start