グローバルな例外ハンドラ

set_exception_handler() を使うと、 キャッチされないあらゆる Throwable を処理するハンドラを設定できます。 これはコード全体を try-catch ブロックで囲むのと似ていますが、 その後に実行が再開されない点が異なります。 ハンドラから処理が戻った時点で、スクリプトは終了します。

例外を拡張する

ユーザー定義の例外は、組み込みの Exception クラスを拡張して定義できます。

組み込みの Exception クラスを拡張したクラスで コンストラクタを再定義する場合、 利用可能なすべてのデータが正しく代入されるように、 parent::__construct() もコールすることを強く推奨します。 __toString() メソッドをオーバーライドすると、 オブジェクトが文字列として使われたときの出力を独自に定義できます。

<?php
class CustomException extends Exception
{
    // コンストラクタを再定義し、メッセージを必須にする
    public function __construct($message, $code = 0, ?Throwable $previous = null) {
        // 何らかのコード

        // すべてを正しく確実に代入する
        parent::__construct($message, $code, $previous);
    }

    // オブジェクトの文字列表現を独自に定義する
    public function __toString() {
        return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
    }

    public function customFunction() {
        echo "A custom function for this type of exception\n";
    }
}

try {
    throw new CustomException("Something happened", 5);
} catch (CustomException $e) {
    echo "Caught custom exception\n", $e;
    $e->customFunction();
}

Caught custom exception
CustomException: [5]: Something happened
A custom function for this type of exception

Throwable の階層

• Throwable

  • Error

    • ArithmeticError

      • DivisionByZeroError

    • AssertionError

    • CompileError

      • ParseError

    • TypeError

      • ArgumentCountError

    • ValueError

    • UnhandledMatchError

    • FiberError

  • Exception

Exception クラスには多くのサブクラスがあり、 その中には SPL の例外や、 拡張モジュールが定義する例外が含まれます。