cvs: phpdoc-de /reference/errorfunc/functions error-log.xml set-error-handler.xml

From: Date: Thu, 22 May 2008 12:54:23 +0000
Subject: cvs: phpdoc-de /reference/errorfunc/functions error-log.xml set-error-handler.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2643@lists.php.net to get a copy of this message
samesch Thu May 22 12:54:23 2008 UTC Modified files: /phpdoc-de/reference/errorfunc/functions error-log.xml set-error-handler.xml Log: syncing with EN; leaving 'nobody' as maintainer

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/errorfunc/functions/error-log.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/errorfunc/functions/error-log.xml diff -u phpdoc-de/reference/errorfunc/functions/error-log.xml:1.8 phpdoc-de/reference/errorfunc/functions/error-log.xml:1.9 --- phpdoc-de/reference/errorfunc/functions/error-log.xml:1.8 Sat Jun 23 13:21:33 2007 +++ phpdoc-de/reference/errorfunc/functions/error-log.xml Thu May 22 12:54:23 2008 @@ -1,105 +1,154 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> -<!-- splitted from ./de/functions/errorfunc.xml, last change in rev 1.5 --> -<!-- last change to 'error-log' in en/ tree in rev 1.1 --> - <refentry xml:id="function.error-log" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>error_log</refname> - <refpurpose>Sendet eine Fehlermeldung</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung</title> - <methodsynopsis> - <type>int</type><methodname>error_log</methodname> - <methodparam><type>string</type><parameter>message</parameter></methodparam> - <methodparam><type>int</type><parameter>message_type</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam> - </methodsynopsis> - <para> - Sendet eine Fehlermeldung an das Log-File des Webservers, einen - <acronym>TCP</acronym> Port oder eine Datei. Der erste Parameter, - <parameter>message</parameter>, ist die Fehlermeldung, die - mitgeschrieben werden soll. Der zweite Parameter, - <parameter>message_type</parameter> gibt an, wo die Meldung - abgelegt werden soll: - <table> - <title><function>error_log</function> Typen</title> - <tgroup cols="2"> - <tbody> - <row> - <entry>0</entry> - <entry> - <parameter>Message</parameter> wird mit Hilfe des internen - Log-Systems des Betriebssystemes oder einer Datei - geschrieben, je nachdem, wie <link - linkend="ini.error-log">error_log</link> eingestellt ist. - </entry> - </row> - <row> - <entry>1</entry> - <entry> - <parameter>Message</parameter> wird via Email an die Adresse - gesendet, die mit <parameter>destination</parameter> - angegeben wurde. Dies ist der einzige Typ, bei dem der - vierte Parameter <parameter>extra_headers</parameter> - verwendet wird. Die Nachricht verwendet dieselbe interne - Funktion wie <function>mail</function>. - </entry> - </row> - <row> - <entry>2</entry> - <entry> - <parameter>Message</parameter> wird über den PHP-Debugger - gesendet. Diese Option ist nur verfügbar, wenn <link - linkend="install.configure.enable-debugger">der Debugger gestartet - wurde</link>. Ist das der Fall, so wird mit dem - <parameter>destination</parameter> Parameter der Hostname - oder die IP-Adresse gesetzt. Optional auch der Port, unter - dem der Debugger läuft. - </entry> - </row> - <row> - <entry>3</entry> - <entry> - <parameter>Message</parameter> wird an die Datei angefügt, - die mit <parameter>destination</parameter> angegeben wurde. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <example> - <title><function>error_log</function> Beispiele</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.18 Maintainer: nobody Status: ready --> +<refentry xml:id="function.error-log" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>error_log</refname> + <refpurpose>Sendet eine Fehlermeldung</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>error_log</methodname> + <methodparam><type>string</type><parameter>Meldung</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Meldungstyp</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>Ziel</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>zusaetzliche_Header</parameter></methodparam> + </methodsynopsis> + <para> + Sendet eine Fehlermeldung an das Fehlerprotokoll des Webservers, an einen + <acronym>TCP</acronym>-Port oder an eine Datei. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Meldung</parameter></term> + <listitem> + <para> + Die Fehlermeldung, die protokolliert werden soll. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Meldungstyp</parameter></term> + <listitem> + <para> + Sagt, wohin der Fehler gehen soll. Folgende Meldungstypen sind möglich: + </para> + <para> + <table> + <title><function>error_log</function>-Protokolltypen</title> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry> + <parameter>Meldung</parameter> wird an den System-Protokollierer + von PHP gesendet, der in Abhängigkeit von der + Konfigurationsanweisung <link + linkend="ini.error-log">error_log</link> das Protokollsystem des + Betriebssystems oder eine Datei verwendet. Dies ist die + voreingestellte Option. + </entry> + </row> + <row> + <entry>1</entry> + <entry> + <parameter>Meldung</parameter> wird via E-Mail an die Adresse + gesendet, die mit dem Parameter <parameter>Ziel</parameter> + angegeben wurde. Dies ist der einzige Meldungstyp, bei dem der + vierte Parameter <parameter>zusaetzliche_Header</parameter> + verwendet wird. + </entry> + </row> + <row> + <entry>2</entry> + <entry> + Diese Option gibt es nicht mehr. + </entry> + </row> + <row> + <entry>3</entry> + <entry> + <parameter>Meldung</parameter> wird an die Datei + <parameter>Ziel</parameter> angefügt. Ein Zeilenumbruch wird + nicht automatisch an das Ende der Zeichenkette + <parameter>Meldung</parameter> angehängt. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Ziel</parameter></term> + <listitem> + <para> + Das Ziel. Was es bedeutet, hängt vom oben beschriebenen Parameter + <parameter>Meldungstyp</parameter> ab. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>zusaetzliche_Header</parameter></term> + <listitem> + <para> + Die zusätzlichen Kopfzeilen. Dieser Parameter wird verwendet, wenn der + Parameter <parameter>Meldungstyp</parameter> auf <literal>1</literal> + gesetzt ist. Dieser Meldungstyp verwendet dieselbe interne Funktion wie + <function>mail</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example role="php"> + <title><function>error_log</function> Beispiele</title> + <programlisting role="php"> <![CDATA[ <?php -// Server sendet eine Nachricht an den Administrator, -// dass keine Verbindung zur Datenbank möglich ist. -if (!Ora_Logon($username, $password)) { - error_log ("Oracle database not available!", 0); +// Sende eine Nachricht an das Protokoll des Servers, falls +// keine Verbindung zur Datenbank möglich ist. +if (!Ora_Logon($benutzername, $passwort)) { + error_log("Die Oracle-Datenbank ist nicht erreichbar!", 0); } -// Server sendet eine Nachricht an den Administrator, dass FOO langsam ausgeht -if (!($foo = allocate_new_foo()) { - error_log ("Big trouble, we're all out of FOOs!", 1, - "operator@mydomain.com"); +// Benachrichtige den Administrator per E-Mail falls es +// kein FOO mehr gibt. +if (!($foo = allocate_new_foo())) { + error_log("Wir haben ein Problem: FOO ist alle!", 1, + "operator@example.com"); } -// Andere Möglichkeiten, error_log() aufzurufen: -error_log ("You messed up!", 2, "127.0.0.1:7000"); -error_log ("You messed up!", 2, "loghost"); -error_log ("You messed up!", 3, "/var/tmp/my-errors.log"); +// Eine weitere Möglichkeit, error_log() aufzurufen: +error_log("Du hast Mist gebaut!", 3, "/var/tmp/meine-fehler.log"); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/errorfunc/functions/set-error-handler.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/errorfunc/functions/set-error-handler.xml diff -u phpdoc-de/reference/errorfunc/functions/set-error-handler.xml:1.7 phpdoc-de/reference/errorfunc/functions/set-error-handler.xml:1.8 --- phpdoc-de/reference/errorfunc/functions/set-error-handler.xml:1.7 Sat Jun 23 13:21:33 2007 +++ phpdoc-de/reference/errorfunc/functions/set-error-handler.xml Thu May 22 12:54:23 2008 @@ -1,156 +1,324 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook"> - <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> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.38 Maintainer: nobody Status: ready --> +<refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>set_error_handler</refname> + <refpurpose>Bestimmt eine benutzerdefinierte Funktion zur Fehlerbehandlung.</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>set_error_handler</methodname> + <methodparam><type>callback</type><parameter>Fehlerbehandlung</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Fehlertypen</parameter></methodparam> + </methodsynopsis> + <para> + Setzt eine benutzerdefinierte Funktion + (<parameter>Fehlerbehandlung</parameter>) um Fehler in einem Skript zu + behandeln. + </para> + <para> + 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> + Es ist wichtig nicht zu vergessen, dass die standardmässige + PHP-Fehlerbehandlung vollkommen umgangen wird. 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. Es ist besonders zu beachten, dass dieser Wert 0 sein wird, falls + die Anweisung, die den Fehler verursacht hat, mit dem <link + linkend="language.operators.errorcontrol">@ Fehler-Kontroll-Operator</link> + versehen ist. + </para> + <para> + Beachten Sie auch, dass Sie dafür zuständig sind, bei Bedarf + <function>die</function> aufzurufen. Nach der Funktion für die + Fehlerbehandlung wird die Ausführung des Skripts bei der Anweisung + fortgesetzt, die auf die Fehler verursachende Anweisung folgt. + </para> + <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>, + <constant>E_COMPILE_WARNING</constant> und die meisten + <constant>E_STRICT</constant>, die in der Datei ausgelöst werden, in der + <function>set_error_handler</function> aufgerufen wird. + </para> + <para> + Falls Fehler auftreten, bevor das Skript ausgeführt wird (z.B. beim + Hochladen von Dateien), kann eine benutzerdefinierte Fehlerbehandlung nicht + aufgerufen werden, weil sie zu diesem Zeitpunkt noch nicht registriert ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Fehlerbehandlung</parameter></term> + <listitem> + <para> + Die benutzerdefinierte Funktion erwartet notwendig zwei Parameter: den + Fehlercode und eine Zeichenkette, die den Fehler beschreibt. Zudem gibt + es drei optionale Parameter, die übergeben werden können: 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). Die Funktion lässt sich wie folgt darstellen: + </para> + <para> + <methodsynopsis> + <methodname><replaceable>handler</replaceable></methodname> + <methodparam><type>int</type><parameter>Fehlercode</parameter></methodparam> + <methodparam><type>string</type><parameter>Fehlertext</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>Fehlerdatei</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>Fehlerzeile</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>Fehlerkontext</parameter></methodparam> + </methodsynopsis> + <variablelist> + <varlistentry> + <term><parameter>Fehlercode</parameter></term> + <listitem> + <simpara> + Die Stufe des ausgelösten Fehlers als Ganzzahl. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Fehlertext</parameter></term> + <listitem> + <simpara> + Die Fehlermeldung als Zeichenkette. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Fehlerdatei</parameter></term> + <listitem> + <simpara> + Der Name der Datei, in der der Fehler verursacht wurde, als + Zeichenkette. Dieser Parameter ist optional. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Fehlerzeile</parameter></term> + <listitem> + <simpara> + Die Nummer der Zeile, in der der Fehler verursacht wurde, als + Ganzzahl. Dieser Parameter ist optional. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Fehlerkontext</parameter></term> + <listitem> + <simpara> + Ein Array, das auf die Stelle der aktiven Symboltabelle zeigt, die + den Fehler verursacht hat. Mit anderen Worten: + <parameter>Fehlerkontext</parameter> enthält ein Array mit allen + Variablen, die im Fehler auslösenden Bereich existierten. Die + benutzerdefinierte Fehlerbehandlung darf den Fehlerkontext nicht + verändern. Dieser Parameter ist optional. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + Falls diese Funktion &false; zurückgibt, macht die normale + Fehlerbehandlung weiter. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Fehlertypen</parameter></term> + <listitem> + <para> + Kann genauso verwendet werden, wie die Konfigurationseinstellung <link + linkend="ini.error-reporting">error_reporting</link>, die bestimmt, + welche Fehler angezeigt werden, um das Auslösen der Funktion + <parameter>Fehlerbehandlung</parameter> zu maskieren. Wird diese Maske + nicht gesetzt, wird <parameter>Fehlerbehandlung</parameter> unabhängig + vom Wert der Einstellung <link + linkend="ini.error-reporting">error_reporting</link> bei jedem Fehler + ausgelöst. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine Zeichenkette zurück, die die zuvor definierte + Fehlerbehandlungsroutine enthält (falls eine definiert wurde) oder &false;, + falls ein Fehler auftrat. Falls die vorherige Behandlungsroutine eine + Klassenmethode war, gibt diese Funktion ein indiziertes Array mit der + Klasse und dem Namen der Methode zurück. + </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>5.2.0</entry> + <entry> + Die Fehlerbehandlung muss &false; zurückgeben um <link + linkend="reserved.variables.phperrormsg">$php_errormsg</link> zu + füllen. + </entry> + </row> + <row> + <entry>5.0.0</entry> + <entry> + Den Parameter <parameter>Fehlertypen</parameter> hinzugefügt. + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + Anstelle eines Funktionsnamens kann auch ein Array, das eine Referenz + auf ein Objekt und einen Methodennamen enthält, als + <parameter>Fehlerbehandlung</parameter> übergeben werden. + </entry> + </row> + <row> + <entry>4.0.2</entry> + <entry> + Drei optionale Parameter für die Benutzerfunktion + <parameter>Fehlerbehandlung</parameter> hinzugefügt: den Dateinamen, + die Zeilennummer und den Kontext. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Fehlerbehandlung mit <function>set_error_handler</function> und <function>trigger_error</function></title> <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). + Das untenstehende Beispiel zeigt die Behandlung von internen Ausnahmen, + indem Fehler ausgelöst und durch eine benutzerdefinierte Funktion + behandelt werden: </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"> + <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) +function myErrorHandler($fehlercode, $fehlertext, $fehlerdatei, $fehlerzeile) { - 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; - } + switch ($fehlercode) { + case E_USER_ERROR: + echo "<b>Mein FEHLER</b> [$fehlercode] $fehlertext<br />\n"; + echo " Fataler Fehler in Zeile $fehlerzeile in der Datei $fehlerdatei"; + echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n"; + echo "Abbruch...<br />\n"; + exit(1); + break; + + case E_USER_WARNING: + echo "<b>Meine WARNUNG</b> [$fehlercode] $fehlertext<br />\n"; + break; + + case E_USER_NOTICE: + echo "<b>Mein HINWEIS</b> [$fehlercode] $fehlertext<br />\n"; + break; + + default: + echo "Unbekannter Fehlertyp: [$fehlercode] $fehlertext<br />\n"; + break; + } + + /* Damit die PHP-interne Fehlerbehandlung nicht ausgeführt wird */ + return true; } // Funktion zum Test der Fehlerbehandlung -function scale_by_log($vect, $scale) +function logarithmisch_skalieren($vektor, $skalierung) { - 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; + if (!is_numeric($skalierung) || $skalierung <= 0) { + trigger_error("log(x) ist für x <= 0 nicht definiert, Sie verwendeten: skalierung = $skalierung", E_USER_ERROR); + } + + if (!is_array($vektor)) { + trigger_error("Fehlerhafter Eingabevektor, es wird ein Wertearray erwartet", E_USER_WARNING); + return null; + } + + $temp = array(); + foreach($vektor as $pos => $wert) { + if (!is_numeric($wert)) { + trigger_error("Der Wert an Position $pos ist keine Zahl, verwende 0 (Null)", E_USER_NOTICE); + $wert = 0; + } + $temp[$pos] = log($skalierung) * $wert; + } + + return $temp; } // auf die benutzerdefinierte Fehlerbehandlung umstellen -$old_error_handler = set_error_handler("myErrorHandler"); +$alter_error_handler = set_error_handler("myErrorHandler"); -// einige Fehler auslösen, zuerst wird ein gemischtes Array -// definiert mit einem nichtnummerischen Eintrag -echo "vector a\n"; +// ein paar Fehler auslösen, zuerst wird ein gemischtes Array mit einem +// nichtnumerischen Eintrag definiert +echo "Vektor 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); +// ein zweites Array erzeugen +echo "----\nVektor b - ein Hinweis (b = log(PI) * a)\n"; +/* Der Wert an Position $pos ist keine Zahl, verwende 0 (Null) */ +$b = logarithmisch_skalieren($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); - +// das gibt Ärger: statt eines Arrays wird eine Zeichenkette übergeben +echo "----\nVektor c - eine Warnung\n"; +/* Fehlerhafter Eingabevektor, es wird ein Wertearray erwartet */ +$c = logarithmisch_skalieren("kein Array", 2.3); +var_dump($c); // NULL + +// dies ist ein kritischer Fehler: log ist für Null oder negative Werte +// nicht definiert +echo "----\nVektor d - ein fataler Fehler\n"; +/* log(x) ist für x <= 0 nicht definiert, Sie verwendeten: skalierung = $skalierung */ +$d = logarithmisch_skalieren($a, -2.5); +var_dump($d); // wird nie erreicht ?> ]]> - </programlisting> - <para> - Wenn Sie dieses Skript ausführen, erhalten Sie die folgende Ausgabe: - </para> - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ -vector a +Vektor a Array ( [0] => 2 @@ -161,8 +329,8 @@ [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 /> +Vektor b - ein Hinweis (b = log(PI) * a) +<b>Mein HINWEIS</b> [1024] Der Wert an Position 2 ist keine Zahl, verwende 0 (Null)<br /> Array ( [0] => 2.2894597716988 @@ -173,52 +341,34 @@ [5] => 24.165247890281 ) ---- -vector c - an error -<b>ERROR</b> [512] Incorrect input vector, array of values expected<br /> +Vektor c - eine Warnung +<b>Meine WARNUNG</b> [512] Fehlerhafter Eingabevektor, es wird ein Wertearray erwartet<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 /> +Vektor d - ein fataler Fehler +<b>Mein FEHLER</b> [256] log(x) ist für x <= 0 nicht definiert, Sie verwendeten: skalierung = -2.5<br /> + Fataler Fehler in Zeile 35 in der Datei trigger_error.php, PHP 5.2.1 (FreeBSD)<br /> +Abbruch...<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> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>error_reporting</function></member> + <member><function>restore_error_handler</function></member> + <member><function>trigger_error</function></member> + <member><link linkend="errorfunc.constants">Konstanten für die Fehlerstufen</link></member> + <member>&seealso.callback;</member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.de (#2643) next »