From e08162a5cf883fcd596e105978d3ac0bbe0c3223 Mon Sep 17 00:00:00 2001 From: Martin Samesch Date: Sun, 15 Sep 2024 20:13:56 +0000 Subject: [PATCH] Add files via upload --- .../outcontrol/functions/ob-get-clean.xml | 128 ++++++++++ .../outcontrol/functions/ob-get-flush.xml | 127 ++++++++++ .../outcontrol/functions/ob-get-length.xml | 100 ++++++++ .../outcontrol/functions/ob-get-status.xml | 222 ++++++++++++++++++ .../outcontrol/functions/ob-list-handlers.xml | 219 +++++++++++++++++ .../functions/output-reset-rewrite-vars.xml | 132 +++++++++++ 6 files changed, 928 insertions(+) create mode 100644 reference/outcontrol/functions/ob-get-clean.xml create mode 100644 reference/outcontrol/functions/ob-get-flush.xml create mode 100644 reference/outcontrol/functions/ob-get-length.xml create mode 100644 reference/outcontrol/functions/ob-get-status.xml create mode 100644 reference/outcontrol/functions/ob-list-handlers.xml create mode 100644 reference/outcontrol/functions/output-reset-rewrite-vars.xml diff --git a/reference/outcontrol/functions/ob-get-clean.xml b/reference/outcontrol/functions/ob-get-clean.xml new file mode 100644 index 000000000..efd28bcea --- /dev/null +++ b/reference/outcontrol/functions/ob-get-clean.xml @@ -0,0 +1,128 @@ + + + + + + + ob_get_clean + Ruft den Inhalt des aktiven Ausgabepuffers ab und deaktiviert ihn + + + + &reftitle.description; + + stringfalseob_get_clean + + + + Diese Funktion ruft den Ausgabe-Handler auf (mit den Flags + PHP_OUTPUT_HANDLER_CLEAN und + PHP_OUTPUT_HANDLER_FINAL), verwirft dessen + Rückgabewert, gibt den Inhalt des aktiven Ausgabepuffers zurück und schaltet + den aktiven Ausgabepuffer ab. + + + ob_get_clean schlägt fehl, wenn der aktive + Ausgabepuffer ohne das Flag + PHP_OUTPUT_HANDLER_REMOVABLE gestartet wurde. + + + ob_get_clean entfernt den Inhalt des aktiven + Ausgabepuffers auch dann, wenn er ohne das Flag + PHP_OUTPUT_HANDLER_CLEANABLE gestartet wurde. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt bei Erfolg den Inhalt des aktiven Ausgabepuffers zurück oder &false; + bei einem Fehler. + + + + Wenn es keinen aktiven Ausgabepuffer gibt, gibt + ob_get_clean false zurück, erzeugt aber keine Meldung + der Stufe E_NOTICE. + + + + + + &reftitle.errors; + + Wenn die Funktion fehlschlägt, erzeugt sie ein E_NOTICE. + + + + + &reftitle.examples; + + + Ein einfaches <function>ob_get_clean</function>-Beispiel + + +]]> + + &example.outputs; + + + + + + + + + &reftitle.seealso; + + + 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 new file mode 100644 index 000000000..97711060f --- /dev/null +++ b/reference/outcontrol/functions/ob-get-flush.xml @@ -0,0 +1,127 @@ + + + + + + + ob_get_flush + + Leert (sendet) den Rückgabewert des aktiven Ausgabe-Handlers, gibt den + Inhalt des aktiven Ausgabepuffers zurück und deaktiviert ihn + + + + + &reftitle.description; + + stringfalseob_get_flush + + + + Diese Funktion ruft den Ausgabe-Handler auf (mit dem Flag + PHP_OUTPUT_HANDLER_FINAL), leert (sendet) dessen + Rückgabewert, gibt den Inhalt des aktiven Ausgabepuffers zurück und schaltet + den aktiven Ausgabepuffer ab. + + + ob_get_flush schlägt fehl, wenn der aktive + Ausgabepuffer ohne das Flag + PHP_OUTPUT_HANDLER_REMOVABLE gestartet wurde. + + + ob_get_flush leert (sendet) den Rückgabewert des + Ausgabe-Handlers auch dann, wenn er ohne das Flag + PHP_OUTPUT_HANDLER_FLUSHABLE gestartet wurde. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt bei Erfolg den Inhalt des aktiven Ausgabepuffers zurück oder &false; + bei einem Fehler. + + + + + &reftitle.errors; + + Wenn die Funktion fehlschlägt, erzeugt sie eine Meldung der Stufe + E_NOTICE. + + + + + &reftitle.examples; + + + <function>ob_get_flush</function>-Beispiel + + +]]> + + &example.outputs; + + default output handler +) +Array +( +) +]]> + + + + + + + &reftitle.seealso; + + + ob_start + ob_get_contents + ob_flush + ob_end_flush + ob_get_clean + + + + + + diff --git a/reference/outcontrol/functions/ob-get-length.xml b/reference/outcontrol/functions/ob-get-length.xml new file mode 100644 index 000000000..676395924 --- /dev/null +++ b/reference/outcontrol/functions/ob-get-length.xml @@ -0,0 +1,100 @@ + + + + + + + ob_get_length + Liefert die Größe des Ausgabepuffers + + + + &reftitle.description; + + intfalseob_get_length + + + + Diese Funktion gibt die Größe des Inhalts des Ausgabepuffers in Bytes zurück. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Gibt die Größe des Inhalts des Ausgabepuffers in Bytes zurück, oder &false; + wenn die Pufferung nicht aktiv ist. + + + + + &reftitle.examples; + + + Ein einfaches <function>ob_get_length</function>-Beispiel + + +]]> + + &example.outputs; + + + + + + + + + &reftitle.seealso; + + + ob_start + ob_get_contents + + + + + + diff --git a/reference/outcontrol/functions/ob-get-status.xml b/reference/outcontrol/functions/ob-get-status.xml new file mode 100644 index 000000000..e91c598c9 --- /dev/null +++ b/reference/outcontrol/functions/ob-get-status.xml @@ -0,0 +1,222 @@ + + + + + + + ob_get_status + Ermittelt den Status von Ausgabepuffern + + + + &reftitle.description; + + arrayob_get_status + boolfull_status&false; + + + ob_get_status gibt die Statusinformationen über den + Ausgabepuffer der obersten Ebene zurück oder, wenn + full_status auf &true; gesetzt ist, über die aktiven + Ausgabepuffer aller Ebenen. + + + + + &reftitle.parameters; + + + + full_status + + + &true;, damit der Status der aktiven Ausgabepuffer aller Ebenen + zurückgegeben werden. Wenn &false; oder nicht gesetzt, wird nur der + Status des Ausgabepuffers der oberste Ebene zurückgegeben. + + + + + + + + + &reftitle.returnvalues; + + Wenn full_status weggelassen wird oder &false; ist, + wird ein einfaches Array mit Statusinformationen über die aktive + Ausgabeebene zurückgegeben. + + + Wenn full_status &true; ist, wird ein Array mit + jeweils einem Element für jede aktive Ausgabepuffer-Ebene zurückgegeben. + Die Ausgabeebene wird als Schlüssel des Arrays der obersten Ebene verwendet + und jedes Array-Element selbst ist ein weiteres Array, das + Statusinformationen über eine aktive Ausgabeebene enthält. + + + Wenn die Ausgabepufferung nicht aktiviert ist, wird ein leeres Array + zurückgegeben. + + + + Die Elemente des von <function>ob_get_status</function> zurückgegebenen Arrays + SchlüsselWert + + name + + Der Name des aktiven Ausgabe-Handlers (siehe die Rückgabewerte von + ob_list_handlers für Details) + + + + type + + 0 (interner Handler) oder + 1 (benutzerdefinierter Handler) + + + + flags + + Die Bitmaske der von ob_start gesetzten Flags, des + Typs des Ausgabe-Handlers (siehe oben) und des Status des + Pufferungsprozesses + (PHP_OUTPUT_HANDLER_*-Konstanten). + Wenn der Handler den Puffer erfolgreich verarbeitet und nicht &false; + zurückgegeben hat, werden die Konstanten + PHP_OUTPUT_HANDLER_STARTED und + PHP_OUTPUT_HANDLER_PROCESSED gesetzt. + Wenn der Handler den Puffer nicht verarbeiten konnte oder &false; + zurückgegeben hat, werden die Konstanten + PHP_OUTPUT_HANDLER_STARTED und + PHP_OUTPUT_HANDLER_DISABLED gesetzt. + + + + level + + Die Verschachtelungsebene der Ausgabe (beginnend bei Null). Es ist zu + beachten, dass der Wert, der von ob_get_level für + dieselbe Ebene zurückgegeben wird, um eins abweicht. + Für ob_get_status ist die erste Ebene + 0 und für ob_get_level + 1. + + + + chunk_size + + Die Größe eines Blocks in Bytes. Wird gesetzt durch + ob_start oder + output_buffering, wenn diese + Option aktiviert ist und ihr Wert auf eine positive Ganzzahl gesetzt ist + + + + buffer_size + + Die Größe des Ausgabepuffers in Bytes + + + + buffer_used + + Die Größe der Daten im Ausgabepuffer in Bytes (entspricht dem + Integer-Rückgabewert von ob_get_length) + + + + + + + + &reftitle.examples; + + + Das Array, das zurückgegeben wird, wenn <parameter>full_status</parameter> &false; ist + + URL-Rewriter + [type] => 0 + [flags] => 112 + [level] => 2 + [chunk_size] => 0 + [buffer_size] => 16384 + [buffer_used] => 1024 +) +]]> + + + + + + Das Array, das zurückgegeben wird, wenn <parameter>full_status</parameter> &true; ist + + Array + ( + [name] => default output handler + [type] => 0 + [flags] => 112 + [level] => 1 + [chunk_size] => 0 + [buffer_size] => 16384 + [buffer_used] => 2048 + ) + + [1] => Array + ( + [name] => URL-Rewriter + [type] => 0 + [flags] => 112 + [level] => 2 + [chunk_size] => 0 + [buffer_size] => 16384 + [buffer_used] => 1024 + ) + +) +]]> + + + + + + + &reftitle.seealso; + + + ob_get_level + ob_list_handlers + ob_get_length + ob_start + + + + + + diff --git a/reference/outcontrol/functions/ob-list-handlers.xml b/reference/outcontrol/functions/ob-list-handlers.xml new file mode 100644 index 000000000..25f88a64c --- /dev/null +++ b/reference/outcontrol/functions/ob-list-handlers.xml @@ -0,0 +1,219 @@ + + + + + + + ob_list_handlers + Listet alle verwendeten Ausgabe-Handler auf + + + + &reftitle.description; + + arrayob_list_handlers + + + + Listet alle verwendeten Ausgabe-Handler auf. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Diese Funktion gibt ein Array mit den verwendeten Ausgabe-Handlern zurück + (falls vorhanden). + + + Wenn output_buffering aktiviert + ist und output_handler nicht + gesetzt ist oder kein Callback oder &null; an ob_start + übergeben wurde, wird "default output handler" + zurückgegeben. Das Aktivieren von + output_buffering und das Setzen + von output_handler entspricht der + Übergabe einer + internen (eingebauten) Funktion an + ob_start. + + + Wenn ein Callable an ob_start übergeben + wurde, wird der + vollständig qualifizierte Name + des Callables zurückgegeben. Wenn das Callable ein + Objekt ist, das __invoke() + implementiert, wird der + vollständig qualifizierte Name + der __invoke()-Methode des + Objekts zurückgegeben. Handelt es sich bei der Callable um eine + Closure, wird "Closure::__invoke" + zurückgegeben. + + + + + &reftitle.examples; + + + <function>ob_list_handlers</function>-Beispiel + + $string); +var_dump(ob_list_handlers()); +ob_end_flush(); + +// Callback-Funktion als Objekt erster Klasse +$firstClassCallable = userDefinedFunction(...); + +ob_start([$firstClassCallable, '__invoke']); +var_dump(ob_list_handlers()); +ob_end_flush(); + +// Interne (eingebaute) Funktion +ob_start('print_r'); +var_dump(ob_list_handlers()); +ob_end_flush(); + +// Benutzerdefinierte Funktion +function userDefinedFunction($string, $flags) { return $string; }; + +ob_start('userDefinedFunction'); +var_dump(ob_list_handlers()); +ob_end_flush(); + +class MyClass { + public static function staticHandle($string) { + return $string; + } + + public static function handle($string) { + return $string; + } + + public function __invoke($string) { + return $string; + } +} + +// Klasse und statische Methode +ob_start(['MyClass','staticHandle']); +var_dump(ob_list_handlers()); +ob_end_flush(); + +// Objekt und nicht-statische Methode +ob_start([new MyClass,'handle']); +var_dump(ob_list_handlers()); +ob_end_flush(); + +// Aufrufbares Objekt +ob_start(new MyClass); +var_dump(ob_list_handlers()); +ob_end_flush(); +?> +]]> + + &example.outputs; + + + string(22) "default output handler" +} +array(1) { + [0]=> + string(22) "default output handler" +} +array(1) { + [0]=> + string(7) "print_r" +} +array(1) { + [0]=> + string(19) "userDefinedFunction" +} +array(1) { + [0]=> + string(17) "Closure::__invoke" +} +array(1) { + [0]=> + string(17) "Closure::__invoke" +} +array(1) { + [0]=> + string(17) "Closure::__invoke" +} +array(1) { + [0]=> + string(21) "MyClass::staticHandle" +} +array(1) { + [0]=> + string(15) "MyClass::handle" +} +array(1) { + [0]=> + string(17) "MyClass::__invoke" +} +]]> + + + + + + + &reftitle.seealso; + + + ob_end_clean + ob_end_flush + ob_get_flush + ob_start + + + + + + + diff --git a/reference/outcontrol/functions/output-reset-rewrite-vars.xml b/reference/outcontrol/functions/output-reset-rewrite-vars.xml new file mode 100644 index 000000000..4529c7932 --- /dev/null +++ b/reference/outcontrol/functions/output-reset-rewrite-vars.xml @@ -0,0 +1,132 @@ + + + + + + + output_reset_rewrite_vars + Setzt die Werte des URL-Rewriters zurück + + + + &reftitle.description; + + booloutput_reset_rewrite_vars + + + + Diese Funktion entfernt alle Rewrite-Variablen, die zuvor mit der Funktion + output_add_rewrite_var gesetzt wurden. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 7.1.0 + + Vor PHP 7.1.0 verwendeten die mittels + output_add_rewrite_var definierten + Rewrite-Variablen denselben trans-sid-Ausgabepuffer wie das + Session-Modul. Seit PHP 7.1.0 wird ein eigener Ausgabepuffer verwendet + und output_reset_rewrite_vars entfernt nur die + mittels output_add_rewrite_var definierten + Rewrite-Variablen. + + + + + + + + + + &reftitle.examples; + + + <function>output_reset_rewrite_vars</function>-Beispiel + +link'; +ob_flush(); + +output_reset_rewrite_vars(); +echo 'link'; +?> +]]> + + &example.outputs; + +link +link +]]> + + + + + + + &reftitle.seealso; + + + output_add_rewrite_var + ob_flush + ob_list_handlers + url_rewriter.tags + url_rewriter.hosts + session.trans_sid_tags + session.trans_sid_hosts + + + + + + +