PHP set_error_handler()関数


PHP Error 参考手册完全な 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_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");
}
?>

上記のコードの出力は次のとおりです。

Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfoldertest.php
Ending Script


PHP Error 参考手册完全な PHP Error リファレンスマニュアル その他の拡張