[PHP]finallyとは?例外の有無に関わらず必ず実行される処理を徹底解説

PHP

はじめに

これまでの記事で、例外処理の三本柱である try(区切り)と catch(捕捉)を解説してきました。今回取り上げる finally は、この2つを締めくくる最後のピースで、例外が発生したかどうかに関わらず、必ず実行される処理を記述するための構文です。

ファイルハンドルやデータベース接続のクローズ、ロックの解放、一時リソースの削除など、「成功しても失敗しても、絶対に行わなければならない後片付け」を表現するために使われます。finally は、try の処理が正常に完了した場合、例外が catch で捕捉された場合、さらには return や break でブロックを抜けようとした場合でさえも、その実行を妨げることなく確実に動作する、信頼性の高い仕組みです。本記事では基本的な使い方から、return との相互作用という重要な注意点まで詳しく解説します。


構文概要

項目内容
構文名finally
種別制御構造(try/catchと組み合わせて使用)
基本構文try { ... } catch (...) { ... } finally { ... }
catchの省略try { ... } finally { ... } のようにcatchなしでも使用可能
実行タイミングtry/catchブロックの処理が完了した直後、関数を抜ける直前に必ず実行される
対応バージョンPHP 5.5.0以降
例外の有無例外が発生してもしなくても、必ず実行される

finallyが実行されるタイミング(イメージ図)

  function example() {
      try {
          return 'A';      // ①
      } catch (\Exception $e) {
          return 'B';      // ②
      } finally {
          echo 'finallyが実行されました';  // ★必ずここが実行される
      }
  }
  実行パターン1(例外なし):
  try内の処理 → ①のreturnが評価される → finallyが実行される → 関数全体が'A'を返す

  実行パターン2(例外発生、catchで捕捉):
  try内で例外発生 → catchへ移動 → ②のreturnが評価される
  → finallyが実行される → 関数全体が'B'を返す

ポイントは、finally が**return によって関数を抜けようとしている「まさにその瞬間」にも割り込んで実行される**という点です。これは break や continue でループやブロックを抜けようとする場合も同様です。


実践サンプル7選

例1:基本的な使い方

<?php

function demonstrateFinally(bool $shouldFail): string
{
    try {
        if ($shouldFail) {
            throw new \RuntimeException('失敗しました');
        }
        return '成功しました';
    } catch (\RuntimeException $e) {
        return 'エラー処理: ' . $e->getMessage();
    } finally {
        echo '[finally] クリーンアップ処理を実行' . PHP_EOL;
    }
}

echo demonstrateFinally(false) . PHP_EOL;
echo demonstrateFinally(true) . PHP_EOL;

例2:データベース接続の確実なクローズ

<?php

class DatabaseSession
{
    public function __construct(private \PDO $connection)
    {
    }

    public function executeTransaction(callable $operations): void
    {
        $this->connection->beginTransaction();

        try {
            $operations($this->connection);
            $this->connection->commit();
        } catch (\Throwable $e) {
            $this->connection->rollBack();
            throw $e; // ロールバック後、呼び出し元にエラーを伝播させる
        } finally {
            /**
             * トランザクションの成否に関わらず、
             * セッションの後処理(ログ記録など)を確実に行う
             */
            echo 'トランザクション処理が終了しました' . PHP_EOL;
        }
    }
}

例3:catchを伴わないtry–finally

<?php

function processWithoutCatch(): string
{
    /**
     * catchを省略し、finallyだけを使うことで、
     * 「例外はこの関数内では処理しないが、
     * 後片付けだけは確実に行いたい」という意図を表現できる
     */
    try {
        return '処理結果';
    } finally {
        echo 'リソースを解放しました' . PHP_EOL;
    }
}

echo processWithoutCatch() . PHP_EOL;

例4:finally内でのreturnが引き起こす戻り値の上書き問題

<?php

function dangerousFinally(): string
{
    try {
        return 'tryからの値';
    } finally {
        /**
         * 注意: finally内でreturnすると、
         * tryやcatchで決まっていた戻り値が完全に上書きされてしまう
         * (多くのコーディング規約で、finally内のreturnは禁止・非推奨とされる)
         */
        return 'finallyからの値(これが優先される)';
    }
}

echo dangerousFinally() . PHP_EOL; // "finallyからの値(これが優先される)"

例5:ロックの確実な解放パターン

<?php

class ResourceLock
{
    private bool $locked = false;

    public function acquire(): void
    {
        $this->locked = true;
        echo 'ロックを取得しました' . PHP_EOL;
    }

    public function release(): void
    {
        $this->locked = false;
        echo 'ロックを解放しました' . PHP_EOL;
    }
}

