svn: /phpdoc/de/trunk/reference/funchand/functions/ register-shutdown-function.xml

nikic Wed, 16 Nov 2011 19:05:03 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=319360 Log: Sync DE register_shutdown_function docs with EN (refs Doc Bug #55732) Bug: https://bugs.php.net/55732 (Closed) [DE] returnvalue register_shutdown_function Changed paths: U phpdoc/de/trunk/reference/funchand/functions/register-shutdown-function.xml Modified: phpdoc/de/trunk/reference/funchand/functions/register-shutdown-function.xml =================================================================== --- phpdoc/de/trunk/reference/funchand/functions/register-shutdown-function.xml 2011-11-16 19:00:07 UTC (rev 319359) +++ phpdoc/de/trunk/reference/funchand/functions/register-shutdown-function.xml 2011-11-16 19:05:03 UTC (rev 319360) @@ -1,36 +1,165 @@ <?xml version="1.0" encoding="UTF-8"?> <!-- $Revision$ --> -<!-- EN-Revision: n/a Maintainer: nobody Status: ready --> - <refentry xml:id="function.register-shutdown-function" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>register_shutdown_function</refname> - <refpurpose> - Registriert eine Funktion zur Ausführung beim Skript-Abschluss - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>void</type><methodname>register_shutdown_function</methodname> - <methodparam><type>callback</type><parameter>function</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <simpara> - Das Callback <parameter>func</parameter> mit gegebenen Parametern wird im - Skript zwecks Ausführung an dessen Ende eingetragen. - </simpara> - <para> - Bekannte Problemfälle: - </para> - <simpara> - Da innerhalb dieser Funktion keinerlei Ausgabe im Browser erzeugt - werden, können sie die registrierte Funktion nicht mit print oder - echo usw. debuggen. - </simpara> - </refsect1> - </refentry> +<!-- EN-Revision: 319357 Maintainer: nikic Status: ready --> +<refentry xml:id="function.register-shutdown-function" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>register_shutdown_function</refname> + <refpurpose> + Registriert eine Funktion zur Ausführung beim Skript-Abschluss + </refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>register_shutdown_function</methodname> + <methodparam><type>callback</type><parameter>callback</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + Registriert ein <parameter>callback</parameter>, welches ausgeführt werden soll, sobald + die Ausführung des Scripts beendet ist oder <function>exit</function> aufgerufen wurde. + </para> + <para> + <function>register_shutdown_function</function> kann mehrmals hintereinander aufgerufen + werden, in welchem Fall die Callbacks später in der selben Reihenfolge aufgerufen werden, + wie sie registriert wurden. Wenn <function>exit</function> innerhalb eines Shutdown + Callbacks aufgerufen wird, bricht die Ausführung vollständig ab und keine weiteren + Callbacks werden ausgeführt. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>callback</parameter></term> + <listitem> + <para> + Das Shutdown Callback, welches registriert werden soll. + </para> + <para> + Die Callbacks werden als Teil der Anfrage ausgeführt, d.h. + es ist möglich Ausgaben zu machen und auf Output Buffer + zuzugreifen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>parameter</parameter></term> + <listitem> + <para> + Alle weiteren Argumente, die dieser Funktion übergeben werden, werden + auch den Callbacks beim Aufruf übergeben. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="errors"> + &reftitle.errors; + <para> + Wenn das übergebene Callback nicht aufrufbar ist, wird ein + <constant>E_WARNING</constant> geworfen. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.1.0</entry> + <entry> + Die Shutdown Callbacks werden nun als Teil der Anfrage ausgeführt. + In früheren Versionen wurden sie aufgerufen nachdem die Anfrage + abgeschlossen wurde, weshalb es nicht möglich war mit + <function>echo</function> oder <function>print</function> Ausgaben + zu machen oder Output Buffer mit <function>ob_get_contents</function> + abzurufen. Auch Header wurden bereits vorher gesendet. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>register_shutdown_function</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +function shutdown() +{ + // Das ist unsere Shutdown Funktion, in welcher + // wir noch letzte Anweisungen ausführen können + // bevor die Ausführung beendet wird. + + echo 'Script executed with success', PHP_EOL; +} + +register_shutdown_function('shutdown'); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Das Arbeitsverzeichnis des Scripts kann sich bei manchen + Webservern wie Apache innerhalb des Shutdown Callbacks ändern. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><link linkend="ini.auto-append-file">auto_append_file</link></member> + <member><function>exit</function></member> + <member>Die Sektion über <link + linkend="features.connection-handling">Verbindungssteuerung</link></member> + </simplelist> + </para> + </refsect1> + +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml