導入

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

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

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

要件

外部ライブラリを必要としません。

インストール手順

PHP コアに含まれるため、 追加のインストール無しで使用できます。

実行時設定

php.ini の設定により動作が変化します。

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

定義済み定数

以下の定数は、PHP コアに含まれており、常に利用可能です。

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

例

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

例 1. スクリプト内でのエラー処理 <?php // 自分のエラーハンドリングを行います error_reporting(0); // ユーザーの定義したエラーハンドリング関数 function userErrorHandler($errno, $errmsg, $filename, $linenum, $vars) {     // エラーエントリのタイムスタンプ     $dt = date("Y-m-d H:i:s (T)");     // エラー文字列の連想配列を定義します。     // 実際のところ、考慮する必要があるのは     // E_WARNING、E_NOTICE、E_USER_ERROR、     // E_USER_WARNING そして E_USER_NOTICE だけです。     $errortype = array (                 E_ERROR              => 'Error',                 E_WARNING            => 'Warning',                 E_PARSE              => 'Parsing Error',                 E_NOTICE             => 'Notice',                 E_CORE_ERROR         => 'Core Error',                 E_CORE_WARNING       => 'Core Warning',                 E_COMPILE_ERROR      => 'Compile Error',                 E_COMPILE_WARNING    => 'Compile Warning',                 E_USER_ERROR         => 'User Error',                 E_USER_WARNING       => 'User Warning',                 E_USER_NOTICE        => 'User Notice',                 E_STRICT             => 'Runtime Notice',                 E_RECOVERABLE_ERROR  => 'Catchable Fatal Error'                 );     // 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";          // テスト用     // echo $err;     // エラーログを保存し、重大なユーザーエラーは自分にメールする     error_log($err, 3, "/usr/local/php4/error.log");     if ($errno == E_USER_ERROR) {         mail("phpdev@example.com", "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"); // 未定義定数による警告の生成 $t = I_AM_NOT_DEFINED; // いくつかの「ベクタ」定義 $a = array(2, 3, "foo"); $b = array(5.5, 4.3, -1.6); $c = array(1, -3); // ユーザエラーの生成 $t1 = distance($c, $b) . "\n"; // 他のユーザエラーの生成 $t2 = distance($b, "i am not an array") . "\n"; // 警告の生成 $t3 = distance($a, $b) . "\n"; ?>

参考

syslog()も参照してください。