[PHP]exitとは?スクリプト全体の実行を終了する方法を徹底解説

PHP

はじめに

これまでの記事で、break(ループ/switchを抜ける)、continue(繰り返しをスキップする)、return(関数を終了する)という、徐々に影響範囲が広がる制御構文を解説してきました。今回取り上げる exit は、その中でも最も強力で、スクリプト全体の実行を即座に終了させる構文です。

exit は、関数やループの範囲を超えて、現在実行中のPHPスクリプトそのものを停止させます。致命的なエラーが発生した際の緊急停止、リダイレクト処理後の後続コード実行防止、デバッグ時の処理の打ち切りなど、「ここから先は一切何も実行してほしくない」という場面で使われます。本記事では基本的な使い方から、よく似た die との関係、実践的な活用例、そして乱用を避けるべき理由まで詳しく解説します。


構文概要

項目内容
構文名exit
種別言語構文(関数のように括弧付きでも、文としても使える)
基本構文exit; または exit('メッセージ'); または exit(整数の終了コード);
引数が文字列の場合終了前にその文字列が出力される
引数が整数の場合シェルへの終了ステータスコードとして使われる(出力はされない)
エイリアスdie(exitと完全に同じ機能を持つ)
対応バージョンPHP 4以前から存在する最古参の構文の一つ

exitの影響範囲(イメージ図)

  関数やループより広い影響範囲

  ┌─────────────────────────────┐
  │ スクリプト全体                       │
  │  ┌───────────────────────┐    │
  │  │ 関数                        │    │
  │  │  ┌─────────────────┐  │    │
  │  │  │ ループ                │  │    │
  │  │  │   break   → ループを抜ける│  │    │
  │  │  └─────────────────┘  │    │
  │  │   return  → 関数を終了する    │    │
  │  └───────────────────────┘    │
  │   exit    → スクリプト全体を終了する   │
  │   ★この記事の対象。すべてを飛び越える  │
  └─────────────────────────────┘

ポイントは、exit が関数やループ、クラスのスコープといった境界を一切考慮せず、呼び出された瞬間にPHPのプロセス全体を停止させるという点です。これは return よりもさらに強力な、最終手段的な制御構文です。


実践サンプル7選

例1:基本的な使い方

<?php

echo '処理を開始します' . PHP_EOL;

exit; // ここでスクリプトの実行が完全に終了する

echo 'この行は絶対に実行されない' . PHP_EOL;

例2:メッセージを出力してから終了する

<?php

function checkRequiredExtension(string $extension): void
{
    if (!extension_loaded($extension)) {
        // 文字列を渡すと、終了前にそのメッセージが出力される
        exit("必須の拡張機能 '{$extension}' がインストールされていません。" . PHP_EOL);
    }
}

checkRequiredExtension('json'); // 通常はjsonは標準で有効なため、この例では終了しない
echo 'チェックに成功しました' . PHP_EOL;

例3:リダイレクト処理後の後続コード実行を防ぐ

<?php

function redirectTo(string $url): never
{
    header("Location: {$url}");
    /**
     * header()でリダイレクトを指定した後も、
     * PHP自体の処理は継続してしまうため、
     * 後続の不要な処理を防ぐためにexitを必ず呼ぶ
     */
    exit;
}

// 実際の使用イメージ(ヘッダー送信前提のため、ここではコメントのみ)
// if (!$isLoggedIn) {
//     redirectTo('/login');
// }
// echo 'ログイン済みユーザー向けの処理'; // リダイレクト時はここまで到達しない

例4:終了ステータスコードを指定する(CLIスクリプトでの活用)

<?php

function validateCliArguments(array $argv): void
{
    if (count($argv) < 2) {
        fwrite(STDERR, '引数が不足しています。使用法: script.php <filename>' . PHP_EOL);
        // 整数を渡すとシェルの終了コードとして使われ、出力はされない
        exit(1); // 慣習的に、異常終了は0以外の値を使う
    }
}

// validateCliArguments($argv);
echo '引数チェックを通過しました' . PHP_EOL;

例5:デバッグ時の処理打ち切り(一時的な使用例)

<?php

