PHP マニュアル: ユーザーレベルのエラー/警告/通知メッセージを生成する

true trigger_error(string $message, int $error_level = E_USER_NOTICE)

ユーザーエラーを発生させるために使います。組み込みのエラーハンドラまたは新しいエラーハンドラ (set_error_handler) として設定済みのユーザー定義関数と組み合わせて使うこともできます。

この関数は、実行時の例外に特定の応答を生成する必要がある場合に便利です。

message: このエラーに割り当てられたメッセージ。長さは最大 1024 バイトまでです。1024 バイトを超える部分は切り捨てられます。
error_level: このエラーに割り当てられたエラー型です。E_USER_* の定数のみが指定可能で、デフォルトは E_USER_NOTICE です。

常に true を返します。

error_level が E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED のいずれかでない場合、この関数は ValueError をスローします。

バージョン	説明
8.0.0	不正な `error_level` を指定すると、ValueError をスローするようになりました。これより前のバージョンでは、`false` を返していました。

例1 trigger_error の例

より拡張した例については set_error_handler を参照ください。

<?php
if ($divisor == 0) {
    trigger_error("ゼロで割ることはできません", E_USER_ERROR);
}
?>

警告

message の HTML エンティティはエスケープされません。エラーをブラウザに表示するのであれば、メッセージに htmlentities を使います。