From b0544c3d23cd039afe6097eb3fe700dc3c344bad Mon Sep 17 00:00:00 2001 From: David Carlier Date: Tue, 16 Jan 2024 18:42:27 +0000 Subject: [PATCH] outcontrol section sync --- .../functions/ob-implicit-flush.xml | 9 +- .../functions/output-add-rewrite-var.xml | 54 +++++++----- .../functions/output-reset-rewrite-vars.xml | 12 +-- reference/outcontrol/ini.xml | 88 +++++++++++-------- 4 files changed, 95 insertions(+), 68 deletions(-) diff --git a/reference/outcontrol/functions/ob-implicit-flush.xml b/reference/outcontrol/functions/ob-implicit-flush.xml index 83e5bde121..17ac243760 100644 --- a/reference/outcontrol/functions/ob-implicit-flush.xml +++ b/reference/outcontrol/functions/ob-implicit-flush.xml @@ -1,6 +1,6 @@ - + @@ -20,6 +20,13 @@ navigateur verra ses données envoyées immédiatement (la fonction flush est appelée automatiquement). + + + Cette fonction n'a aucun effet sur les gestionnaires de sortie de niveau utilisateur, + tels que ceux démarrés par ob_start + ou output_add_rewrite_var. + + diff --git a/reference/outcontrol/functions/output-add-rewrite-var.xml b/reference/outcontrol/functions/output-add-rewrite-var.xml index 36422d527e..c6a405c3c9 100755 --- a/reference/outcontrol/functions/output-add-rewrite-var.xml +++ b/reference/outcontrol/functions/output-add-rewrite-var.xml @@ -1,6 +1,6 @@ - + @@ -17,26 +17,34 @@ stringvalue - Cette fonction ajoute une nouvelle paire nom/valeur au mécanisme de réécriture d'URL. - Le nom et la valeur sera ajouté aux URL (en tant que paramètre GET) et aux formulaires - (en tant que champs cachés) de la même façon que pour les identifiants de session - lorsque la réécriture d'URL est activée avec session.use_trans_sid. + Cette fonction démarre le gestionnaire de tampon de sortie 'URL-Rewriter' + s'il n'est pas actif, + stocke les paramètres name et value, + et lors de la vidange du tampon, réécrit les URLs + et les formulaires en fonction des paramètres ini applicables. + Les appels ultérieurs à cette fonction stockeront toutes les paires nom/valeur + supplémentaires jusqu'à ce que le gestionnaire soit désactivé. - Ce comportement est contrôlé par les options - url_rewriter.tags et - url_rewriter.hosts du &php.ini;. + Lorsque le tampon de sortie est vidé + (en appelant ob_flush, ob_end_flush, + ob_get_flush ou à la fin du script), + le gestionnaire 'URL-Rewriter' ajoute les paires nom/valeur + en tant que paramètres de requête aux URLs dans les attributs des balises HTML + et ajoute des champs cachés aux formulaires en fonction des valeurs des + directives de configuration url_rewriter.tags et + url_rewriter.hosts. - Il est à noter que cette fonction ne peut être appellé avec succès au plus - une fois par requête. + Chaque paire nom/valeur ajoutée au gestionnaire 'URL-Rewriter' + est ajoutée aux URLs et/ou formulaires + même si cela résulte en des paramètres de requête d'URL dupliqués + ou des éléments avec les mêmes attributs de nom. - L'appel à cette fonction démarre implicitement la temporisation de - sortie si elle n'est pas déjà activée. + Une fois que le gestionnaire 'URL-Rewriter' a été désactivé, + il ne peut pas être redémarré. @@ -87,13 +95,13 @@ 7.1.0 - Antérieur à php 7.1.0, la réécriture des variables définis par - output_add_rewrite_var utilisait la même mémoire - tampon de sortie que le module de session trans sid. À partir de PHP 7.1.0, le - tampon de sortie dédié est utilisé, - url_rewriter.tags - est utilisé uniquement pour les fonctions de sortie, ajout de url_rewriter.hosts. + À partir de PHP 7.1.0, un tampon de sortie dédié est utilisé, + url_rewriter.tags + est utilisé uniquement pour les fonctions de sortie et + url_rewriter.hosts est disponible. + Avant PHP 7.1.0, les variables de réécriture définies par output_add_rewrite_var + partageaient un tampon de sortie avec la prise en charge transparente de l'ID de session + (voir session.trans_sid_tags). @@ -110,6 +118,8 @@ ob_list_handlers url_rewriter.tags url_rewriter.hosts - session.trans_sid_tags - session.trans_sid_hosts diff --git a/reference/outcontrol/functions/output-reset-rewrite-vars.xml b/reference/outcontrol/functions/output-reset-rewrite-vars.xml index 5f09db1f82..a211a5330d 100755 --- a/reference/outcontrol/functions/output-reset-rewrite-vars.xml +++ b/reference/outcontrol/functions/output-reset-rewrite-vars.xml @@ -1,6 +1,6 @@ - + @@ -16,9 +16,8 @@ - Cette fonction annule la règle de réécriture et efface toutes les variables - de réécriture précédemment définies avec la fonction - output_add_rewrite_var. + Cette fonction supprime toutes les variables de réécriture précédemment définies par + la fonction output_add_rewrite_var. @@ -71,7 +70,8 @@ link'; @@ -85,7 +85,7 @@ echo 'link'; &example.outputs; link +link link ]]> diff --git a/reference/outcontrol/ini.xml b/reference/outcontrol/ini.xml index 68b5042ef2..b301ebb54f 100644 --- a/reference/outcontrol/ini.xml +++ b/reference/outcontrol/ini.xml @@ -1,6 +1,6 @@ - +
@@ -21,30 +21,31 @@ output_buffering - "0" + "0" PHP_INI_PERDIR output_handler - NULL + &null; PHP_INI_PERDIR implicit_flush - "0" + "0" PHP_INI_ALL url_rewriter.tags - "a=href,area=href,frame=src,form=,fieldset=" + "form=" PHP_INI_ALL - Avant PHP 7.1.0, il était utilisé pour - la réécriture d'URL quand le SID transparent était activé. Depuis PHP - 7.1.0, il est uniquement utilisé par la fonction + + À partir de PHP 7.1.0, ce paramètre INI n'a d'effet que sur output_add_rewrite_var. + Avant PHP 7.1.0, ce paramètre INI activait la prise en charge transparente + de l'ID de session (voir session.trans_sid_tags). @@ -68,13 +69,12 @@ - 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). - Cette directive est toujours désactivée en ligne - de commande. + La mise en mémoire tampon de la sortie pour tous les fichiers peut être activée + en définissant cette directive sur "On". + Pour limiter la taille du tampon, un nombre/quantité correspondant au + nombre maximal d'octets autorisés peut être utilisé à la place de + "On" pour la valeur de cette directive. + Par exemple, output_buffering=4096. @@ -86,18 +86,26 @@ - 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. + La sortie des scripts peut être redirigée vers une fonction. + Par exemple, en définissant output_handler + sur mb_output_handler, le codage des caractères sera + converti de manière transparente vers le codage spécifié. + La configuration de n'importe quel gestionnaire de sortie active + automatiquement la mise en mémoire tampon de la sortie. - Vous ne pouvez pas utiliser simultanément mb_output_handler avec - ob_iconv_handler, non plus que - ob_gzhandler avec - zlib.output_compression. + mb_output_handler et + ob_iconv_handler ne peuvent pas être utilisés ensemble, + et ob_gzhandler et + zlib.output_compression + ne peuvent pas être utilisés avec l'un des éléments suivants : + mb_output_handler, + ob_gzhandler, + zlib.output_compression, + le gestionnaire 'URL-Rewriter' + (voir session.use_trans_sid + et output_add_rewrite_var). @@ -120,9 +128,9 @@ à 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. + toute fonction produisant une sortie (comme + print ou echo) + et chaque bloc HTML. Lorsque vous utilisez PHP en environnement web, activer cette @@ -144,23 +152,27 @@ - Spécifie quelles sont les balises HTML qui doivent - être réécrites par les valeurs de la fonction - output_add_rewrite_var. Par défaut, il vaut - a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=. + url_rewriter.tags spécifie les balises HTML et les attributs + dans lesquels les URLs sont réécrites par les valeurs de + output_add_rewrite_var. Par défaut, c'est "form=". - form est une balise spéciale. La variable de formulaire - <input hidden="session_id" name="session_name"> - est ajoutée. + Ajouter "form=" ou n'importe quel attribut form + ajoutera un élément input caché dans le form + avec un attribut de nom et de valeur pour chaque paire nom-valeur transmise à + output_add_rewrite_var. + + + Ajouter la même balise plus d'une fois à url_rewriter.tags + utilisera uniquement la première occurrence pendant le processus de réécriture d'URL. + + - Avant PHP 7.1.0, url_rewriter.tags + Antérieur à PHP 7.1.0, url_rewriter.tags était utilisé pour spécifier session.trans_sid_tags. - À partir de PHP 7.1.0, fieldset n'est plus considéré comme - une balise spéciale. @@ -177,7 +189,7 @@ pour includes les valeurs de la fonction output_add_rewrite_var. Par défaut $_SERVER['HTTP_HOST']. Plusieurs - hôtes peuvent être spécifiés séparé par ",", aucun espace n'est autorisé + hôtes peuvent être spécifiés séparé par une virgule, aucun espace n'est autorisé entre les hôtes. Par exemple : php.net,wiki.php.net,bugs.php.net