上級

__toString未実装のオブジェクトを文字列化した原因

__toString()メソッドを持たないオブジェクトを文字列と連結したり、文字列として出力しようとしたりすると致命的エラーになります。オブジェクトを文字列として扱いたい場合は__toString()を実装する必要があります。

エラーメッセージの読み方

Fatal error: Uncaught Error: Object of class Money could not be converted to string in main.php:6

main.php

ファイル名

6

行番号 — 実際にクラッシュした行

Error

例外クラス — 何が起きたか。ここを検索するのが最短です

Object of class Money could not be converted to string

内容 — どの値が問題だったか

このエラーが出る典型パターン

 1  <?php
 2  class Money {
 3      public function __construct(public int $cents) {}
 4  }
 5  $m = new Money(500);
 6  echo "Price: " . $m                ;
                              ^

 1  <?php
 2  class Temperature {
 3      public function __construct(public float $celsius) {}
 4  }
 5  $t = new Temperature(25.5);
 6  echo "Now: " . $t                  ;
                             ^

 1  <?php
 2  class Distance {
 3      public function __construct(public int $meters) {}
 4  }
 5  $d = new Distance(150);
 6  echo "Length: " . $d                 ;
                               ^

 1  <?php
 2  class Weight {
 3      public function __construct(public int $grams) {}
 4  }
 5  $w = new Weight(300);
 6  echo "Weight: " . $w                ;
                               ^

 1  <?php
 2  class Speed {
 3      public function __construct(public int $kmh) {}
 4  }
 5  $s = new Speed(80);
 6  echo "Speed: " . $s              ;
                             ^

よくある誤解

「オブジェクトも文字列と連結すれば、なんとなく変換されて表示されるはず」という思い込みは誤りです。PHPはオブジェクトから文字列への変換方法を自動では決められないため、__toString()の実装がなければ致命的エラーになります。

実務での勘所

__toString()が必要になるのは、オブジェクトを実際に「文字列」として扱う場面(echo、文字列連結の.、文字列への明示的なキャストなど)に限られます。var_dump()やprint_r()は、オブジェクトを文字列に変換しているわけではなく、独自の方法でオブジェクトの中身を人間向けに整形して表示しているため、__toString()が無くてもエラーになりません。デバッグ中にvar_dumpでは正常に見えていたオブジェクトが、echoや.で使った途端にエラーになるのは、この2種類の「表示」がまったく別の仕組みで動いているためです。

演習をはじめる

関連するエラー

• 文字列同士に + を使うと TypeError になる（. との違い）PHPの文字列連結演算子は . （ピリオド）です。
• Cannot modify readonly property の原因と直し方readonlyを付けたプロパティは、コンストラクタの中で一度初期化した後は二度と値を変更できません。