名前解決のルール

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

名前解決のルールを説明するにあたって、いくつかの重要な定義を示しておきます。

名前空間名の定義

非修飾名

これは名前空間区切り文字を含まない識別子で、Foo のようなものです。

修飾名

これは名前空間区切り文字を含む識別子で、Foo\Bar のようなものです。

完全修飾名

これは名前空間区切り文字を含む識別子のうち先頭が名前空間区切り文字で始まるもので、 \Foo\Bar のようなものです。名前空間 \Foo も完全修飾名です。

相対名

namespace\Foo\Bar のように、 namespace で始まる識別子です。

名前解決は、これらの解決ルールによって行われます。

1. 完全修飾名は、先頭の名前空間区切り文字を除いた名前に常に解決されます。 たとえば、\A\B は A\B と解釈されます。
2. 相対名は、namespace という名前を、 現在の名前空間に置き換えたものに常に解決されます。 現在の名前空間がグローバル名前空間だった場合、 namespace\ 名前空間は取り除かれます。 たとえば、名前空間 X\Y の中にある namespace\A は、 X\Y\A に解決されます。 グローバル名前空間の中にある同じ名前は、 A に解決されます。
3. 修飾名の場合は、名前の最初の識別子を、 現在のクラス/名前空間のインポートテーブルに従って翻訳します。 たとえば、名前空間 A\B\C が C としてインポートされた場合、 C\D\E という名前は、 A\B\C\D\E と翻訳されます。
4. 修飾名の場合で、適用すべきインポートルールがない場合、 現在の名前空間が名前の先頭に付加されます。 たとえば、名前空間 A\B の中にある C\D\E という名前は A\B\C\D\E に解決されます。
5. 非修飾名の場合、名前はそれぞれのシンボルタイプの 現在のインポートテーブルに従って翻訳されます。 これは、クラスのような名前は、クラス/名前空間のインポートテーブルに従って 翻訳されるし、関数名は、関数のインポートテーブルに従うし、 定数は定数のインポートテーブルに従うということになります。 たとえば、use A\B\C; の後に、 new C() のようなことをすると、 C は A\B\C() に解決されます。 同じように、use function A\B\foo; の後に foo() のようなことをすると、 A\B\foo という名前に解決されます。
6. 非修飾名について、適用すべきインポートルールが存在せず、 名前がクラスのようなシンボルを参照している場合、 現在の名前空間が先頭に付加されます。 たとえば、名前空間 A\B の内部にある new C() は、 A\B\C という名前に解決されます。
7. 非修飾名について、適用すべきインポートルールが存在せず、 名前が関数や定数を参照しており、 コードがグローバル名前空間の外に存在する場合は 名前は実行時に解決されます。 コードが名前空間 A\B の中にあると仮定すると、 関数 foo() のコールは、次のように解決されます。
   1. まず現在の名前空間から関数 A\B\foo() を探します。
   2. 次に グローバル 関数 foo() を探します。