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

isReadOnlyメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月26日

基本的な使い方

isReadOnlyメソッドは、リフレクションによって取得したオブジェクトが「読み取り専用クラス」のインスタンスであるかどうかを判定するメソッドです。

このメソッドは、PHPの標準拡張機能の一つであるリフレクションAPIの一部として、ReflectionObjectクラスに属しています。ReflectionObjectクラスは、プログラム実行中に任意のオブジェクトの構造や性質、例えばどのようなプロパティやメソッドを持っているかといった情報を動的に調べるために利用されます。

isReadOnlyメソッドは、PHP 8.2で導入された「readonly」修飾子で宣言されたクラスから生成されたオブジェクトに対して呼び出された場合、trueを返します。そうでない場合はfalseを返します。読み取り専用クラスのオブジェクトは、そのプロパティが一度初期化されると、その後は変更できないという特性を持っています。この特性は、オブジェクトの状態が不変であることを保証したい場合に非常に有用です。

システム開発において、データの整合性を保ちたい場合や、特定のオブジェクトが外部からの不適切な変更から保護されているかを確認したい場合に、このisReadOnlyメソッドが役立ちます。これにより、意図しないデータの改変を防ぎ、より堅牢で信頼性の高いアプリケーションを構築することが可能になります。

構文(syntax)


1<?php
2readonly class MyClass {}
3
4$object = new MyClass();
5$reflectionObject = new ReflectionObject($object);
6$isReadOnly = $reflectionObject->isReadOnly();
7?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

bool

このメソッドは、指定されたオブジェクトのプロパティが読み取り専用であるかどうかを示す真偽値（trueまたはfalse）を返します。