PHPのtrigger_error()関数とは？使い方とエラータイプをわかりやすく解説

PHPのtrigger_error()関数は、開発者が独自に定義したエラーメッセージ（ユーザー定義エラー）を生成するための関数です。条件分岐などで特定の状況を検出した際に、意図的にエラーや警告を発生させたい場合に活用されます。

構文

trigger_error(error_msg, error_type)

パラメータ

• error_msg − 発生させるエラーメッセージを指定します。メッセージの長さは1024文字までに制限されています。

• error_type − このエラーメッセージに割り当てるエラータイプを指定します。

指定可能なエラータイプ

• E_USER_ERROR − ユーザーが生成した致命的な実行時エラーです。回復できないエラーとして扱われ、スクリプトの実行はその時点で停止します。

• E_USER_WARNING − 致命的ではないユーザー生成の実行時警告です。スクリプトの実行は継続されます。

• E_USER_NOTICE − デフォルト値です。ユーザー生成の実行時通知を表します。スクリプトが「エラーの可能性があるもの」を検出したものの、通常の実行でも起こりうる状況であることを示します。

戻り値

trigger_error()関数は、誤ったerror_typeが指定された場合はFALSEを返し、正しく指定された場合はTRUEを返します。

使用例

以下はtrigger_error()関数を使用したサンプルコードです。

<?php
if ($demo<50) {
   trigger_error("Number cannot be less than 50");
}
?>

出力結果

このコードを実行すると、次のようなカスタムエラー（通知）が表示されます。

PHP Notice: Undefined variable: demo in /home/cg/root/4127336/main.php on line 2
PHP Notice: Number cannot be less than 50 in /home/cg/root/4127336/main.php on line 3

補足：set_error_handler()との組み合わせ

trigger_error()で発生させたユーザー定義エラーは、set_error_handler()関数で登録したカスタムエラーハンドラによって捕捉できます。これにより、エラーメッセージのログ記録や独自のエラー表示など、柔軟なエラー処理を実装することが可能です。