PHP user_error()関数

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

定義と用法

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

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

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

不正なエラータイプが指定された場合、この関数は FALSE を返し、それ以外の場合は TRUE を返します。

この関数は trigger_error()関数のエイリアスです。

構文

user_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)
{
user_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 リファレンスマニュアル その他の拡張機能