[PHP]throwとは?例外を発生させてエラーを構造的に伝える方法を徹底解説

PHP

はじめに

これまでの記事で、return(関数を終了する)や exit(スクリプト全体を終了する)といった、処理の流れを制御する構文を解説してきました。今回取り上げる throw は、これらとは異なるアプローチで、「異常事態が発生した」という事実を、構造化された形で呼び出し元に伝えるための構文です。

throw は、例外(Exception やその派生クラスのオブジェクト)を発生させ、それに対応する catch ブロックが見つかるまで、関数やメソッドの呼び出し階層を遡っていく仕組みです。単純なエラーメッセージの出力やスクリプトの強制終了とは異なり、呼び出し元に「どのような異常が起きたか」を詳細に伝えつつ、回復の機会を与えられるという点で、現代的なエラーハンドリングの中核を担っています。本記事では基本的な使い方から、PHP 8.0で導入された「式としてのthrow」、実践的な活用例まで詳しく解説します。


構文概要

項目内容
構文名throw
種別文および式(PHP 8.0以降は式としても使用可能)
基本構文throw new ExceptionClass('メッセージ');
対象Throwableインターフェースを実装したオブジェクト(Exception、Errorおよびそれらの派生クラス)
捕捉方法try–catchブロックで捕捉する
捕捉されない場合致命的エラーとなり、スクリプトの実行が停止する
式としての使用PHP 8.0以降、三項演算子やアロー関数の中で直接使える

throwの動作フロー(イメージ図)

  function processOrder(int $amount) {
      if ($amount <= 0) {
          throw new InvalidArgumentException('金額は正の数である必要があります');
      }
      // ...通常処理...
  }

  try {
      processOrder(-100);
  } catch (InvalidArgumentException $e) {
      echo 'エラー: ' . $e->getMessage();
  }
              │
              ▼
  ┌───────────────────────────┐
  │ throwされた例外オブジェクトは、            │
  │ 呼び出し階層を遡りながら、                 │
  │ 対応するcatchブロックが見つかるまで        │
  │ 探索され続ける                            │
  └───────────────────────────┘

ポイントは、throw が実行された時点で通常の処理フローが即座に中断され、例外オブジェクトを携えたまま、適切な catch ブロックを探す特殊なジャンプが発生するという点です。対応する catch が見つからなければ、その探索はスクリプトの最上位まで続き、最終的に致命的エラーとなります。


実践サンプル7選

例1:基本的な使い方

<?php

function divide(int $a, int $b): float
{
    if ($b === 0) {
        throw new DivisionByZeroError('0で除算することはできません');
    }
    return $a / $b;
}

