[PHP]tryとは?例外を捕捉して安全に処理を継続する方法を徹底解説

PHP

はじめに

前回の記事では、異常事態を例外として発生させる throw を解説し、その中で「throw された例外は、対応する catch ブロックが見つかるまで呼び出し階層を遡る」という仕組みに触れました。今回取り上げる try は、その catch と対になる、例外が発生する可能性のあるコードを明示的に区切るための構文です。

try ブロックの中で例外が発生すると、処理はその場で中断され、対応する catch ブロックへと制御が移ります。この try–catch の組み合わせにより、「失敗するかもしれない処理」を安全に実行し、失敗した場合でもアプリケーション全体をクラッシュさせることなく、適切なエラーハンドリングを行えます。さらに finally ブロックと組み合わせることで、成功・失敗に関わらず必ず実行したい後処理も表現できます。本記事では基本的な使い方から、実践的な活用パターンまで詳しく解説します。


構文概要

項目内容
構文名try
種別制御構造(catch/finallyと組み合わせて使用)
基本構文try { ... } catch (ExceptionType $e) { ... } finally { ... }
catchの複数指定1つのtryに対して複数のcatchブロックを並べられる
finally省略可能。例外の有無に関わらず必ず実行される
単独での使用不可(必ずcatchまたはfinallyのいずれかを伴う必要がある)
対応バージョンPHP 5.0以降(finallyはPHP 5.5以降)

try-catch-finallyの流れ(イメージ図)

  try {
      riskyOperation();   ← 例外が発生する可能性のある処理
  } catch (SpecificException $e) {
      // SpecificExceptionが発生した場合の処理
  } catch (\Exception $e) {
      // それ以外の一般的な例外の処理
  } finally {
      // 例外の有無に関わらず、必ず実行される後処理
  }
              │
              ▼
  ┌───────────────────────────┐
  │ tryブロック内で例外が発生すると、          │
  │ 残りのtry内の処理はスキップされ、          │
  │ 一致する最初のcatchブロックが実行される     │
  │ その後、finallyが(あれば)必ず実行される    │
  └───────────────────────────┘

ポイントは、catch ブロックが上から順番にチェックされ、発生した例外の型に一致する最初のブロックだけが実行されるという点です。複数の catch を書く場合は、より具体的な例外クラスを先に、より一般的な例外クラスを後に書くのが基本です。


実践サンプル7選

例1:基本的な使い方

<?php

function parseNumber(string $input): int
{
    if (!is_numeric($input)) {
        throw new InvalidArgumentException("'{$input}'は数値ではありません");
    }
    return (int) $input;
}

