【PHP8.x】getMessageメソッドの使い方

Copy
1<?php
2
3/**
4 * PHPの標準Exceptionクラスを継承するカスタム例外クラスの例です。
5 * これにより、アプリケーション固有のエラーをより明確に区別できます。
6 */
7class MyCustomValidationException extends Exception
8{
9    /**
10     * カスタム例外のコンストラクタ。
11     * 親クラスのコンストラクタを呼び出し、カスタムメッセージを設定します。
12     *
13     * @param string $message 例外メッセージ
14     * @param int $code 例外コード
15     * @param Throwable|null $previous 前の例外 (チェイニング用)
16     */
17    public function __construct(string $message = "不明なバリデーションエラー", int $code = 0, ?Throwable $previous = null)
18    {
19        // 親クラスのコンストラクタを呼び出し、例外の基本情報を設定します。
20        // ここで設定されたメッセージは、後で getMessage() メソッドで取得されます。
21        parent::__construct($message, $code, $previous);
22    }
23}
24
25/**
26 * 特定の条件でカスタム例外をスローする関数。
27 * 開発者が例外メッセージをどのように設定し、それがgetMessage()で取得されるかを示します。
28 *
29 * @param string $value 検証対象の値
30 * @throws MyCustomValidationException 値が無効な場合にスローされます。
31 * @return string 検証が成功した場合のメッセージ。
32 */
33function validateInput(string $value): string
34{
35    // 例: 特定の文字列が入力された場合にエラーとする
36    if ($value === "invalid") {
37        // カスタム例外を新しいメッセージと共にスローします。
38        // このメッセージが、後続の catch ブロックで getMessage() によって取得される内容になります。
39        throw new MyCustomValidationException("入力値が不正です: '{$value}'", 400);
40    }
41    return "入力値 '{$value}' は有効です。";
42}
43
44// 例外処理のデモンストレーション
45try {
46    // 正常なケース: 例外はスローされない
47    echo validateInput("valid_data") . PHP_EOL;
48
49    // エラーケース: MyCustomValidationException がスローされる
50    echo validateInput("invalid") . PHP_EOL;
51} catch (MyCustomValidationException $e) {
52    // MyCustomValidationException がキャッチされた場合の処理
53    echo "カスタムバリデーション例外をキャッチしました。" . PHP_EOL;
54
55    // getMessage() メソッドを使って、例外発生時に設定したメッセージを取得します。
56    echo "エラーメッセージ: " . $e->getMessage() . PHP_EOL;
57
58    // 例外に設定されたエラーコードも取得できます。
59    echo "エラーコード: " . $e->getCode() . PHP_EOL;
60
61    // 例外が発生したファイル名と行番号も取得できます。
62    echo "発生ファイル: " . $e->getFile() . PHP_EOL;
63    echo "発生行: " . $e->getLine() . PHP_EOL;
64} catch (Exception $e) {
65    // 上記以外の、予期しない一般的な例外をキャッチする場合
66    echo "予期せぬ一般的な例外をキャッチしました: " . $e->getMessage() . PHP_EOL;
67}
68

このサンプルコードは、PHPにおける例外処理の基本と、getMessageメソッドの役割を説明しています。getMessageメソッドは、例外オブジェクトに格納されている具体的なエラーメッセージを取得するために使用されます。このメソッドは引数を取らずに呼び出され、例外発生時に設定されたエラーメッセージを文字列（string）として返します。

コードでは、標準のExceptionクラスを継承したMyCustomValidationExceptionというカスタム例外クラスを定義しています。validateInput関数内で、特定の条件が満たされた場合（例：「invalid」が入力された場合）にこのカスタム例外をthrowします。このとき、例外のコンストラクタに具体的なエラーメッセージ（例：「入力値が不正です: 'invalid'」）を渡して設定しています。

try-catchブロックでは、validateInput関数を実行し、発生したMyCustomValidationExceptionをcatchしています。catchブロック内では、$e->getMessage()を呼び出すことで、例外がスローされたときに設定されたエラーメッセージを正確に取得し、画面に表示しています。これにより、プログラムがエラー状態に陥った際に、何が問題だったのかを具体的に把握し、適切なデバッグやエラーハンドリングを行うことができます。

