PHPの名前解決ルールとは?名前空間の解決の仕組みをわかりやすく解説

はじめに

PHPには名前空間(namespace)という仕組みがあり、クラス・関数・定数などを論理的にグループ化して管理できます。しかし、コード中に書かれた名前がどの名前空間に属するものとして解釈されるのかは、いくつかの明確なルールに従って決まります。
本記事では、PHPの名前解決(name resolution)ルールについて、「非修飾名」「修飾名」「完全修飾名」の違いにも触れながら、具体例とともにわかりやすく解説します。

PHPの名前解決の基本ルール

PHPのコード内に出現する名前空間の識別子は、以下のルールに従って解決されます。

1. 非修飾名(Unqualified name)

名前空間の区切り文字(\)を含まない名前は非修飾名と呼ばれ、現在の名前空間を指すものとして扱われます。

2. 修飾名(Qualified name)

myspace\space1 のように区切り文字を含む名前は、myspace 名前空間の下にあるサブ名前空間 space1 として解決されます。このように現在位置からの相対的な関係で表される命名を、相対的な名前空間と呼びます。

3. 完全修飾名(Fully qualified name)

\ 文字で始まる名前は完全修飾名です。例えば \myspace や \myspace\space1 などが該当します。完全修飾名は常に絶対的な名前空間として解決され、たとえば \myspace\space1 は myspace\space1 名前空間へと対応づけられます。

4. namespaceキーワードを使った名前

名前がグローバル名前空間の中で出現した場合、namespace\ というプレフィックスは取り除かれます。例えば namespace\space1 は space1 に解決されます。

一方、同じ名前でも他の名前空間の内部で出現した場合は異なる扱いになります。例えば、namespace\space1 が myspace 名前空間内にあれば、これは myspace\space1 と同等として解決されます。

use文(インポート)による名前の変換

1. 先頭セグメントの変換

修飾名の最初のセグメント(先頭部分)は、現在のクラス/名前空間のインポートテーブル(use文によるエイリアス定義)に基づいて変換されます。

2. インポートルールが適用されない場合

適用できるインポートルールが存在しないときは、名前の先頭に現在の名前空間が付加されます。

3. 種類ごとのインポートテーブル

クラスに類する名前はクラス/名前空間のインポートテーブルに、関数名は関数インポートテーブル(use function)に、定数は定数インポートテーブル(use const)に従って、それぞれ個別に変換されます。

実行時に行われるフォールバック解決

非修飾名に対してインポートルールが適用されず、その名前が関数または定数を指しており、かつコードがグローバル名前空間の外側に存在する場合、その名前は実行時(runtime)に解決されます。
具体的には、まず現在の名前空間から該当する関数を探し、見つからなければグローバルな関数を探して呼び出します。

<?php
namespace myspace;

// 非修飾名での関数呼び出し
strlen("abc");
// myspace\strlen() が存在すればそちらを優先して呼び出す
// 存在しなければグローバルの strlen() が呼ばれる
?>

まとめ

PHPの名前解決は、「区切り文字の有無」「先頭が \ で始まるかどうか」「namespaceキーワードの使用」「use文によるインポート」といった要素によって判断されます。特に注意したいのは、クラス名はグローバルへの自動フォールバックが行われない一方で、関数と定数のみ実行時フォールバックが働くという点です。これらのルールを正しく理解しておけば、名前空間を活用した大規模開発においても、意図しない挙動やバグを防ぐことができます。