PHPのthrow文を使った例外処理の基本について解説

<?php
// サンプル関数：入力値が負の数の場合、例外を発生させる
function checkValue($value) {
    if ($value < 0) {
        // 例外メッセージは日本語で記述
        throw new Exception("エラー：値は負の数です");
    }
    return "値は正しく処理されています";
}
// 正常な処理の場合
try {
    $result = checkValue(10);
    echo $result;
} catch (Exception $e) {
    echo "例外が発生しました: " . $e->getMessage();
}
?>

値は正しく処理されています

<?php
function validateInput($input) {
    if (empty($input)) {
        // メッセージ内に具体的な説明を含める
        throw new Exception("入力エラー：値が空です");
    }
    return "入力値は有効です";
}
try {
    echo validateInput("");
} catch (Exception $ex) {
    echo "捕捉された例外: " . $ex->getMessage();
}
?>

捕捉された例外: 入力エラー：値が空です

<?php
try {
    // 例外を発生させる関数の呼び出し
    $result = checkValue(-5);
    echo $result;
} catch (Exception $e) {
    // 例外が発生すると、このブロック内の処理が実行される
    echo "例外発生: " . $e->getMessage();
}
?>

例外発生: エラー：値は負の数です

<?php
try {
    // 関数内での例外投げをキャッチする
    validateInput("");
} catch (Exception $error) {
    // 捕捉した例外オブジェクトからメッセージを取得して表示
    echo "捕捉されたエラー: " . $error->getMessage();
}
?>

捕捉されたエラー: 入力エラー：値が空です

<?php
try {
    // 例外を発生させる状況の模擬
    $data = checkValue(-1);
    echo $data;
} catch (Exception $e) {
    echo "エラー発生: " . $e->getMessage();
} finally {
    // 必ず実行される後処理
    echo "\nリソースの開放処理完了";
}
?>

エラー発生: エラー：値は負の数です
リソースの開放処理完了

<?php
// CustomExceptionクラスは標準のExceptionクラスを継承する
class CustomException extends Exception {
    // コンストラクタで例外メッセージを初期化する
    public function __construct($message) {
        parent::__construct($message);
    }
}
// サンプル関数：特定の条件下でCustomExceptionを投げる
function processData($input) {
    if ($input === "error") {
        throw new CustomException("入力エラー：不正な値が渡されました");
    }
    return "正常に処理されました";
}
try {
    echo processData("error");
} catch (CustomException $ce) {
    echo "カスタム例外捕捉: " . $ce->getMessage();
}
?>

カスタム例外捕捉: 入力エラー：不正な値が渡されました

<?php
// AdvancedExceptionクラスは、エラーコードを保持するプロパティを追加している
class AdvancedException extends Exception {
    private $errorCode;
    public function __construct($message, $errorCode) {
        parent::__construct($message);
        $this->errorCode = $errorCode;
    }
    // エラーコードを取得するメソッド
    public function getErrorCode() {
        return $this->errorCode;
    }
}
try {
    // エラーコード123でAdvancedExceptionを投げる
    throw new AdvancedException("詳細なエラーが発生しました", 123);
} catch (AdvancedException $ae) {
    echo "エラーコード: " . $ae->getErrorCode() . "\n";
    echo "例外メッセージ: " . $ae->getMessage();
}
?>

エラーコード: 123
例外メッセージ: 詳細なエラーが発生しました

<?php
// 独自例外であるValidationExceptionを定義
class ValidationException extends Exception {
    public function __construct($message) {
        parent::__construct($message);
    }
}
function validateData($data) {
    // データが不正な場合、独自例外を発生させる
    if ($data !== "valid") {
        throw new ValidationException("データ検証エラー：無効な入力です");
    }
    return "データ検証成功";
}
try {
    echo validateData("invalid");
} catch (ValidationException $ve) {
    echo "検証失敗: " . $ve->getMessage();
}
?>

検証失敗: データ検証エラー：無効な入力です

<?php
try {
    // サンプル関数で例外を発生させる
    validateInput("");
} catch (Exception $e) {
    // エラートレースを文字列として取得し、出力する
    $traceInfo = print_r($e->getTrace(), true);
    echo "エラートレース:\n" . $traceInfo;
}
?>

エラートレース:
Array
(
    [0] => Array
        (
            [file] => /path/to/script.php
            [line] => 3
            [function] => validateInput
            [args] => Array
                (
                    [0] =>
                )
        )
)

<?php
// 開発環境用のエラーレポートを有効にする設定
error_reporting(E_ALL);
ini_set('display_errors', 1);
try {
    // サンプルの関数呼び出し
    processData("error");
} catch (Exception $e) {
    // エラーメッセージとともにエラートレースを出力
    echo "例外内容: " . $e->getMessage() . "\n";
    echo "トレース情報:\n" . print_r($e->getTrace(), true);
}
?>

例外内容: 入力エラー：不正な値が渡されました
トレース情報:
Array
(
    [0] => Array
        (
            [file] => /path/to/script.php
            [line] => 6
            [function] => processData
            [args] => Array
                (
                    [0] => error
                )
        )
)