はじめに
これまでの記事で、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() | 前提条件が満たされているかを検証する | 本番環境では無効化されることが多く、デバッグ・開発時の検証が主目的 |
よくある落とし穴(注意点)
throwした例外を誰もcatchしないと致命的エラーになる 対応するtry–catchブロックが呼び出し階層のどこにも存在しない場合、例外は「未処理の例外(Uncaught Exception)」として致命的エラーを引き起こし、スクリプトが停止します。重要な処理では、適切な階層でcatchを用意しておくことが必要です。ExceptionとErrorの違いを理解する PHP 7以降、throwできるのはThrowableインターフェースを実装したクラスであり、プログラマが意図的に発生させるException系と、言語内部の致命的な問題を表すError系(TypeError、DivisionByZeroErrorなど)の両方が含まれます。これらを区別してcatchすることで、より的確なエラーハンドリングが可能になります。- 例外の多用がパフォーマンスに影響する可能性 例外のスローとキャッチには、通常の条件分岐に比べてわずかなオーバーヘッドがあります。頻繁に発生することが予想される「通常のフロー制御」のために例外を多用するのは、設計として適切でない場合があります。例外は、文字通り「例外的な」状況のために使うのが基本です。
- 再スロー時に元の例外情報を失わないようにする 例外をキャッチして別の例外として再スローする際、第3引数(
$previous)に元の例外を渡し忘れると、エラーの根本原因(スタックトレース)の情報が失われてしまいます。デバッグのしやすさを保つため、再スロー時はチェーン化を徹底しましょう(例6を参照)。 - 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 と組み合わせることで、異常事態をコードの流れの中で明確に、かつ柔軟に扱うことができます。
