【PHP8.x】stringプロパティの使い方

Copy
1<?php
2
3/**
4 * 文字列を整数に変換します。
5 * 変換できない場合は例外をスローします。
6 *
7 * @param string $numericString 整数に変換する文字列
8 * @return int 変換後の整数
9 * @throws Exception 文字列が有効な整数でない場合
10 */
11function convertStringToInt(string $numericString): int
12{
13    // filter_varを使用して、文字列が整数として有効か検証する
14    // falseが返された場合は、有効な整数ではないと判断する
15    $intValue = filter_var($numericString, FILTER_VALIDATE_INT);
16
17    if ($intValue === false) {
18        // 変換に失敗した場合、Exceptionをスローする
19        // 例外メッセージには、どの文字列が原因で失敗したかを含める
20        throw new Exception("エラー: '{$numericString}' は有効な整数に変換できません。");
21    }
22
23    // 検証を通過した場合、整数にキャストして返す
24    return (int)$intValue;
25}
26
27// --- サンプルコードの実行 ---
28
29// 試行する文字列の配列
30$testStrings = [
31    "12345",      // 成功例: 整数の文字列
32    "-678",       // 成功例: 負の整数の文字列
33    "abc",        // 失敗例: アルファベット
34    "10.5",       // 失敗例: 浮動小数点数
35    "99bottles"   // 失敗例: 数値と文字の混合
36];
37
38foreach ($testStrings as $string) {
39    try {
40        // 文字列から整数への変換を試みる
41        $convertedInt = convertStringToInt($string);
42        echo "'{$string}' は整数 {$convertedInt} に変換されました。" . PHP_EOL;
43    } catch (Exception $e) {
44        // 例外がスローされた場合、そのメッセージをキャッチして表示する
45        // $e->getMessage() はExceptionオブジェクトのプロパティからエラーメッセージ(string)を取得する
46        echo $e->getMessage() . PHP_EOL;
47    }
48}

このPHPサンプルコードは、文字列を整数に変換する処理と、その際に発生しうるエラーを適切に扱う方法を示しています。

convertStringToIntという関数は、引数として受け取った文字列を整数に変換します。内部ではfilter_var関数を使い、渡された文字列が数字だけで構成されているかを厳密に検証します。もし文字列にアルファベットや小数などが含まれていて整数に変換できない場合、throw new Exception()を使って意図的にエラー（例外）を発生させます。このとき、エラーメッセージとして「どの文字列が原因で変換に失敗したか」という情報を含んだ文字列をExceptionオブジェクトに設定します。正常に変換できた場合は、その結果の整数を戻り値として返します。

コードの後半部分では、try...catch構文を用いてこの関数を実行しています。tryブロックの中で変換処理を試み、もしExceptionが発生した場合はcatchブロックで処理を捕捉します。catchブロックでは、変数$eに格納されたExceptionオブジェクトのgetMessage()メソッドを呼び出しています。このメソッドは、throwされた際に設定されたエラーメッセージの文字列を戻り値として返すため、画面には具体的なエラー内容が表示されます。このように、getMessage()を使うことで、プログラム実行時に発生した問題の詳細を把握できます。

Copy
1<?php
2
3/**
4 * 例外オブジェクトを文字列に変換するPHPの動作を示します。
5 *
6 * PHPのExceptionクラスは、__toString()マジックメソッドを実装しています。
7 * このため、Exceptionオブジェクトを文字列コンテキスト（例: echo文や文字列連結）で使用すると、
8 * オブジェクト全体が自動的に詳細な例外情報（メッセージ、ファイル、行番号、スタックトレースなど）を含む文字列に変換されます。
9 *
10 * @param bool $shouldThrow 例外を発生させるべきかどうかのフラグ
11 * @return string 処理の結果として生成された文字列
12 */
13function demonstrateExceptionToStringConversion(bool $shouldThrow): string
14{
15    try {
16        if ($shouldThrow) {
17            // 意図的にExceptionをスローし、メッセージとエラーコードを設定します。
18            throw new Exception("これはテスト用のエラーメッセージです。", 1001);
19        }
20        // 例外が発生しなかった場合のメッセージ。
21        return "例外は発生しませんでした。\n";
22    } catch (Exception $e) {
23        // 例外がキャッチされた場合、Exceptionオブジェクト($e)を直接文字列コンテキストで使用します。
24        // PHPは自動的に$e->__toString()メソッドを呼び出し、
25        // オブジェクトをエラーの詳細情報を含む文字列に変換します。
26        return "--- キャッチされた例外情報 ---\n" . $e . "\n----------------------------\n";
27    }
28}
29
30// 例外が発生するケースをデモンストレーション
31echo "■ 例外が発生する場合:\n";
32echo demonstrateExceptionToStringConversion(true);
33
34echo "\n"; // 出力を見やすくするための改行
35
36// 例外が発生しないケースをデモンストレーション
37echo "■ 例外が発生しない場合:\n";
38echo demonstrateExceptionToStringConversion(false);
39
40?>

このPHPサンプルコードは、エラー発生時に作られるExceptionオブジェクトが、どのようにして文字列に変換されるかを示しています。

PHPのExceptionクラスには、オブジェクトを文字列として扱おうとすると、自動的にその中身を詳細な情報を含む文字列に変換する__toString()という特別な仕組みが備わっています。

コード内のdemonstrateExceptionToStringConversion関数は、引数$shouldThrowがtrueの時に意図的に例外を発生させます。try...catch構文によってこの例外が捕捉されると、catchブロック内でExceptionオブジェクトが変数$eに代入されます。

ここで重要なのは、return "--- キャッチされた例外情報 ---\n" . $e . "\n..."の部分です。Exceptionオブジェクトである$eを文字列と連結しようとすると、PHPが自動的に__toString()メソッドを呼び出します。その結果、$eはエラーメッセージ、ファイル名、行番号、そして処理の呼び出し履歴（スタックトレース）を含む、デバッグに役立つ詳細な文字列に変換されて返されます。

コードの最後では、例外が発生する場合としない場合の両方を実行し、Exceptionオブジェクトが文字列に変換されて出力される様子を確認できます。