[PHP]catchとは?発生した例外を型で捕捉し処理する方法を徹底解説

PHP

はじめに

前回の記事では、例外が発生する可能性のある処理を区切る try を解説し、その中で catch の基本的な役割に触れました。今回は、この catch を正面から取り上げ、「どの型の例外を、どのように捕捉するか」という設計の核心部分を詳しく掘り下げます。

catch は、try ブロック内(またはその呼び出し先)で throw された例外のうち、指定した型(クラス)に一致するものだけを捕捉し、その後の処理を記述するための構文です。どの例外型をどう書くか、複数の catch をどう並べるか、例外オブジェクトからどんな情報を取り出せるかといった知識は、堅牢なエラーハンドリングを設計する上で欠かせません。本記事では基本的な使い方から、実践的な活用パターン、よくある落とし穴まで詳しく解説します。


構文概要

項目内容
構文名catch
種別制御構造(tryと組み合わせて使用)
基本構文catch (ExceptionType $e) { ... }
変数の省略PHP 8.0以降、例外オブジェクトが不要ならcatch (ExceptionType) { ... }と書ける
複数型の指定catch (TypeA | TypeB $e)(PHP 7.1以降)
捕捉対象Throwableインターフェースを実装したクラス(Exception系、Error系)
対応バージョンPHP 5.0以降

catchの型マッチングの仕組み(イメージ図)

  try {
      throw new InvalidArgumentException('不正な値です');
  } catch (TypeError $e) {
      // マッチしない: InvalidArgumentExceptionはTypeErrorではない
  } catch (InvalidArgumentException $e) {
      // ★ここがマッチする(最初に型が一致したブロック)
  } catch (\Exception $e) {
      // 実行されない: 既に上のブロックでマッチ済みのため
  }
              │
              ▼
  ┌───────────────────────────┐
  │ catchは上から順番に型チェックを行い、      │
  │ 最初に一致した(継承関係も含む)           │
  │ 1つのブロックだけが実行される              │
  └───────────────────────────┘

ポイントは、catch の型チェックが継承関係を考慮するという点です。InvalidArgumentException は \Exception のサブクラスであるため、もし catch (\Exception $e) を先に書いていれば、より具体的な InvalidArgumentException の catch が書かれていたとしても、そちらは実行されません。


実践サンプル7選

例1:基本的な使い方

<?php

function parseJson(string $json): array
{
    $result = json_decode($json, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new \JsonException('JSONの解析に失敗しました: ' . json_last_error_msg());
    }
    return $result;
}