function complexCalculation(array $data): array
{
    $step1 = array_map(fn ($x) => $x * 2, $data);

    // デバッグ中、ここまでの結果だけを確認したい場合に一時的に使われる
    // var_dump($step1);
    // exit; // 本番コードには残さないよう注意

    $step2 = array_filter($step1, fn ($x) => $x > 5);

    return array_values($step2);
}

print_r(complexCalculation([1, 2, 3, 4, 5]));

例6:致命的な依存関係の欠如を検知した際の緊急停止

<?php

class CriticalDependencyChecker
{
    public static function ensure(): void
    {
        if (!function_exists('json_encode')) {
            exit('致命的エラー: JSON拡張が利用できません。アプリケーションを起動できません。' . PHP_EOL);
        }
    }
}

CriticalDependencyChecker::ensure();
echo 'すべての依存関係チェックに成功しました' . PHP_EOL;

例7:dieとのエイリアス関係を確認するデモ

<?php

function demonstrateAlias(bool $useExit): never
{
    if ($useExit) {
        exit('exitで終了します' . PHP_EOL);
    } else {
        die('dieで終了します' . PHP_EOL);
    }
}

// 両者は完全に同じ機能を持つエイリアスであり、動作に一切差はない
demonstrateAlias(true);

関連機能との比較

機能役割exitとの違い
exitスクリプト全体の実行を終了する本記事の対象。dieの完全な同義語
dieスクリプト全体の実行を終了するexitと機能的に全く同一のエイリアス
return関数・メソッドの実行を終了するスクリプト全体ではなく、関数の範囲にとどまる、より限定的な構文(別記事で解説済み)
breakループやswitchを抜けるさらに限定的な、ループ範囲内の制御構文(別記事で解説済み)
例外(throw)異常系の処理を構造化して扱うスクリプトを直接終了させず、catchで捕捉して回復処理を行う余地を残す

よくある落とし穴(注意点)

  1. フレームワークやテスト環境でのexitの使用はテストを困難にする exit が実行されると、PHPプロセス自体が終了するため、PHPUnitなどのテストフレームワークでは、そのテストケース自体の実行が強制終了してしまいます。exit を含むコードは単体テストが書きにくくなるため、ライブラリやフレームワークのコードでは、exit の直接呼び出しを避け、例外をスローする設計の方が推奨されます。
  2. デストラクタ(__destruct())やシャットダウン関数は引き続き実行される exit はスクリプトの「通常の」実行を終了させますが、登録済みの register_shutdown_function() や、オブジェクトの __destruct() は、その後に実行される点に注意が必要です。完全に何も実行されなくなるわけではありません。
  3. 引数が文字列か整数かで挙動が変わる exit('message') のように文字列を渡すとその内容が出力されますが、exit(1) のように整数を渡すと、それは画面に表示されず、OSへの終了ステータスコードとして使われます(例4を参照)。この違いを理解していないと、意図しない挙動に戸惑うことがあります。
  4. 本番コードにデバッグ用のexitを残してしまう デバッグ目的で一時的に exit; を挿入した後、消し忘れたまま本番環境にデプロイしてしまうと、アプリケーションがその箇所で突然停止する深刻な障害につながります(例5を参照)。
  5. header()によるリダイレクトの後は必ずexitを呼ぶ習慣をつける header('Location: ...') を呼んだだけでは、PHP自体の処理は停止しません。意図しない後続処理が実行されてしまうことを防ぐため、リダイレクト処理の直後には必ず exit; を呼ぶことが、セキュリティ上も重要な定番パターンです(例3を参照)。

まとめ

観点まとめ
何をする構文か現在実行中のPHPスクリプト全体の実行を、即座に終了させる
主な用途リダイレクト処理後の後続コード防止、CLIスクリプトでの終了コード指定、致命的エラー時の緊急停止
dieとの関係完全に同じ機能を持つ、単なるエイリアス(別名)
引数の違い文字列ならメッセージを出力、整数ならシェルの終了コードとして使われる
注意点テストのしにくさ、デストラクタ等は引き続き実行されること、本番コードへの残留に注意

exit は、PHPスクリプトの実行を最も強力に、かつ即座に停止させるための構文です。リダイレクト後の定番パターンのように正当な用途がある一方、テストのしにくさや本番環境への誤残留といったリスクも伴うため、本当に「スクリプト全体を今すぐ止めるべきか」を見極めた上で、慎重に使用することが求められます。

タイトルとURLをコピーしました