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

Copy
1<?php
2
3/**
4 * 文字列を受け取り、処理を行う関数。
5 * 引数にstring型ヒントを付けることで、異なる型が渡された場合にTypeErrorを発生させます。
6 *
7 * @param string $input 処理する文字列
8 * @return void
9 */
10function processString(string $input): void
11{
12    // この関数は、引数として受け取った文字列を何か処理するふりをします。
13    // 今回の例では、TypeErrorを発生させるトリガーとして使用します。
14    // 注意: TypeErrorが発生する場合、この行は実行されません。
15}
16
17/**
18 * string型を期待する関数にarray型を誤って渡すことでTypeErrorを発生させ、
19 * そのTypeErrorオブジェクトが文字列としてどのように表現されるかを示すサンプルです。
20 * TypeErrorクラスの__toStringメソッドの働きを実演します。
21 *
22 * @return void
23 */
24function demonstrateTypeErrorToString(): void
25{
26    try {
27        // string型を期待する processString() 関数に array型を渡すことで、
28        // TypeError を意図的に発生させます。
29        processString(['apple', 'banana', 'cherry']);
30    } catch (TypeError $e) {
31        // TypeError オブジェクトを文字列として扱おうとすると、
32        // 内部的に TypeError::__toString() メソッドが自動的に呼び出されます。
33        // これにより、エラーの詳細情報を含む整形された文字列が得られます。
34        // 下記のecho文が、__toString() メソッドの戻り値を出力します。
35        echo $e . "\n"; // __toString() が暗黙的に呼び出される
36    }
37}
38
39// サンプルコードを実行します。
40demonstrateTypeErrorToString();

PHPのTypeError::__toStringメソッドは、プログラミング中に型の不一致によって発生するTypeErrorオブジェクトを、人間が読みやすい文字列形式に変換するための特別なメソッドです。PHP 8では、関数やメソッドの引数に型ヒントが指定されており、それに合わない型の値が渡された場合にTypeErrorが発生します。

この__toStringメソッドは、オブジェクトが文字列として扱われる際にPHPによって自動的に呼び出される仕組みです。例えば、TypeErrorオブジェクトをecho文などで直接出力しようとすると、内部的にTypeError::__toString()メソッドが実行されます。このメソッドは引数を受け取らず、エラーメッセージ、エラーが発生したファイル名、および行番号といった詳細な情報を含む整形された文字列を戻り値として返します。

提供されたサンプルコードでは、processString関数が引数としてstring型を期待しているにもかかわらず、意図的にarray型を渡すことでTypeErrorを発生させています。try-catchブロックでこのTypeErrorを捕捉し、catchブロック内でecho $e;と記述しています。これにより、捕捉されたTypeErrorオブジェクト$eが文字列として扱われ、TypeError::__toString()メソッドが自動的に呼び出されて、エラーの詳細情報が画面に出力される様子を示しています。これはエラー発生時のデバッグや情報収集に役立つ機能です。

Copy
1<?php
2
3declare(strict_types=1); // 厳格な型チェックを有効にする
4
5/**
6 * 整数を2倍にする関数。
7 * 型ヒントにより、引数$numberは必ずint型である必要があります。
8 *
9 * @param int $number 倍にする整数
10 * @return int 2倍になった整数
11 */
12function doubleInteger(int $number): int
13{
14    return $number * 2;
15}
16
17try {
18    // doubleInteger関数はint型を期待していますが、
19    // ここでは意図的にstring型を渡しています。
20    // これにより、PHP 8の厳格な型チェックの下でTypeErrorが発生します。
21    echo doubleInteger("hello");
22} catch (TypeError $e) {
23    // TypeErrorオブジェクトが文字列コンテキスト（例: echo文や文字列結合）で
24    // 使用されると、PHPは自動的にそのオブジェクトの__toString()マジックメソッドを呼び出します。
25    // これにより、エラーの詳細情報が分かりやすい文字列として返され、出力されます。
26    echo "型エラーが発生しました:\n";
27    echo $e; // ここでTypeError::__toString()メソッドが自動的に呼び出され、エラー情報が文字列として表示されます。
28    echo "\n\n";
29
30    // 参考: エラーメッセージのみを取得する場合はgetMessage()メソッドを使用します。
31    echo "エラーメッセージのみ取得する場合:\n";
32    echo $e->getMessage();
33}
34

このPHPのサンプルコードは、PHP 8で導入された厳格な型チェック機能と、発生した型エラー（TypeError）の情報を文字列として表示する方法を示しています。

まず、declare(strict_types=1);によって、PHPは関数の引数や戻り値の型を厳密にチェックするようになります。doubleInteger関数は、引数に整数（int型）を受け取り、2倍にした整数を返すように定義されています。

tryブロックの中では、このdoubleInteger関数に意図的に文字列（"hello"）を渡しています。厳格な型チェックが有効なため、整数が期待される場所に文字列が渡されると、PHPはTypeErrorというエラーを発生させます。

このTypeErrorはcatch (TypeError $e)ブロックで捕捉されます。捕捉されたエラーオブジェクトは変数$eに格納されます。echo $e;と記述すると、PHPは自動的にTypeErrorクラスに定義されている特別なメソッド__toStringを呼び出します。この__toStringメソッドは引数を取らず、TypeErrorオブジェクトが持つエラーの詳細な情報を、人間が読みやすい一つの文字列として返します。その文字列がecho文によって画面に出力されるため、エラーの種類や発生箇所などを簡単に確認でき、デバッグ作業に役立ちます。

なお、エラーメッセージだけを具体的に取得したい場合は、$e->getMessage()メソッドを使用することも可能です。