try {
    echo divide(10, 0) . PHP_EOL;
} catch (DivisionByZeroError $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例2:独自の例外クラスで意味のあるエラーを表現する

<?php

class InsufficientFundsException extends \Exception
{
    public function __construct(private float $required, private float $available)
    {
        parent::__construct("残高不足です(必要: {$required}円, 残高: {$available}円)");
    }

    public function getShortfall(): float
    {
        return $this->required - $this->available;
    }
}

function withdraw(float $balance, float $amount): float
{
    if ($amount > $balance) {
        throw new InsufficientFundsException($amount, $balance);
    }
    return $balance - $amount;
}

try {
    withdraw(1000, 1500);
} catch (InsufficientFundsException $e) {
    echo $e->getMessage() . '(不足額: ' . $e->getShortfall() . '円)' . PHP_EOL;
}

例3:バリデーションルールの集約での活用

<?php

function validateAge(int $age): void
{
    if ($age < 0) {
        throw new InvalidArgumentException('年齢は0以上である必要があります');
    }
    if ($age > 150) {
        throw new InvalidArgumentException('年齢の値が不自然に大きいです');
    }
}

try {
    validateAge(-5);
} catch (InvalidArgumentException $e) {
    echo '検証エラー: ' . $e->getMessage() . PHP_EOL;
}

例4:PHP 8.0以降の「式としてのthrow」の活用

<?php

function getConfigValue(array $config, string $key): mixed
{
    /**
     * PHP 8.0以降、throwは式として扱えるため、
     * Null合体演算子(??)の右辺に直接書ける
     */
    return $config[$key] ?? throw new \RuntimeException("設定キー '{$key}' が見つかりません");
}

try {
    echo getConfigValue(['timeout' => 30], 'timeout') . PHP_EOL;
    echo getConfigValue(['timeout' => 30], 'retries') . PHP_EOL;
} catch (\RuntimeException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例5:アロー関数内でのthrow式の活用

<?php

$divide = fn (int $a, int $b) => $b !== 0
    ? $a / $b
    : throw new InvalidArgumentException('ゼロ除算は許可されていません');

try {
    echo $divide(10, 2) . PHP_EOL;
    echo $divide(10, 0) . PHP_EOL;
} catch (InvalidArgumentException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例6:例外の再スロー(チェーン化)によるコンテキストの追加

<?php

function fetchDataFromApi(): array
{
    throw new \RuntimeException('API接続がタイムアウトしました');
}

function loadUserDashboard(): array
{
    try {
        return fetchDataFromApi();
    } catch (\RuntimeException $e) {
        /**
         * 元の例外を第2引数(previous)として渡すことで、
         * エラーの原因チェーンを保持したまま、
         * より文脈に即した新しい例外として再スローする
         */
        throw new \RuntimeException('ダッシュボードの読み込みに失敗しました', 0, $e);
    }
}

try {
    loadUserDashboard();
} catch (\RuntimeException $e) {
    echo $e->getMessage() . PHP_EOL;
    echo '原因: ' . $e->getPrevious()?->getMessage() . PHP_EOL;
}

例7:ガード節的な活用による早期エラー検知

<?php

class OrderProcessor
{
    public function process(?array $order): string
    {
        /**
         * 早期リターンと同様の発想で、
         * 不正な状態を検知した時点で即座にthrowする
         */
        if ($order === null) {
            throw new \InvalidArgumentException('注文データがnullです');
        }

        if (empty($order['items'])) {
            throw new \InvalidArgumentException('商品が選択されていません');
        }

        return '注文処理に成功しました';
    }
}

$processor = new OrderProcessor();
try {
    echo $processor->process(['items' => []]) . PHP_EOL;
} catch (\InvalidArgumentException $e) {
    echo '処理エラー: ' . $e->getMessage() . PHP_EOL;
}

関連機能との比較

機能役割throwとの違い
throw例外を発生させ、呼び出し階層を遡って伝播させる本記事の対象。構造化され、catchで捕捉・回復が可能
return(エラーコード)戻り値でエラーの有無を表現する呼び出し元が戻り値のチェックを忘れると、エラーが静かに無視されるリスクがある
trigger_error()E_USER系のエラーを発生させる(従来の警告の仕組み)例外のようにcatchで構造的に捕捉することが基本的にはできない
exit / dieスクリプト全体の実行を即座に終了する回復の余地を一切残さず、プロセス自体を停止させる、より強力な手段
assert()前提条件が満たされているかを検証する本番環境では無効化されることが多く、デバッグ・開発時の検証が主目的

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

  1. throwした例外を誰もcatchしないと致命的エラーになる 対応する try–catch ブロックが呼び出し階層のどこにも存在しない場合、例外は「未処理の例外(Uncaught Exception)」として致命的エラーを引き起こし、スクリプトが停止します。重要な処理では、適切な階層で catch を用意しておくことが必要です。
  2. ExceptionとErrorの違いを理解する PHP 7以降、throw できるのは Throwable インターフェースを実装したクラスであり、プログラマが意図的に発生させる Exception 系と、言語内部の致命的な問題を表す Error 系(TypeError、DivisionByZeroErrorなど)の両方が含まれます。これらを区別して catch することで、より的確なエラーハンドリングが可能になります。
  3. 例外の多用がパフォーマンスに影響する可能性 例外のスローとキャッチには、通常の条件分岐に比べてわずかなオーバーヘッドがあります。頻繁に発生することが予想される「通常のフロー制御」のために例外を多用するのは、設計として適切でない場合があります。例外は、文字通り「例外的な」状況のために使うのが基本です。
  4. 再スロー時に元の例外情報を失わないようにする 例外をキャッチして別の例外として再スローする際、第3引数($previous)に元の例外を渡し忘れると、エラーの根本原因(スタックトレース)の情報が失われてしまいます。デバッグのしやすさを保つため、再スロー時はチェーン化を徹底しましょう(例6を参照)。
  5. PHP 8.0未満では「式としてのthrow」が使えない $value ?? throw new Exception(...) のような書き方は、PHP 8.0以降でのみ有効です。それより古いバージョンとの互換性が必要な場合は、従来通り if 文の中で throw を使う必要があります(例4・例5を参照)。

まとめ

観点まとめ
何をする構文か例外オブジェクトを発生させ、対応するcatchブロックが見つかるまで呼び出し階層を遡って伝播させる
主な用途入力値の検証エラー、致命的な異常事態の通知、エラーのコンテキストを保持した再スロー
対象Throwableを実装したオブジェクト(Exception系、Error系)
PHP 8.0の新機能throwを式として扱えるようになり、Null合体演算子やアロー関数内で直接使用可能
注意点未処理の例外による致命的エラー、パフォーマンスへの配慮、再スロー時のチェーン化

throw は、PHPにおける構造化されたエラーハンドリングの出発点であり、単なるエラーメッセージの出力や処理の強制終了とは一線を画す、回復可能性を残した例外処理の中核です。try–catch と組み合わせることで、異常事態をコードの流れの中で明確に、かつ柔軟に扱うことができます。

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