die

関数の概要

PHPの die 関数は、メッセージを出力した後にスクリプトの実行を即座に終了させるための関数です。主にエラーが発生した際や、処理を続行できない状況で使用されます。exit 関数のエイリアス(別名)でもあり、同じ動作をします。

パラメータの説明

  • string $message(省略可能): 終了前に画面やレスポンスに出力する文字列です。指定しない場合は何も出力せずに終了します。

戻り値

die 関数は戻り値を返しません。関数呼び出し後はスクリプトの実行が停止します。

使用例

基本的な使い方

<?php
if (!file_exists('config.php')) {
    die('設定ファイルが見つかりません。処理を停止します。');
}
// 以降の処理は設定ファイルが存在するときのみ実行される
?>

ファイルの存在チェックで見つからなければメッセージを出力し処理を終了します。

メッセージ無しで終了

<?php
if ($user_is_logged_in === false) {
    die();
}
// ログイン済みユーザー以降の処理
?>

メッセージを指定しない場合は何も表示せずスクリプトを終了します。

エラーメッセージと共に終了コードを指定する(exitとしての使い方)

<?php
if (!$db_connection) {
    die('データベース接続に失敗しました。');
}
?>

エラーメッセージを表示し、以降の処理を中止します。なお die は整数を指定して終了コードのみを返すことも可能ですが、メッセージ出力が主用途です。

関連する関数

  • exitdie のエイリアスで同じ動作。
  • trigger_error – エラーメッセージを出力するがスクリプトは続行。
  • throw (例外) – 処理を中断するが例外処理機構を利用。

まとめ

die 関数はPHPでスクリプトの処理を中断するときに使うシンプルで便利な関数です。メッセージの出力も同時にできるため、特にエラーハンドリングや条件に応じて処理を止めたい場合に活躍します。exit と同義であり、用途や好みに応じて使い分けが可能です。