try {
    print_r(parseJson('{invalid json}'));
} catch (\JsonException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例2:例外オブジェクトから詳細情報を取り出す

<?php

function riskyCalculation(int $value): int
{
    if ($value < 0) {
        throw new \RangeException('値は0以上である必要があります', 1001);
    }
    return $value * 2;
}

try {
    riskyCalculation(-5);
} catch (\RangeException $e) {
    echo 'メッセージ: ' . $e->getMessage() . PHP_EOL;
    echo 'コード: ' . $e->getCode() . PHP_EOL;
    echo '発生ファイル: ' . basename($e->getFile()) . PHP_EOL;
    echo '発生行: ' . $e->getLine() . PHP_EOL;
}

例3:型の継承関係を利用した広い範囲での捕捉

<?php

class PaymentException extends \Exception {}
class InsufficientFundsException extends PaymentException {}
class CardExpiredException extends PaymentException {}

function processPayment(string $type): never
{
    throw match ($type) {
        'funds' => new InsufficientFundsException('残高不足です'),
        'expired' => new CardExpiredException('カードの有効期限が切れています'),
    };
}

try {
    processPayment('funds');
} catch (PaymentException $e) {
    // 親クラスPaymentExceptionで捕捉することで、
    // すべての決済関連の例外をまとめてハンドリングできる
    echo '決済エラー: ' . get_class($e) . ' - ' . $e->getMessage() . PHP_EOL;
}

例4:Error系とException系を区別して捕捉する

<?php

function callUndefinedMethod(object $obj): void
{
    $obj->thisMethodDoesNotExist();
}

try {
    callUndefinedMethod(new stdClass());
} catch (\Error $e) {
    /**
     * メソッド呼び出しエラーはExceptionではなくErrorのサブクラスになる
     * (PHP 7以降、プログラムの構造的な問題はError系として扱われる)
     */
    echo 'プログラムエラー: ' . $e->getMessage() . PHP_EOL;
} catch (\Exception $e) {
    echo '例外: ' . $e->getMessage() . PHP_EOL;
}

例5:\Throwableで両方をまとめて捕捉する最終防衛ライン

<?php

function unpredictableOperation(int $mode): never
{
    if ($mode === 1) {
        throw new \Exception('通常の例外');
    }
    throw new \TypeError('型エラー(Error系)');
}

function safeExecute(callable $callback): string
{
    try {
        $callback();
        return '成功';
    } catch (\Throwable $e) {
        /**
         * Exception系・Error系の両方を含む\Throwableで捕捉することで、
         * 想定外のあらゆる異常を最終的に受け止める
         */
        return '失敗: ' . get_class($e) . ' - ' . $e->getMessage();
    }
}

echo safeExecute(fn () => unpredictableOperation(2)) . PHP_EOL;

例6:Union型によるまとめた捕捉と個別捕捉の使い分け

<?php

function validateUser(array $data): void
{
    if (!isset($data['email'])) {
        throw new \InvalidArgumentException('emailが必要です');
    }
    if (!isset($data['age'])) {
        throw new \OutOfRangeException('ageが必要です');
    }
}

try {
    validateUser(['email' => 'test@example.com']);
} catch (\InvalidArgumentException | \OutOfRangeException $e) {
    // 複数の型を1つのcatchでまとめて同じ処理をしたい場合に有効
    echo '入力検証エラー: ' . $e->getMessage() . PHP_EOL;
}

例7:変数なしcatchを使ったシンプルなフォールバック処理

<?php

function loadFromCache(string $key): ?string
{
    throw new \RuntimeException('キャッシュサーバーに接続できません');
}

function getValue(string $key): string
{
    try {
        return loadFromCache($key) ?? 'デフォルト値';
    } catch (\RuntimeException) {
        // 詳細なエラー情報が不要な場合、変数を省略してシンプルに書ける
        return 'キャッシュ取得失敗時のフォールバック値';
    }
}

echo getValue('user:1') . PHP_EOL;

関連機能との比較

機能役割catchとの違い
catch発生した例外を型で捕捉し、処理する本記事の対象。tryブロックと組み合わせて使う
try例外が発生する可能性のある処理を区切るcatchが動作する前提となる構文(前回記事を参照)
finally例外の有無に関わらず必ず実行される処理catchとは異なり、例外を捕捉する役割は持たない
throw例外を発生させるcatchが捕捉する対象を生成する側の構文
set_exception_handler()未処理の例外に対するグローバルなハンドラを設定個別のtry–catchを書かなかった場合の、最終的な受け皿として機能する

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

  1. 継承関係を考慮したcatchの順序 親クラス(より一般的な型)を先に catch してしまうと、その後に書いた子クラス(より具体的な型)の catch は永遠に実行されません。必ず、より具体的なクラスから先に並べましょう(例3を参照)。
  2. ExceptionとErrorの違いを意識する PHP 7以降、プログラムの構造的な問題(型エラー、未定義メソッド呼び出しなど)は Exception ではなく Error のサブクラスとしてスローされます。catch (\Exception $e) だけを書いていると、こうした Error 系の問題を捕捉できません。両方を確実に捕捉したい場合は、共通の親インターフェースである \Throwable を使いましょう(例4・例5を参照)。
  3. すべての例外を無差別に\Throwableで捕捉しすぎない catch (\Throwable $e) はあらゆる異常を受け止められる強力な手段ですが、本来は個別に対処すべき特定のエラーまで一緒くたに扱ってしまうと、適切なエラーハンドリング(リトライ、ユーザーへの個別案内など)の機会を失うことがあります。用途に応じて、具体的な型での捕捉と組み合わせましょう(例5のような「最終防衛ライン」としての利用に限定するのが望ましい場合もあります)。
  4. 捕捉した例外を握りつぶさない catch (\Exception $e) {} のように中身が空のブロックを書いてしまうと、問題が発生した事実そのものが失われ、デバッグが著しく困難になります。最低限、ログへの記録を行うことが推奨されます。
  5. Union型構文とそれぞれ個別のcatchとの判断 catch (TypeA | TypeB $e) で複数の型をまとめて同じ処理をする場合と、型ごとに個別の catch ブロックで異なる処理をする場合とでは、設計上の意図が異なります。それぞれの例外に対して本当に同じ対処でよいかを見極めて使い分けましょう(例6を参照)。

まとめ

観点まとめ
何をする構文かtryブロック内で発生した例外のうち、指定した型に一致するものを捕捉し処理する
主な用途特定の異常系に応じた個別の対応、ログ記録、ユーザーへのエラーメッセージ表示
型マッチングの仕組み継承関係を考慮し、上から順に最初に一致したブロックのみが実行される
ExceptionとErrorPHP 7以降、プログラム構造上の問題はError系として分離されている
注意点catchの順序、\Throwableの無差別な多用への注意、例外の握りつぶし

catch は、throw された例外を適切な型で受け止め、状況に応じた回復処理を行うための要となる構文です。Exception と Error の違いや継承関係を正しく理解し、具体的な型から順に catch を並べることで、意図通りに機能する堅牢なエラーハンドリングを実現できます。

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