【PHP8.x】ReflectionProperty::getRawValue()メソッドの使い方

getRawValueメソッドは、PHPのリフレクションAPIの一部であるReflectionPropertyクラスに属し、クラスのプロパティ（メンバー変数）に直接保存されている「そのままの値」を取得するメソッドです。

このメソッドの最大の特徴は、通常のプロパティの値取得とは異なり、オブジェクトのプロパティにアクセスする際に自動的に呼び出される可能性のある__get()などのマジックメソッドや、ユーザーが定義したカスタムの取得ロジックを一切介さずに、プロパティの内部に保持されている本来の値を直接取得できる点にあります。これは、プロパティの「生の（rawな）」データを必要とする場合に特に役立ちます。

具体的には、静的（static）ではないインスタンスプロパティの値を参照する場合には、そのプロパティを保持しているオブジェクトを引数として渡す必要があります。これにより、開発者はプロパティに設定されたアクセスメソッドやデータ変換ロジックの影響を受けることなく、プロパティの実際の内部状態を正確に確認することができます。

getRawValueメソッドは、フレームワーク開発におけるオブジェクトの状態検証、複雑なデバッグシナリオ、あるいは特定の条件下でオブジェクトの内部データを直接操作する必要がある高度なケースで活用されます。PHP 8で導入されたこの機能は、リフレクションをより詳細かつ柔軟に活用したい場合に、プロパティの真の値を安全かつ確実に取得するための強力な手段を提供します。

Copy
1<?php
2class MyClass
3{
4    public string $propertyName = '初期値';
5}
6
7$object = new MyClass();
8$reflectionProperty = new ReflectionProperty($object, 'propertyName');
9$value = $reflectionProperty->getRawValue($object);
10?>

?object $object = null

• ?object $object = null: 値を取得したいオブジェクト。指定しない場合は、プロパティがstaticとして扱われます。

mixed

ReflectionProperty::getRawValue() は、プロパティの実際の値を返します。この値は、プロパティの型宣言やキャストによって変換される前の、元の値となります。