PHP trigger_error()関数


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


定義と用法

trigger_error() 関数はユーザー定義のエラーメッセージを作成します。

trigger_error() 関数は、ユーザーが指定した条件下でエラーメッセージをトリガーするために使用されます。これは、組み込みのエラーハンドラと一緒に使用することも、set_error_handler() 関数によって設定されたユーザー定義関数と一緒に使用することもできます。

スクリプト実行中に特定の条件下でエラーメッセージをカスタマイズする必要がある場合、この関数は役立ちます。

無効なエラー型が指定された場合、この関数は FALSE を返し、それ以外の場合は TRUE を返します。

構文

trigger_error(error_message,error_types)

パラメータ 説明
error_message 必須。エラーメッセージを指定します。長さは 1024 文字に制限されています。
error_types オプション。エラーメッセージのエラー型を指定します。

可能なエラー型:

  • E_USER_ERROR - ユーザー生成の実行時致命的エラー。回復不能なエラー。スクリプトの実行を停止します。
  • E_USER_WARNING - ユーザー生成の実行時非致命的警告。スクリプトの実行は停止しません。
  • E_USER_NOTICE - デフォルト。ユーザー生成の実行時通知。スクリプトはエラーである可能性を発見しましたが、スクリプトが正常に実行されているときにも発生する可能性があります。


例

<?php
$test=2;
if ($test>1)
{
    trigger_error("A custom error has been triggered");
}
?>

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

Notice: A custom error has been triggered
in C:webfoldertest.php on line 6


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

その他の拡張機能