cvs: phpdoc-de /reference/errorfunc/functions restore-error-handler.xml set-error-handler.xml trigger-error.xml user-error.xml
| From: | Cornelia Boenigk | Date: | Tue, 27 Jan 2004 01:13:59 +0000 |
| Subject: | cvs: phpdoc-de /reference/errorfunc/functions restore-error-handler.xml set-error-handler.xml trigger-error.xml user-error.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-1082@lists.php.net to get a copy of this message | ||
conni Mon Jan 26 20:13:59 2004 EDT
Modified files:
/phpdoc-de/reference/errorfunc/functions restore-error-handler.xml
set-error-handler.xml
trigger-error.xml
user-error.xml
Log:
erste Uebersetzung
http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.restore-error-handler"> + <refnamediv> + <refname>restore_error_handler</refname> + <refpurpose> + Rekonstruiert die zuvor benutzte Fehlerbehandlungsfunktion + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>restore_error_handler</methodname> + <void/> + </methodsynopsis> + <para> + Diese Funktion wird benutzt, um eine mit <function>set_error_handler</function> + gesetzte Fehlerbehandlungsfunktion wieder zurückzusetzen und zur zuvor + benutzten Fehlerbehandlung zurückzukehren. (Dies kann entweder eine + eingebaute oder eine benutzerdefinierte Funktion sein.) + </para> + <para> + Siehe auch <function>error_reporting</function>, + <function>set_error_handler</function> und + <function>trigger_error</function>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/set-error-handler.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/set-error-handler.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/set-error-handler.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/set-error-handler.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,241 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.set-error-handler"> + <refnamediv> + <refname>set_error_handler</refname> + <refpurpose> + Bestimmt eine benutzerdefinierte Funktion zur Fehlerbehandlung. + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>string</type><methodname>set_error_handler</methodname> + <methodparam><type>callback</type><parameter>error_handler</parameter></methodparam> + </methodsynopsis> + <para> + Setzt eine benutzerdefinierte Funktion (<parameter>error_handler</parameter>) + um Fehler in einem Skript zu bearbeiten. Die Funktion gibt die + zuvor benutzte Fehlerbehandlungsroutine (falls eine definiert + wurde) zurück oder &false;, falls ein Fehler auftrat. Mit dieser + Funktion können Sie Ihre eigene Behandlung von Laufzeitfehlern + definieren, beispielsweise in Anwendungen, die bei einem + kritischen Fehler die Löschung von Daten bzw. Dateien erfordert + oder wenn es nötig ist, unter bestimmten Bedingungen (mit + der Funktion <function>trigger_error</function>) eine + Fehlermeldung zu generieren. + </para> + <para> + Die benutzerdefinierte Funktion erwartet notwendig zwei Parameter: + den Fehlercode und eine Beschreibung des Fehlers als String. Ab PHP + 4.0.2 sind zudem drei optionale Parameter verfügbar: der Name der + Datei, in der der Fehler auftrat, die Nummer der Zeile, in der der + Fehler auftrat und der Kontext, in welchem der Fehler auftrat (ein + Array, das auf den Punkt in der aktiven Symboltabelle verweist, wo + der Fehler auftrat). + </para> + <note> + <simpara> + Anstelle eines Funktionsnamens kann auch ein Array, das eine + Referenz auf ein Objekt und einen Methodennamen enthält, übergeben + werden. (Seit PHP 4.3.0) + </simpara> + </note> + <note> + <para> + Die folgenden Fehlertypen können nicht von einer + benutzerdefinierten Funktion behandelt werden: + <constant>E_ERROR</constant>, <constant>E_PARSE</constant>, + <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>, + <constant>E_COMPILE_ERROR</constant> und <constant>E_COMPILE_WARNING</constant>. + </para> + </note> + <para> + Das untenstehende Beispiel zeigt die Behandlung von internen + Ausnahmen, indem eine Fehlermeldung und die Behandlung des Fehlers + durch eine benutzerdefinierte Funktion ausgelöst wird: + <example> + <title> + Fehlerbehandlung mit <function>set_error_handler</function> und + <function>trigger_error</function> + </title> + <programlisting role="php"> +<![CDATA[ +<?php + +// umdefinieren der Konstanten - nur in PHP 4 +define("FATAL", E_USER_ERROR); +define("ERROR", E_USER_WARNING); +define("WARNING", E_USER_NOTICE); + +// die Stufe für dieses Skript einstellen +error_reporting(FATAL | ERROR | WARNING); + +// Fehlerbehandlungsfunktion +function myErrorHandler($errno, $errstr, $errfile, $errline) +{ + switch ($errno) { + case FATAL: + echo "<b>FATAL</b> [$errno] $errstr<br />\n"; + echo " Fatal error in line $errline of file $errfile"; + echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n"; + echo "Aborting...<br />\n"; + exit(1); + break; + case ERROR: + echo "<b>ERROR</b> [$errno] $errstr<br />\n"; + break; + case WARNING: + echo "<b>WARNING</b> [$errno] $errstr<br />\n"; + break; + default: + echo "Unkown error type: [$errno] $errstr<br />\n"; + break; + } +} + +// Funktion zum Test der Fehlerbehandlung +function scale_by_log($vect, $scale) +{ + if (!is_numeric($scale) || $scale <= 0) { + trigger_error("log(x) for x <= 0 is undefined, you used: scale = $scale", + FATAL); + } + + if (!is_array($vect)) { + trigger_error("Incorrect input vector, array of values expected", ERROR); + return null; + } + + for ($i=0; $i<count($vect); $i++) { + if (!is_numeric($vect[$i])) + trigger_error("Value at position $i is not a number, using 0 (zero)", + WARNING); + $temp[$i] = log($scale) * $vect[$i]; + } + return $temp; +} + +// auf die benutzerdefinierte Fehlerbehandlung umstellen +$old_error_handler = set_error_handler("myErrorHandler"); + +// einige Fehler auslösen, zuerst wird ein gemischtes Array +// definiert mit einem nichtnummerischen Eintrag +echo "vector a\n"; +$a = array(2, 3, "foo", 5.5, 43.3, 21.11); +print_r($a); + +// ein zweites Array erzeugen, das Warnungen generiert +echo "----\nvector b - a warning (b = log(PI) * a)\n"; +$b = scale_by_log($a, M_PI); +print_r($b); + +// hier ist der Grund für das Problem: anstatt einem Array +// wird ein String übergeben +echo "----\nvector c - an error\n"; +$c = scale_by_log("not array", 2.3); +var_dump($c); + +// dies ist ein kritischer Fehler, der log() ist für null +// oder negative Werte nicht definiert +echo "----\nvector d - fatal error\n"; +$d = scale_by_log($a, -2.5); + +?> +]]> + </programlisting> + <para> + Wenn Sie dieses Skript ausführen, erhalten Sie die folgende Ausgabe: + </para> + <screen> +<![CDATA[ +vector a +Array +( + [0] => 2 + [1] => 3 + [2] => foo + [3] => 5.5 + [4] => 43.3 + [5] => 21.11 +) +---- +vector b - a warning (b = log(PI) * a) +<b>WARNING</b> [1024] Value at position 2 is not a number, using 0 (zero)<br /> +Array +( + [0] => 2.2894597716988 + [1] => 3.4341896575482 + [2] => 0 + [3] => 6.2960143721717 + [4] => 49.566804057279 + [5] => 24.165247890281 +) +---- +vector c - an error +<b>ERROR</b> [512] Incorrect input vector, array of values expected<br /> +NULL +---- +vector d - fatal error +<b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br /> + Fatal error in line 36 of file trigger_error.php, PHP 4.0.2 (Linux)<br /> +Aborting...<br /> +]]> + </screen> + </example> + </para> + <para> + Es ist wichtig und darf nicht vergessen werden, dass die + standardmässige PHP Fehlerbehandlung vollkommen umgangen wurde. Die + Einstellungen der Funktion <function>error_reporting</function> + haben keine Auswirkung und Ihre eigene Fehlerbehandlungsroutine + wird ohne Rücksicht darauf aufgerufen. Sie können jedoch immer noch + den aktuellen Wert von <link linkend="ini.error-reporting">error_reporting</link> + lesen und entsprechend handeln. Von besonderer Bedeutung ist, dass + dieser Wert 0 sein wird, falls der Befehl, der den Fehler verurscht + hat, mit dem + <link linkend="language.operators.errorcontrol">@ error-control operator</link> versehen ist. + </para> + <para> + Beachten Sie auch, dass Sie <function>die</function> aufrufen + können, wenn es notwendig ist. Wenn die Fehlerbehandlungsfunktion + zurückkehrt, wird die Ausführung des Skripts beim nächsten Befehl + nach dem fehlerverursachenden Befehl fortgesetzt. + </para> + <note> + <para> + Falls Fehler auftreten, bevor das Skript ausgeführt wird (z. B. + bei Dateiuploads), kann eine benutzerdefinierte Fehlerbehandlung + nicht aufgerufen werden, weil sie zu diesem Zeitpunkt noch nicht + registriert ist. + </para> + </note> + <para> + Siehe auch <function>error_reporting</function>, + <function>restore_error_handler</function>, + <function>trigger_error</function>, und + <link linkend="errorfunc.constants">error level constants</link>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/trigger-error.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/trigger-error.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/trigger-error.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/trigger-error.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.trigger-error"> + <refnamediv> + <refname>trigger_error</refname> + <refpurpose> + Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>trigger_error</methodname> + <methodparam><type>string</type><parameter>error_msg</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam> + </methodsynopsis> + <para> + Mit dieser Funktion kann der Benutzer Bedingungen festlegen, die + Fehler auslösen, entweder in Verbindung mit der standardmässigen + Fehlerbehandlung oder einer benutzerdefinierten Routine, die als + neue Fehlerbehandlungsfunktion gesetzt wurde (<function>set_error_handler</function>). + Die Funktion kann nur mit den E_USER-Konstanten umgehen und benutzt + standardmässig die Konstante <constant>E_USER_NOTICE</constant>. + </para> + <para> + Diese Funktion ist nützlich, wenn Sie zur Laufzeit eine bestimmte + Rückmeldung bei einer Ausnahme brauchen. + Zum Beispiel: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +if (assert($divisor == 0)) { + trigger_error("Cannot divide by zero", E_USER_ERROR); +} +?> +]]> + </programlisting> + </informalexample> + <note> + <para> + Siehe <function>set_error_handler</function> für ein ausführlicheres Beispiel. + </para> + </note> + <note> + <para> + Die Länge von <parameter>error_msg</parameter> ist auf 1024 + Zeichen beschränkt. Alle weiteren Zeichen über 1024 werden + abgeschnitten. + </para> + </note> + </para> + <para> + Siehe auch <function>error_reporting</function>, + <function>set_error_handler</function>, + <function>restore_error_handler</function> und + <link linkend="errorfunc.constants">error level constants</link>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/user-error.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/user-error.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/user-error.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/user-error.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,35 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.user-error"> + <refnamediv> + <refname>user_error</refname> + <refpurpose>Alias von <function>trigger_error</function></refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <para> + Diese Funktion ist ein Alias von <function>trigger_error</function>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->
http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/restore-error-handler.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.restore-error-handler"> + <refnamediv> + <refname>restore_error_handler</refname> + <refpurpose> + Rekonstruiert die zuvor benutzte Fehlerbehandlungsfunktion + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>restore_error_handler</methodname> + <void/> + </methodsynopsis> + <para> + Diese Funktion wird benutzt, um eine mit <function>set_error_handler</function> + gesetzte Fehlerbehandlungsfunktion wieder zurückzusetzen und zur zuvor + benutzten Fehlerbehandlung zurückzukehren. (Dies kann entweder eine + eingebaute oder eine benutzerdefinierte Funktion sein.) + </para> + <para> + Siehe auch <function>error_reporting</function>, + <function>set_error_handler</function> und + <function>trigger_error</function>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/set-error-handler.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/set-error-handler.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/set-error-handler.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/set-error-handler.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,241 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.set-error-handler"> + <refnamediv> + <refname>set_error_handler</refname> + <refpurpose> + Bestimmt eine benutzerdefinierte Funktion zur Fehlerbehandlung. + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>string</type><methodname>set_error_handler</methodname> + <methodparam><type>callback</type><parameter>error_handler</parameter></methodparam> + </methodsynopsis> + <para> + Setzt eine benutzerdefinierte Funktion (<parameter>error_handler</parameter>) + um Fehler in einem Skript zu bearbeiten. Die Funktion gibt die + zuvor benutzte Fehlerbehandlungsroutine (falls eine definiert + wurde) zurück oder &false;, falls ein Fehler auftrat. Mit dieser + Funktion können Sie Ihre eigene Behandlung von Laufzeitfehlern + definieren, beispielsweise in Anwendungen, die bei einem + kritischen Fehler die Löschung von Daten bzw. Dateien erfordert + oder wenn es nötig ist, unter bestimmten Bedingungen (mit + der Funktion <function>trigger_error</function>) eine + Fehlermeldung zu generieren. + </para> + <para> + Die benutzerdefinierte Funktion erwartet notwendig zwei Parameter: + den Fehlercode und eine Beschreibung des Fehlers als String. Ab PHP + 4.0.2 sind zudem drei optionale Parameter verfügbar: der Name der + Datei, in der der Fehler auftrat, die Nummer der Zeile, in der der + Fehler auftrat und der Kontext, in welchem der Fehler auftrat (ein + Array, das auf den Punkt in der aktiven Symboltabelle verweist, wo + der Fehler auftrat). + </para> + <note> + <simpara> + Anstelle eines Funktionsnamens kann auch ein Array, das eine + Referenz auf ein Objekt und einen Methodennamen enthält, übergeben + werden. (Seit PHP 4.3.0) + </simpara> + </note> + <note> + <para> + Die folgenden Fehlertypen können nicht von einer + benutzerdefinierten Funktion behandelt werden: + <constant>E_ERROR</constant>, <constant>E_PARSE</constant>, + <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>, + <constant>E_COMPILE_ERROR</constant> und <constant>E_COMPILE_WARNING</constant>. + </para> + </note> + <para> + Das untenstehende Beispiel zeigt die Behandlung von internen + Ausnahmen, indem eine Fehlermeldung und die Behandlung des Fehlers + durch eine benutzerdefinierte Funktion ausgelöst wird: + <example> + <title> + Fehlerbehandlung mit <function>set_error_handler</function> und + <function>trigger_error</function> + </title> + <programlisting role="php"> +<![CDATA[ +<?php + +// umdefinieren der Konstanten - nur in PHP 4 +define("FATAL", E_USER_ERROR); +define("ERROR", E_USER_WARNING); +define("WARNING", E_USER_NOTICE); + +// die Stufe für dieses Skript einstellen +error_reporting(FATAL | ERROR | WARNING); + +// Fehlerbehandlungsfunktion +function myErrorHandler($errno, $errstr, $errfile, $errline) +{ + switch ($errno) { + case FATAL: + echo "<b>FATAL</b> [$errno] $errstr<br />\n"; + echo " Fatal error in line $errline of file $errfile"; + echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n"; + echo "Aborting...<br />\n"; + exit(1); + break; + case ERROR: + echo "<b>ERROR</b> [$errno] $errstr<br />\n"; + break; + case WARNING: + echo "<b>WARNING</b> [$errno] $errstr<br />\n"; + break; + default: + echo "Unkown error type: [$errno] $errstr<br />\n"; + break; + } +} + +// Funktion zum Test der Fehlerbehandlung +function scale_by_log($vect, $scale) +{ + if (!is_numeric($scale) || $scale <= 0) { + trigger_error("log(x) for x <= 0 is undefined, you used: scale = $scale", + FATAL); + } + + if (!is_array($vect)) { + trigger_error("Incorrect input vector, array of values expected", ERROR); + return null; + } + + for ($i=0; $i<count($vect); $i++) { + if (!is_numeric($vect[$i])) + trigger_error("Value at position $i is not a number, using 0 (zero)", + WARNING); + $temp[$i] = log($scale) * $vect[$i]; + } + return $temp; +} + +// auf die benutzerdefinierte Fehlerbehandlung umstellen +$old_error_handler = set_error_handler("myErrorHandler"); + +// einige Fehler auslösen, zuerst wird ein gemischtes Array +// definiert mit einem nichtnummerischen Eintrag +echo "vector a\n"; +$a = array(2, 3, "foo", 5.5, 43.3, 21.11); +print_r($a); + +// ein zweites Array erzeugen, das Warnungen generiert +echo "----\nvector b - a warning (b = log(PI) * a)\n"; +$b = scale_by_log($a, M_PI); +print_r($b); + +// hier ist der Grund für das Problem: anstatt einem Array +// wird ein String übergeben +echo "----\nvector c - an error\n"; +$c = scale_by_log("not array", 2.3); +var_dump($c); + +// dies ist ein kritischer Fehler, der log() ist für null +// oder negative Werte nicht definiert +echo "----\nvector d - fatal error\n"; +$d = scale_by_log($a, -2.5); + +?> +]]> + </programlisting> + <para> + Wenn Sie dieses Skript ausführen, erhalten Sie die folgende Ausgabe: + </para> + <screen> +<![CDATA[ +vector a +Array +( + [0] => 2 + [1] => 3 + [2] => foo + [3] => 5.5 + [4] => 43.3 + [5] => 21.11 +) +---- +vector b - a warning (b = log(PI) * a) +<b>WARNING</b> [1024] Value at position 2 is not a number, using 0 (zero)<br /> +Array +( + [0] => 2.2894597716988 + [1] => 3.4341896575482 + [2] => 0 + [3] => 6.2960143721717 + [4] => 49.566804057279 + [5] => 24.165247890281 +) +---- +vector c - an error +<b>ERROR</b> [512] Incorrect input vector, array of values expected<br /> +NULL +---- +vector d - fatal error +<b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br /> + Fatal error in line 36 of file trigger_error.php, PHP 4.0.2 (Linux)<br /> +Aborting...<br /> +]]> + </screen> + </example> + </para> + <para> + Es ist wichtig und darf nicht vergessen werden, dass die + standardmässige PHP Fehlerbehandlung vollkommen umgangen wurde. Die + Einstellungen der Funktion <function>error_reporting</function> + haben keine Auswirkung und Ihre eigene Fehlerbehandlungsroutine + wird ohne Rücksicht darauf aufgerufen. Sie können jedoch immer noch + den aktuellen Wert von <link linkend="ini.error-reporting">error_reporting</link> + lesen und entsprechend handeln. Von besonderer Bedeutung ist, dass + dieser Wert 0 sein wird, falls der Befehl, der den Fehler verurscht + hat, mit dem + <link linkend="language.operators.errorcontrol">@ error-control operator</link> versehen ist. + </para> + <para> + Beachten Sie auch, dass Sie <function>die</function> aufrufen + können, wenn es notwendig ist. Wenn die Fehlerbehandlungsfunktion + zurückkehrt, wird die Ausführung des Skripts beim nächsten Befehl + nach dem fehlerverursachenden Befehl fortgesetzt. + </para> + <note> + <para> + Falls Fehler auftreten, bevor das Skript ausgeführt wird (z. B. + bei Dateiuploads), kann eine benutzerdefinierte Fehlerbehandlung + nicht aufgerufen werden, weil sie zu diesem Zeitpunkt noch nicht + registriert ist. + </para> + </note> + <para> + Siehe auch <function>error_reporting</function>, + <function>restore_error_handler</function>, + <function>trigger_error</function>, und + <link linkend="errorfunc.constants">error level constants</link>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/trigger-error.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/trigger-error.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/trigger-error.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/trigger-error.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.trigger-error"> + <refnamediv> + <refname>trigger_error</refname> + <refpurpose> + Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung + </refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <methodsynopsis> + <type>void</type><methodname>trigger_error</methodname> + <methodparam><type>string</type><parameter>error_msg</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam> + </methodsynopsis> + <para> + Mit dieser Funktion kann der Benutzer Bedingungen festlegen, die + Fehler auslösen, entweder in Verbindung mit der standardmässigen + Fehlerbehandlung oder einer benutzerdefinierten Routine, die als + neue Fehlerbehandlungsfunktion gesetzt wurde (<function>set_error_handler</function>). + Die Funktion kann nur mit den E_USER-Konstanten umgehen und benutzt + standardmässig die Konstante <constant>E_USER_NOTICE</constant>. + </para> + <para> + Diese Funktion ist nützlich, wenn Sie zur Laufzeit eine bestimmte + Rückmeldung bei einer Ausnahme brauchen. + Zum Beispiel: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +if (assert($divisor == 0)) { + trigger_error("Cannot divide by zero", E_USER_ERROR); +} +?> +]]> + </programlisting> + </informalexample> + <note> + <para> + Siehe <function>set_error_handler</function> für ein ausführlicheres Beispiel. + </para> + </note> + <note> + <para> + Die Länge von <parameter>error_msg</parameter> ist auf 1024 + Zeichen beschränkt. Alle weiteren Zeichen über 1024 werden + abgeschnitten. + </para> + </note> + </para> + <para> + Siehe auch <function>error_reporting</function>, + <function>set_error_handler</function>, + <function>restore_error_handler</function> und + <link linkend="errorfunc.constants">error level constants</link>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> http://cvs.php.net/diff.php/phpdoc-de/reference/errorfunc/functions/user-error.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-de/reference/errorfunc/functions/user-error.xml diff -u /dev/null phpdoc-de/reference/errorfunc/functions/user-error.xml:1.4 --- /dev/null Mon Jan 26 20:13:59 2004 +++ phpdoc-de/reference/errorfunc/functions/user-error.xml Mon Jan 26 20:13:59 2004 @@ -0,0 +1,35 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> + <refentry id="function.user-error"> + <refnamediv> + <refname>user_error</refname> + <refpurpose>Alias von <function>trigger_error</function></refpurpose> + </refnamediv> + <refsect1> + <title>Beschreibung</title> + <para> + Diese Funktion ist ein Alias von <function>trigger_error</function>. + </para> + </refsect1> + </refentry> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +-->