try {
    echo parseNumber('abc') . PHP_EOL;
} catch (InvalidArgumentException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例2:複数の例外型を個別にハンドリングする

<?php

function fetchResource(string $id): string
{
    if ($id === '') {
        throw new InvalidArgumentException('IDが空です');
    }
    if ($id === '404') {
        throw new RuntimeException('リソースが見つかりません');
    }
    return "リソース{$id}のデータ";
}

function handleRequest(string $id): void
{
    try {
        echo fetchResource($id) . PHP_EOL;
    } catch (InvalidArgumentException $e) {
        // より具体的な例外は先に書く
        echo '入力エラー: ' . $e->getMessage() . PHP_EOL;
    } catch (RuntimeException $e) {
        echo '実行時エラー: ' . $e->getMessage() . PHP_EOL;
    }
}

handleRequest('404');
handleRequest('');

例3:finallyを使った確実なリソース解放

<?php

class FileProcessor
{
    public function process(string $path): void
    {
        $handle = fopen($path, 'r');

        try {
            if ($handle === false) {
                throw new RuntimeException('ファイルを開けませんでした');
            }
            echo 'ファイル処理を実行中...' . PHP_EOL;
            // 何らかの処理中に例外が発生する可能性がある
        } finally {
            /**
             * 例外が発生してもしなくても、
             * finallyブロックでファイルハンドルを確実に閉じる
             */
            if (is_resource($handle)) {
                fclose($handle);
                echo 'ファイルハンドルを閉じました' . PHP_EOL;
            }
        }
    }
}

(new FileProcessor())->process(__FILE__);

例4:PHP 8.0以降の「変数なしcatch」構文

<?php

function checkFeatureFlag(bool $enabled): string
{
    if (!$enabled) {
        throw new RuntimeException('機能が無効です');
    }
    return '機能が有効です';
}

try {
    echo checkFeatureFlag(false) . PHP_EOL;
} catch (RuntimeException) {
    /**
     * PHP 8.0以降、例外オブジェクトの詳細が不要な場合、
     * 変数名($e)を省略してcatchできる
     */
    echo '機能フラグの確認中にエラーが発生しました' . PHP_EOL;
}

例5:複数の例外型を1つのcatchでまとめて扱うUnion構文

<?php

function performOperation(int $type): string
{
    if ($type === 1) {
        throw new InvalidArgumentException('不正な引数です');
    }
    if ($type === 2) {
        throw new RuntimeException('実行時エラーです');
    }
    return '成功';
}

try {
    echo performOperation(2) . PHP_EOL;
} catch (InvalidArgumentException | RuntimeException $e) {
    // "|"で区切ることで、複数の型を1つのcatchブロックでまとめて処理できる(PHP 7.1以降)
    echo '既知のエラー: ' . get_class($e) . ' - ' . $e->getMessage() . PHP_EOL;
}

例6:ネストしたtry–catchによる段階的なエラーハンドリング

<?php

function connectToPrimaryServer(): never
{
    throw new RuntimeException('プライマリサーバーへの接続に失敗しました');
}

function connectToBackupServer(): string
{
    return 'バックアップサーバーに接続しました';
}

try {
    try {
        connectToPrimaryServer();
    } catch (RuntimeException $e) {
        echo "プライマリ失敗({$e->getMessage()})。バックアップを試みます..." . PHP_EOL;
        echo connectToBackupServer() . PHP_EOL;
    }
} catch (\Throwable $e) {
    echo '両方の接続試行が失敗しました: ' . $e->getMessage() . PHP_EOL;
}

例7:値を返すtry–finallyの組み合わせでの注意点

<?php

function demonstrateFinallyBehavior(): string
{
    try {
        return 'tryからの戻り値';
    } finally {
        /**
         * finallyはtryのreturnの後でも必ず実行される
         * (ただし、finally内でreturnすると、tryの戻り値は上書きされてしまう)
         */
        echo 'finallyブロックが実行されました(returnの直前に割り込む)' . PHP_EOL;
    }
}

echo demonstrateFinallyBehavior() . PHP_EOL;

関連機能との比較

機能役割tryとの違い
try例外が発生する可能性のある処理を区切る本記事の対象。catchやfinallyとの組み合わせが前提
catch発生した例外を捕捉し、処理するtryブロックの実行結果(例外の有無)に応じて実行される
finally例外の有無に関わらず必ず実行される処理後処理やリソース解放など、確実な実行が必要な処理に使う
throw例外を発生させるtryブロック内、あるいはそれより深い呼び出し先で使われる(別記事で解説済み)
エラー抑制演算子(@)エラーを発生させずに警告を抑制する構造化された例外処理ではなく、警告を単に握りつぶすだけの古い手法

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

  1. catchの順序は具体的なものから一般的なものへ より一般的な例外クラス(\Exceptionなど)を先に書いてしまうと、それ以降により具体的な例外型の catch を書いても、決して実行されることはありません(PHPはこの場合、多くは静的解析で警告してくれます)。必ず具体的な型から順に並べましょう(例2を参照)。
  2. finally内のreturnはtryの戻り値を上書きしてしまう finally ブロック内で明示的に return を書くと、try や catch ブロックで既に決まっていた戻り値が上書きされてしまいます。これは意図しないバグの原因になりやすいため、finally 内では基本的に return を使わない設計が推奨されます(例7を参照)。
  3. try単独では使えず、catchまたはfinallyが必須 try { ... } だけを書いて catch も finally も付けないと、構文エラーになります。少なくともどちらか一方は必要です。
  4. キャッチした例外を握りつぶしてしまう catch (\Exception $e) {} のように、キャッチした例外に対して何も処理をしない(空のブロック)と、問題が発生したという事実そのものが握りつぶされ、デバッグが困難になります。最低限、ログに記録するなどの対応が望ましいです。
  5. Union型(|)構文はPHP 7.1以降でのみ使用可能 複数の例外型を1つの catch でまとめて扱う catch (TypeA | TypeB $e) という構文は、PHP 7.1で導入されたものです。それより古いバージョンでは、個別に catch ブロックを分ける必要があります(例5を参照)。

まとめ

観点まとめ
何をする構文か例外が発生する可能性のある処理を区切り、catch/finallyと組み合わせて安全に扱う
主な用途外部APIやファイル操作など、失敗しうる処理の安全な実行とエラーハンドリング
catchの順序具体的な例外クラスから、一般的なクラスへの順で並べる
finallyの役割例外の有無に関わらず、リソース解放などの後処理を確実に実行する
注意点finally内のreturnによる戻り値の上書き、例外を握りつぶさないこと、構文の対応バージョン

try は、PHPにおける構造化された例外処理の入り口であり、catch・finally と組み合わせることで、失敗する可能性のある処理を安全に実行し、適切に回復させるための強力な枠組みを提供します。throw と合わせて正しく理解することで、堅牢でエラーに強いアプリケーション設計が可能になります。

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