PHP set_error_handler()関数
完全な PHP Error リファレンスマニュアル
定義と使用法
set_error_handler() 関数はユーザー定義のエラー処理関数を設定します。
この関数は、実行時にユーザー独自のエラー処理メソッドを作成するために使用されます。
この関数は古いエラーハンドラを返し、失敗した場合は NULL を返します。
構文
set_error_handler(error_function,error_types)
| パラメータ | 説明 |
|---|---|
| error_function | 必須。エラーが発生したときに実行される関数を指定します。 |
| error_types | オプション。どのエラー報告レベルでユーザー定義のエラーが表示されるかを指定します。デフォルトは "E_ALL" です。可能なエラー報告レベルについては、以下の表を参照してください。 |
error_function
構文
error_function(error_level,error_message,
error_file,error_line,error_context)
error_file,error_line,error_context)
| パラメータ | 説明 |
|---|---|
| error_level | 必須。ユーザー定義エラーのエラー報告レベルを指定します。数値でなければなりません。可能なエラー報告レベルについては、以下の表を参照してください。 |
| error_message | 必須。ユーザー定義エラーのエラーメッセージを指定します。 |
| error_file | オプション。エラーが発生したファイル名を指定します。 |
| error_line | オプション。エラーが発生した行番号を指定します。 |
| error_context | オプション。エラーが発生した時点でアクティブなシンボルテーブルを指す配列を指定します。言い換えれば、error_context には、エラーを引き起こした各変数の存在範囲を説明する配列が含まれます。 |
エラー報告レベル
| 值 | 定数 | 説明 |
|---|---|---|
| 2 | E_WARNING | 実行時の致命的でないエラー。スクリプトの実行を停止しません。 |
| 8 | E_NOTICE | 実行時の通知。スクリプトがエラーと見なされる可能性のあるものを発見したが、正常なスクリプト実行中にも発生する可能性があります。 |
| 256 | E_USER_ERROR | ユーザー生成の致命的なエラー。これは、プログラマーが PHP 関数 trigger_error() を使用して生成する E_ERROR と同様です。 |
| 512 | E_USER_WARNING | ユーザー生成の致命的でないエラー。これは、プログラマーが PHP 関数 trigger_error() を使用して生成する E_WARNING と同様です。 |
| 1024 | E_USER_NOTICE | ユーザー生成の通知。これは、プログラマーが PHP 関数 trigger_error() を使用して生成する E_NOTICE と同様です。 |
| 4096 | E_RECOVERABLE_ERROR | 捕捉可能な致命的なエラー。これは、ユーザー定義のハンドラー(set_error_handler() を参照)によって捕捉できる E_ERROR と同様です。 |
| 8191 | E_ALL | E_STRICT を除くすべてのエラーおよび警告のレベル(PHP 6.0 以降、E_STRICT は E_ALL の一部となります)。 |
ヒントと注記
ヒント:この関数を使用すると、標準の PHP エラー処理関数は完全にバイパスされます。必要に応じて、ユーザー定義のエラーハンドラはスクリプトを終了しなければなりません(die())。
注記:スクリプトの実行前にエラーが発生した場合、その時点ではカスタムハンドラがまだ登録されていないため、このカスタムエラーハンドラは使用されません。
例
<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
上記のコードの出力は次のとおりです。
Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfoldertest.php
Ending Script
Error on line 19 in C:webfoldertest.php
Ending Script
完全な PHP Error リファレンスマニュアル その他の拡張