ReturnTypeWillChange アトリビュート

はじめに

PHP 8.1.0 以降、内部クラスのメソッドが戻り値の型を宣言するようになる、 暫定的な移行フェーズが始まりました。

ほとんどの final でない内部メソッドは、 それをオーバーライドする際、 互換性がある戻り値の型を宣言することが必須になっています。 そうしない場合、継承が有効かを検証する際に、 シグネチャが共変性のルールに違反しているという推奨されない警告が発生します。

将来のバージョンの PHP では、メソッドのシグネチャが厳密にチェックされるようになり、 互換性がない場合は致命的なエラーが発生するようになります。

PHP のバージョン間の互換性を保ちたいがために、 オーバーライドするメソッドの戻り値の型を宣言できない場合や、 オーバーライドするメソッドが互換性のない戻り値の型を宣言している場合は、 アトリビュート #[\ReturnTypeWillChange] を追加することで推奨されない警告を抑止できます。

クラス概要

参考

アトリビュートの概要