function performLockedOperation(ResourceLock $lock, bool $shouldFail): void
{
    $lock->acquire();

    try {
        if ($shouldFail) {
            throw new \RuntimeException('処理中にエラーが発生');
        }
        echo '処理を実行中...' . PHP_EOL;
    } finally {
        // 処理が成功しても失敗しても、確実にロックを解放する
        $lock->release();
    }
}

try {
    performLockedOperation(new ResourceLock(), true);
} catch (\RuntimeException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例6:ループ内でのbreakとfinallyの相互作用

<?php

function processItemsWithEarlyExit(array $items): void
{
    foreach ($items as $item) {
        try {
            if ($item === 'STOP') {
                echo '停止シグナルを検出' . PHP_EOL;
                break; // ループを抜けようとしても、finallyは実行される
            }
            echo "処理中: {$item}" . PHP_EOL;
        } finally {
            echo "  [finally] {$item}の後処理" . PHP_EOL;
        }
    }
}

processItemsWithEarlyExit(['A', 'B', 'STOP', 'C']);

例7:計測処理をfinallyで確実に記録する

<?php

class PerformanceLogger
{
    public function measure(callable $operation): mixed
    {
        $start = microtime(true);

        try {
            return $operation();
        } finally {
            /**
             * 処理が成功しても例外で失敗しても、
             * 必ず実行時間を記録する
             */
            $elapsed = round((microtime(true) - $start) * 1000, 2);
            echo "処理時間: {$elapsed}ms" . PHP_EOL;
        }
    }
}

$logger = new PerformanceLogger();
$logger->measure(function () {
    usleep(30000);
    return '完了';
});

関連機能との比較

機能役割finallyとの違い
finally例外の有無に関わらず必ず実行される本記事の対象。例外を捕捉する機能は持たない
catch発生した例外を型で捕捉し処理する例外がなければ実行されない点がfinallyと異なる(別記事で解説済み)
try例外が発生する可能性のある処理を区切るcatch/finallyいずれかと組み合わせる必要がある前提の構文
__destruct()オブジェクトが破棄される際に自動実行される呼び出しタイミングが不確実であり、finallyほど予測可能ではない
register_shutdown_function()スクリプト終了時に実行する関数を登録関数やブロック単位ではなく、スクリプト全体の終了時処理を対象とする

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

  1. finally内でのreturnは、それより前の戻り値を上書きしてしまう これが finally に関する最も重要な注意点です。try や catch で既に決定していた戻り値があっても、finally 内で明示的に return すると、そちらが優先されてしまいます(例4を参照)。多くのコーディング規約やLintツールが、この挙動を避けるために finally 内での return を禁止・警告しています。
  2. catchなしでも単独でtry–finallyとして使える finally は必ず catch とセットである必要はなく、例外のハンドリングをその場では行わず、呼び出し元に委ねたい(あるいは例外自体を発生させない)が、後処理だけは確実に行いたいという場合に、try–finallyのみの組み合わせが有効です(例3を参照)。
  3. break/continueでループを抜ける場合もfinallyは実行される ループの中に try–finally がある場合、break や continue によってそのイテレーションを抜けようとしても、finally ブロックは必ず実行されてから処理が進みます(例6を参照)。
  4. finallyの中で例外を再スローすると、元の例外情報が失われる可能性がある finally ブロック内で新たな例外をスローすると、もし try や catch で既に例外が発生していた場合、その元の例外は(コンテキストとして明示的にチェーンしない限り)失われてしまうことがあります。finally 内の処理はできるだけ、例外を発生させない安全な後処理にとどめるのが望ましいです。
  5. 過度に複雑な処理をfinallyに詰め込まない finally は「必ず実行される」という特性上、ここに複雑なロジックを書きすぎると、コードの流れ全体が追いにくくなります。本来の目的である「リソースの解放」「ログの記録」など、シンプルな後処理にとどめることが推奨されます。

まとめ

観点まとめ
何をする構文かtry/catchブロックの実行結果に関わらず、必ず実行される処理を定義する
主な用途ファイル・DB接続のクローズ、ロックの解放、処理時間の計測、後片付け全般
catchとの関係catchを伴わないtry–finallyのみの組み合わせも可能
最重要の注意点finally内でのreturnが、それ以前の戻り値を上書きしてしまうこと
対応バージョンPHP 5.5.0以降

finally は、try–catch と組み合わせることで、「何があっても必ず実行したい処理」を確実に表現できる、信頼性の高い仕組みです。リソース管理やロック解放といった、見落とすと深刻な問題につながる後処理には積極的に活用する一方、return による戻り値の上書きという落とし穴には十分注意しましょう。これで try・catch・finally という例外処理の三本柱がすべて出揃いました。

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