set_error_handler

Beschreibung

Setzt eine benutzerdefinierte Funktion (error_handler) 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 trigger_error()) eine Fehlermeldung zu generieren.

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 eine Fehlermeldung und die Behandlung des Fehlers durch eine benutzerdefinierte Funktion ausgelöst wird:

Beispiel 1. Fehlerbehandlung mit set_error_handler() und trigger_error() <?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); ?> Wenn Sie dieses Skript ausführen, erhalten Sie die folgende Ausgabe: 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 />

Es ist wichtig und darf nicht vergessen werden, dass die standardmässige PHP Fehlerbehandlung vollkommen umgangen wurde. Die Einstellungen der Funktion error_reporting() haben keine Auswirkung und Ihre eigene Fehlerbehandlungsroutine wird ohne Rücksicht darauf aufgerufen. Sie können jedoch immer noch den aktuellen Wert von error_reporting lesen und entsprechend handeln. Von besonderer Bedeutung ist, dass dieser Wert 0 sein wird, falls der Befehl, der den Fehler verurscht hat, mit dem @ error-control operator versehen ist.

Beachten Sie auch, dass Sie die() 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.

Siehe auch error_reporting(), restore_error_handler(), trigger_error(), und error level constants.