wp_die()


WordPressのwp_die()関数は、スクリプトの実行を停止し、エラーメッセージやカスタムメッセージを表示するために使用されます。この関数は、致命的なエラーが発生した場合や、特定の条件が満たされない場合に使用されます。

構文

wp_die( string|WP_Error $message = '', string|int $title = '', int $args = array() );

引数の説明:

  • $message (string|WP_Error) — 表示するメッセージまたはWP_Errorオブジェクト。
  • $title (string|int) — エラーページのタイトル。デフォルトは空。
  • $args (int|array) — 追加の引数。ステータスコードやレスポンスコードを指定できます。

例1: シンプルなエラーメッセージの表示

基本的なエラーメッセージを表示します。

wp_die('エラーが発生しました。');

例2: カスタムタイトル付きのエラーメッセージ

カスタムタイトルを指定してエラーメッセージを表示します。

wp_die('エラーが発生しました。', 'エラータイトル');

例3: ステータスコードの指定

HTTPステータスコードを指定してエラーメッセージを表示します。

wp_die('ページが見つかりません。', '404エラー', array('response' => 404));

例4: WP_Errorオブジェクトの使用

WP_Errorオブジェクトを使用してエラーメッセージを表示します。

$error = new WP_Error('error_code', 'エラーメッセージ'); wp_die($error);

例5: カスタムHTMLの表示

カスタムHTMLを含むエラーメッセージを表示します。

wp_die('<h1>カスタムエラー</h1><p>詳細なエラーメッセージ。</p>');

例6: リダイレクトの指定

エラーメッセージ表示後にリダイレクトを行います。

wp_die('エラーが発生しました。', 'エラータイトル', array('response' => 500, 'link_url' => home_url(), 'link_text' => 'ホームに戻る'));

例7: カスタムレスポンスコードの指定

カスタムレスポンスコードを指定してエラーメッセージを表示します。

wp_die('アクセスが拒否されました。', '403エラー', array('response' => 403));

例8: エラーメッセージのカスタマイズ

エラーメッセージのスタイルやレイアウトをカスタマイズします。

wp_die('<div style="color:red;">重大なエラーが発生しました。</div>');

注意点

  • wp_die()はスクリプトの実行を停止するため、慎重に使用してください。
  • エラーメッセージはユーザーに表示されるため、機密情報を含めないように注意してください。
  • ステータスコードを適切に設定することで、SEOやユーザーエクスペリエンスに影響を与えることがあります。

関連機能：