【PHP8.x】ReflectionObject::nameプロパティの使い方

nameプロパティの使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

nameプロパティは、ReflectionObjectオブジェクトが表すインスタンスのクラス名を保持するプロパティです。ReflectionObjectクラスは、PHPのリフレクションAPIの一部であり、プログラムの実行中にクラスやオブジェクトの構造、プロパティ、メソッドなどの情報を動的に取得・操作することを可能にします。

このnameプロパティを利用することで、ReflectionObjectが現在どのクラスのインスタンスについて情報を検査しているのかを、文字列形式で正確に知ることができます。例えば、UserクラスのインスタンスをReflectionObjectで分析している場合、nameプロパティには"User"という文字列が格納されます。

この情報は、特にアプリケーションが実行されている最中に、オブジェクトが属するクラスの名前を特定する必要がある場合に役立ちます。例えば、特定のクラスに属するオブジェクトに対してのみ処理を実行したい場合や、ログ出力のためにオブジェクトのクラス名を取得したい場合などに利用されます。これにより、動的な型チェックや汎用的なコードの記述が容易になり、より柔軟で保守性の高いシステムを構築する際に貢献します。PHP 8においても、このプロパティの基本的な振る舞いや機能に変更はありません。

構文(syntax)


1class MyClass {}
2
3$object = new MyClass();
4$reflectionObject = new ReflectionObject($object);
5
6echo $reflectionObject->name;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

ReflectionObject::name プロパティは、リフレクション対象のオブジェクトのクラス名を表す文字列を返します。

サンプルコード

ReflectionObject::$nameでクラス名を取得する


1<?php
2
3// 名前空間を定義します。これにより、クラス名が衝突するのを防ぎ、コードを整理できます。
4namespace MyProject\Application;
5
6/**
7 * 名前空間内に定義されたシンプルなクラスです。
8 * ReflectionObject::$name プロパティはこのクラスの完全修飾名を返します。
9 */
10class MyService
11{
12    private string $serviceName;
13
14    public function __construct(string $serviceName)
15    {
16        $this->serviceName = $serviceName;
17    }
18
19    public function getServiceName(): string
20    {
21        return $this->serviceName;
22    }
23}
24
25// 名前空間内のクラスのインスタンスを作成します。
26// `new MyService` は現在の名前空間 (MyProject\Application) 内で MyService を探します。
27$instance = new MyService('Example Service');
28
29// ReflectionObject のインスタンスを作成し、作成したオブジェクトを渡します。
30// これにより、実行時にオブジェクト（この場合は $instance）の構造に関する情報を取得できます。
31$reflector = new \ReflectionObject($instance);
32
33// ReflectionObject::$name プロパティにアクセスします。
34// このプロパティは、リフレクション対象のオブジェクトのクラス名（名前空間を含む完全修飾名）を文字列で返します。
35$fullClassName = $reflector->name;
36
37// 結果を出力します。
38// 名前空間とクラス名が結合された完全なクラス名が表示されることを期待します。
39echo "オブジェクトの完全修飾クラス名: " . $fullClassName . PHP_EOL;
40
41// 期待される出力例: オブジェクトの完全修飾クラス名: MyProject\Application\MyService
42

このPHPコードは、ReflectionObjectクラスの$nameプロパティを利用して、オブジェクトの完全修飾クラス名を取得する方法をシステムエンジニアの初心者向けに示しています。

まず、namespace MyProject\Application;で名前空間を定義しています。名前空間は、大規模なプロジェクトにおいてクラス名の衝突を防ぎ、コードを整理するために非常に重要な仕組みです。MyServiceクラスはこの名前空間内に定義され、そのインスタンスが作成されます。

次に、new \ReflectionObject($instance)でReflectionObjectのインスタンスを作成しています。ReflectionObjectはPHPのリフレクションAPIの一部で、プログラムの実行中にオブジェクトの内部構造や情報を動的に調べることができる機能を提供します。

$reflector->nameは、ReflectionObjectが持つプロパティで、リフレクション対象のオブジェクトのクラス名を取得するために使用されます。このプロパティは引数を持ちません。その戻り値はstring型で、オブジェクトが属する名前空間を含んだ「完全修飾クラス名」を文字列として返します。

サンプルコードでは、MyServiceクラスのインスタンスをリフレクションし、$reflector->nameを通じてMyProject\Application\MyServiceという完全修飾クラス名を取得し、最終的に画面に出力しています。この機能は、動的にクラス情報を取得したい場合や、フレームワークなどの開発で非常に役立ちます。

ReflectionObject::$nameプロパティは、リフレクション対象のオブジェクトが持つクラス名を、そのクラスが属する名前空間を含む「完全修飾名」として文字列で返します。これは、単にクラス名だけではなく、PHPの名前空間パスも含まれるため、同じ名前のクラスが異なる名前空間に存在する場合でも、一意に識別可能です。名前空間は、大規模なシステムでクラス名の衝突を防ぎ、コードを整理するための重要な仕組みです。このプロパティにより、実行時にオブジェクトの正確なクラス情報を動的に取得でき、フレームワークやライブラリ開発などの高度なプログラミングで活用されます。