Copy
1<?php
2
3/**
4 * RequestParseBodyException クラス
5 *
6 * プログラミング言語リファレンス情報に基づき、リクエストボディの解析中に
7 * 問題が発生した場合にスローされるカスタム例外クラスを定義します。
8 * PHPの標準的なExceptionクラスを継承しています。
9 */
10class RequestParseBodyException extends Exception
11{
12    /**
13     * コンストラクタ
14     *
15     * @param string $message 例外メッセージ
16     * @param int $code 例外コード
17     * @param Throwable|null $previous 以前の例外 (チェイン用、PHP 7.0以降)
18     */
19    public function __construct(string $message = "", int $code = 0, ?Throwable $previous = null)
20    {
21        // 親クラス (Exception) のコンストラクタを呼び出す
22        parent::__construct($message, $code, $previous);
23    }
24}
25
26/**
27 * 擬似的なリクエストボディ解析関数
28 *
29 * 実際のシステムでは、HTTPリクエストから送信されたボディデータを読み込み、
30 * JSON形式やフォームデータなどを解析します。ここではその処理を模倣し、
31 * 特定の条件で RequestParseBodyException をスローする例を示します。
32 *
33 * キーワード「truncated」は、リクエストボディが大きすぎて一部が切り捨てられた
34 * 状況を想定したエラーメッセージとして使用されます。
35 *
36 * @param string $body 解析対象の文字列 (HTTPリクエストボディと想定)
37 * @return array 解析結果のデータ
38 * @throws RequestParseBodyException リクエストボディの解析に失敗した場合にスローされる
39 */
40function simulateRequestBodyParsing(string $body): array
41{
42    // --- 例1: リクエストボディが長すぎる場合のシミュレーション ---
43    // システムが受け入れ可能な最大ボディ長を超えた場合を想定します。
44    // このとき、メッセージに「truncated」というキーワードを含めることで、
45    // データが途中で切り捨てられた可能性を示唆します。
46    $maxBodyLength = 100; // 例として最大100バイトに設定
47    if (strlen($body) > $maxBodyLength) {
48        throw new RequestParseBodyException(
49            "Request body exceeds maximum allowed length of " . $maxBodyLength . " bytes. Processing may have been truncated.",
50            400 // HTTPステータスコード 400 Bad Request を模倣
51        );
52    }
53
54    // --- 例2: 不正なJSON形式のシミュレーション ---
55    // リクエストボディがJSONとして正しくない場合にエラーとします。
56    $decodedData = json_decode($body, true);
57
58    if (json_last_error() !== JSON_ERROR_NONE) {
59        throw new RequestParseBodyException(
60            "Invalid JSON format in request body: " . json_last_error_msg(),
61            400 // HTTPステータスコード 400 Bad Request を模倣
62        );
63    }
64
65    // 正常にパースできた場合
66    return $decodedData;
67}
68
69// --- サンプルコードの実行: 様々なシナリオで例外をテスト ---
70
71echo "--- 1. 正常なリクエストボディのケース ---\n";
72try {
73    $validBody = '{"name": "Alice", "age": 30}';
74    $data = simulateRequestBodyParsing($validBody);
75    echo "成功: リクエストボディが正常に解析されました。\n";
76    echo "解析結果: " . print_r($data, true) . "\n\n";
77} catch (RequestParseBodyException $e) {
78    // 正常なケースではこのブロックは実行されません
79    echo "エラー: RequestParseBodyException が捕捉されました。\n";
80    echo "メッセージ: " . $e->getMessage() . "\n";
81    echo "コード: " . $e->getCode() . "\n\n";
82}
83
84echo "--- 2. 長すぎるリクエストボディのケース (「truncated」シナリオ) ---\n";
85try {
86    // 意図的に最大長を超える非常に長い文字列を作成
87    $longBody = str_repeat('x', 150) . '{"user": "Bob"}';
88    simulateRequestBodyParsing($longBody);
89    echo "成功: このメッセージは表示されません（例外が発生するため）。\n\n";
90} catch (RequestParseBodyException $e) {
91    // 例外が捕捉され、getMessage() メソッドでエラーメッセージを取得
92    echo "エラー: RequestParseBodyException が捕捉されました。\n";
93    echo "メッセージ: " . $e->getMessage() . "\n"; // ここに「truncated」を含むメッセージが出力されます
94    echo "コード: " . $e->getCode() . "\n";
95    echo "エラー発生ファイル: " . $e->getFile() . " (行: " . $e->getLine() . ")\n\n";
96}
97
98echo "--- 3. 不正なJSON形式のリクエストボディのケース ---\n";
99try {
100    $invalidJsonBody = '{"item": "Pen", "price": }'; // 不正なJSON形式（値が欠落）
101    simulateRequestBodyParsing($invalidJsonBody);
102    echo "成功: このメッセージは表示されません（例外が発生するため）。\n\n";
103} catch (RequestParseBodyException $e) {
104    // 例外が捕捉され、getMessage() メソッドでエラーメッセージを取得
105    echo "エラー: RequestParseBodyException が捕捉されました。\n";
106    echo "メッセージ: " . $e->getMessage() . "\n";
107    echo "コード: " . $e->getCode() . "\n\n";
108}
109
110?>

このサンプルコードは、HTTPリクエストボディの解析中に発生する可能性のあるエラーを扱うためのカスタム例外クラスRequestParseBodyExceptionと、その中で利用されるgetMessage()メソッドの働きを示しています。

getMessage()メソッドは、例外が発生した際に、その原因や状況を説明する詳細なエラーメッセージを文字列（string）として取得するためのものです。このメソッドは引数を必要としません。システムエンジニアを目指す初心者の方にとって、プログラムで予期せぬ問題が起きた際に、その原因を特定し、デバッグやユーザーへの適切なフィードバックを行う上で非常に重要な役割を果たします。

具体的には、サンプルコード内のsimulateRequestBodyParsing関数では、リクエストボディが長すぎて一部が「truncated（切り捨てられた）」可能性がある場合や、JSON形式が不正な場合にRequestParseBodyExceptionをスローしています。これらの例外がtry-catchブロックで捕捉された際、$e->getMessage()を呼び出すことで、それぞれのエラーシナリオに応じた具体的なメッセージが表示されます。特にボディが長すぎるケースでは、「Processing may have been truncated.」という情報を含むメッセージがgetMessage()によって返され、データの不完全性をプログラム側で確認できることを示しています。このように、getMessage()はエラーの詳細を把握するために不可欠な情報を提供します。