関数・クラス解説

trigger_error

version:PHP 4 >= 4.0.1, PHP 5, PHP 7 (公式)

ユーザーレベルのエラー/警告/通知メッセージを生成する

公式リファレンス

書式

trigger_error ( string $error_msg [, int $error_type = E_USER_NOTICE ] ) : bool

説明

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

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

パラメータ

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

返値

この関数は、間違った error_type が指定された場合に FALSE を、それ以外の場合に TRUE を返します。

注意

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

サンプル

例1 trigger_error() の例

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

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

参考

  • error_reporting() - 出力する PHP エラーの種類を設定する
  • set_error_handler() - ユーザー定義のエラーハンドラ関数を設定する
  • restore_error_handler() - 以前のエラーハンドラ関数を回復する
  • エラーレベル定数
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール