例外処理

エラーを if の戻り値ではなく 「例外オブジェクトを投げて、別の場所で拾う」 という構造で扱うトピック。

このトピックで身につくこと

• try / catch / finally を組み合わせてエラー処理を書ける
• throw new Exception(...) で自分の関数から例外を投げられる
• 例外の種類で処理を分岐できる
• カスタム例外クラスで「意味のあるエラー」を表現できる
• 「戻り値で false を返す」設計と「例外を投げる」設計を使い分けられる

前提知識の要点

このトピックは 「クラスが書ける」「関数が書ける」 の 2 点があれば始められる。さらに 1 つだけ重要な前提として 「Exception はクラスである」「new Exception() でインスタンスを作る」「throw は文 (式ではない)」 を押さえる。他のトピックの README を読み返さずに exception を単独で開始できる ように、以下を圧縮しておく。

1. クラスと new

<?php
class User {
    public function __construct(public string $name) {}
    public function greet(): string {
        return "こんにちは、{$this->name}";
    }
}

$u = new User("太郎");
echo $u->greet();  // => こんにちは、太郎

このトピックで扱う Exception も「PHP に最初から組み込まれているクラスの 1 つ」というだけ。書き方は上と同じ。

2. 関数の引数・戻り値

function divide(int $a, int $b): int {
    return intdiv($a, $b);
}

このトピックでは「この関数は不正な入力のとき何を返す?」の答えとして「例外を投げる」を学ぶ。

3. これだけは新しく覚える: Exception はクラス・throw は文

// new でインスタンスを作る (普通のクラスと同じ)
$e = new Exception("失敗しました");

// throw でその例外を「投げる」(これ以降の行は実行されない)
throw $e;

// 1 行で書くのが普通
throw new Exception("失敗しました");

重要なのは:

• Exception はクラス。new でインスタンス化する
• throw はそのインスタンスを投げる文。投げられた瞬間、関数の途中でも実行が止まる
• 投げられた例外は、呼び出し元の try { ... } catch { ... } で拾える
• 誰も拾わないと Uncaught Exception でプログラムが落ちる

継承は必須ではない

ch06 (カスタム例外) で extends Exception が出てくるが、「Exception クラスを継承して、独自の名前の例外を作る」というだけの使い方なので、class-advanced を完了していなくても ch06 直前の slide.md を読めば追いつける。

ここまで読めれば ch01 から始められる。

chapter 一覧

合計 8 chapter / 7 drill (ch07 は概念説明のみ・drill なし) / 所要 3〜4 時間 程度。try / catch の動きは概念より「書いて動かす」が早い。

進め方

1. 各 chapter の slide.md を読む (3〜5 分)
2. drill/ 配下の問題を順番に解く (ch07 は読むだけ)
3. 採点: php scripts/grade.php topics/exception/<chapter>/drill/<drill>/

つまづきポイント

関連トピック

トピックを並列で参照する全体地図は TOPICS_INDEX.md にある。

案件 (dojo_map.tsv) での参照

topic_slug    chapter_dir
exception     topics/exception/ch01-try-catch
exception     topics/exception/ch02-throw
exception     topics/exception/ch06-custom-exception
...

slug exception で参照可。10-exception / exception どちらの path でもアクセスできる (シンボリックリンク)。