PHPの例外スロー（throw）徹底解説！ErrorとExceptionの基本からSPL例外まで

はじめに

PHPでは、ThrowableインターフェースがErrorクラスとExceptionクラスによって実装されています。すべての定義済みErrorクラスはErrorクラスを継承しており、tryブロック内で対応する例外インスタンスが投げられると、適切なcatchブロックで処理されます。

この仕組みにより、予期しないエラーが発生した場合でもプログラムを強制終了させず、柔軟にエラーハンドリングを行うことが可能になります。

例外のスロー（throw）の基本動作

tryブロック内で例外が発生しなかった場合、プログラムは最後のcatchブロックの後に定義されたコードからそのまま実行を継続します。一方、例外が投げられた場合は制御がcatchブロックへ移り、エラー処理を実行した後もスクリプト自体は引き続き動作します。

サンプル：Exceptionをスローしてキャッチする

以下の例では、ゼロ除算が発生しようとしたタイミングでExceptionをthrowし、catchブロックでメッセージを表示しています。

<?php
function div($x, $y) {
    if (!$y) {
        throw new Exception('Division by zero.');
    }
return $x/$y;
}
try {
    echo div(10,5) . "\n";
    echo div(10,0) . "\n";
} catch (Exception $e) {
    echo 'Caught exception: ', $e->getMessage(), "\n";
}
// 処理はここから継続
echo "Execution continues\n";
?>

出力結果

2
Caught exception: Division by zero.
Execution continues

注目すべきは、例外を捕捉した後も「Execution continues」が出力されている点です。つまり、例外処理を適切に行えば、エラー発生後もプログラムの実行を止めることなく継続できるのです。

サンプル：TypeErrorをキャッチする

次の例では、関数に想定外の型の引数が渡されたため、実行時にTypeErrorがスローされます。これにより、対応するエラーメッセージが表示されます。

<?php
function add(int $num1, int $num2){
    return $num1 + $num2;
}
try {
    $value = add(1, 'one');
} catch (TypeError $e) {
    echo $e->getMessage(). "\n";
}
?>

出力結果

Argument 2 passed to add() must be of the type integer, string given

型宣言を持つ関数に不正な型の値を渡すと、PHPは自動的にTypeErrorをスローします。このように、throw文を使わなくてもPHP内部で例外が発生するケースがあることを覚えておきましょう。

SPL定義済み例外の一覧

標準PHPライブラリ（SPL）には、目的別にあらかじめ定義された例外クラスが多数用意されています。代表的な例外は以下の通りです。

これらのSPL例外を適切に使い分けることで、「ロジック上のミス」なのか「実行環境由来の問題」なのかを明確に区別でき、より保守性の高いコードを書くことができます。

サンプル：OutOfBoundsExceptionをスローする

以下は、PHP配列に存在しないキーを参照した際にOutOfBoundsExceptionをスローする実用例です。

<?php
$arr=array("one"=>1, "two"=>2,"three"=>3,"four"=>4);
$key="ten";
try{
    if (array_key_exists($key, $arr)==FALSE){
        throw new OutOfBoundsException("key not found");}
    else {
        echo $arr[$key];}
    }
    catch (OutOfBoundsException $e){
        echo $e->getMessage(). "\n";
}
?>

出力結果

key not found

array_key_exists()関数でキーの存在を確認し、見つからない場合にはOutOfBoundsExceptionを明示的に投げています。このように状況に応じて最適な例外クラスを選択することが、堅牢なPHPアプリケーション開発のポイントです。