導入

以下の関数は、エラー処理およびログ記録を行います。これらの関数によ り、独自のエラー処理規則を定義することが可能になり、同時にエラーの ログを記録する方法を修正することが可能になります。これにより、ニーズに 即したエラー出力の変更と拡張が可能になります。

ログ記録関数により他のマシンやemail(またはポケベルのゲートウエイ に!)、システムログ等に直接メッセージを送信することが可能になります。 これにより、ログを行うものを選択したり、アプリケーションやWebサイ トに最も重要な部分をモニタすることが可能になります。

エラー出力関数により、エラーのフィードバックのレベルと種類、 簡単な通知からカスタマイズされた関数までエラーの際に返すもの をカスタマイズすることが可能になります。

要件

これらの関数は、標準モジュールの一部として利用可能であり、常に使用できます。

インストール手順

これらの関数はPHPコアに含まれるため、使用す る際にインストールは不要です。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

以下に設定ディレクティブの簡単な説明を示します。

定義済みの定数

この一覧にある定数は、PHPコアに含まれており常に利用可能です。

上記の値（数値も論理値も）はどのエラーをレポートするかを指定する ビットマスクを組み立てる。ビット演算子 を使用して値を組み合わせたり特定のエラータイプをマスクすることができる。 php.ini では'|', '~', '!', '^' and '&'のみが解釈されることに 注意すべきであるが、しかし、php3.iniでは ビット演算子は解釈されないことにも注意すべきである。

例

エラー処理機能をPHPで使用するための例を示します。ファイルに(XML形式 で)情報を記録し、論理的に致命的なエラーの場合開発者に電子メールを送 信するようなエラー処理関数を定義します。

例 1. スクリプト内でのエラー処理 <?php // we will do our own error handling error_reporting(0); // user defined error handling function function userErrorHandler ($errno, $errmsg, $filename, $linenum, $vars) {    // timestamp for the error entry    $dt = date("Y-m-d H:i:s (T)");    // define an assoc array of error string    // in reality the only entries we should    // consider are 2,8,256,512 and 1024    $errortype = array (                1  =>  "Error",                2  =>  "Warning",                4  =>  "Parsing Error",                8  =>  "Notice",                16  =>  "Core Error",                32  =>  "Core Warning",                64  =>  "Compile Error",                128 =>  "Compile Warning",                256 =>  "User Error",                512 =>  "User Warning",                1024=>  "User Notice"                );    // set of errors for which a var trace will be saved    $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);       $err = "<errorentry>\n";    $err .= "\t<datetime>".$dt."</datetime>\n";    $err .= "\t<errornum>".$errno."</errornum>\n";    $err .= "\t<errortype>".$errortype[$errno]."</errortype>\n";    $err .= "\t<errormsg>".$errmsg."</errormsg>\n";    $err .= "\t<scriptname>".$filename."</scriptname>\n";    $err .= "\t<scriptlinenum>".$linenum."</scriptlinenum>\n";    if (in_array($errno, $user_errors))        $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n";    $err .= "</errorentry>\n\n";       // for testing    // echo $err;    // save to the error log, and e-mail me if there is a critical user error    error_log($err, 3, "/usr/local/php4/error.log");    if ($errno == E_USER_ERROR)        mail("[email protected]","Critical User Error",$err); } function distance ($vect1, $vect2) {    if (!is_array($vect1) || !is_array($vect2)) {        trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR);        return NULL;    }    if (count($vect1) != count($vect2)) {        trigger_error("Vectors need to be of the same size", E_USER_ERROR);        return NULL;    }    for ($i=0; $i<count($vect1); $i++) {        $c1 = $vect1[$i]; $c2 = $vect2[$i];        $d = 0.0;        if (!is_numeric($c1)) {            trigger_error("Coordinate $i in vector 1 is not a number, using zero",                            E_USER_WARNING);            $c1 = 0.0;        }        if (!is_numeric($c2)) {            trigger_error("Coordinate $i in vector 2 is not a number, using zero",                            E_USER_WARNING);            $c2 = 0.0;        }        $d += $c2*$c2 - $c1*$c1;    }    return sqrt($d); } $old_error_handler = set_error_handler("userErrorHandler"); // undefined constant, generates a warning $t = I_AM_NOT_DEFINED; // define some "vectors" $a = array(2,3,"foo"); $b = array(5.5, 4.3, -1.6); $c = array (1,-3); // generate a user error $t1 = distance($c,$b)."\n"; // generate another user error $t2 = distance($b,"i am not an array")."\n"; // generate a warning $t3 = distance($a,$b)."\n"; ?>

以下も参照下さい

syslog()も参照して下さい。