名前空間の使用法: 基本編
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
名前空間の使い方についてあれこれ言う前に、まずは PHP がどのようにしてコード中の要素の名前空間を知るのかを理解しておくことが重要です。 PHP の名前空間は、ファイルシステムにたとえて考えることができます。 たとえば、ファイルシステム内のファイルにアクセスするには次の 3 つの方法があります。
-
foo.txtのような相対ファイル名を使う。これはcurrentdirectory/foo.txtと解釈されます。ここで、 currentdirectory は現在いるディレクトリを表します。したがって、カレントディレクトリが/home/fooであった場合はこれは/home/foo/foo.txtとなります。 -
subdirectory/foo.txtのような相対パス名を使う。これはcurrentdirectory/subdirectory/foo.txtと解釈されます。 -
/main/foo.txtのような絶対パス名を使う。これは/main/foo.txtと解釈されます。
PHP の名前空間内の要素についても同じ理屈があてはまります。 たとえば、クラス名を参照するには次の 3 つの方法があります。
-
$a = new foo();あるいはfoo::staticmethod();のような非修飾名 あるいはプレフィックスなしのクラス名。 現在の名前空間がcurrentnamespaceである場合、これはcurrentnamespace\fooと解釈されます。 名前空間に属さないグローバルなコードにおいては、これはfooと解釈されます。 注意: 修飾されていない関数や定数は、名前空間内にその関数や定数がなければ グローバルな関数あるいは変数とみなされます。詳細は 名前空間の使用法: グローバルな関数/定数への移行 を参照ください。 -
$a = new subnamespace\foo();あるいはsubnamespace\foo::staticmethod();のような修飾名 あるいはプレフィックスつきクラス名。 現在の名前空間がcurrentnamespaceである場合、これはcurrentnamespace\subnamespace\fooと解釈されます。 名前空間に属さないグローバルなコードにおいては、これはsubnamespace\fooと解釈されます。 -
$a = new \currentnamespace\foo();あるいは\currentnamespace\foo::staticmethod();のような完全修飾名 あるいはグローバルプレフィックス演算子つきのクラス名。 これは、常にコードで記述されたとおりの名前であるcurrentnamespace\fooと解釈されます。
これら 3 つの構文を実際のコードで使う例を次に示します。
file1.php
<?phpnamespace Foo\Bar\subnamespace;const FOO = 1;function foo() {}class foo{ static function staticmethod() {}}?>
file2.php
<?phpnamespace Foo\Bar;include 'file1.php';const FOO = 2;function foo() {}class foo{ static function staticmethod() {}}/* 非修飾名 */foo(); // Foo\Bar\foo 関数と解釈されますfoo::staticmethod(); // Foo\Bar\foo クラスの staticmethod メソッドと解釈されますecho FOO; // 定数 Foo\Bar\FOO と解釈されます/* 修飾名 */subnamespace\foo(); // Foo\Bar\subnamespace\foo 関数と解釈されますsubnamespace\foo::staticmethod(); // Foo\Bar\subnamespace\foo クラスの // staticmethod メソッドと解釈されますecho subnamespace\FOO; // 定数 Foo\Bar\subnamespace\FOO と解釈されます /* 完全修飾名 */\Foo\Bar\foo(); // Foo\Bar\foo 関数と解釈されます\Foo\Bar\foo::staticmethod(); // Foo\Bar\foo クラスの staticmethod メソッドと解釈されますecho \Foo\Bar\FOO; // 定数 Foo\Bar\FOO と解釈されます?>
グローバルなクラス、関数あるいは定数にアクセスするには、完全修飾名を使用して
\strlen()、\Exception あるいは
\INI_ALL などとすることができます。
例1 グローバルなクラス、関数および定数への名前空間内からのアクセス
<?phpnamespace Foo;function strlen() {}const INI_ALL = 3;class Exception {}$a = \strlen('hi'); // グローバル関数 strlen をコールします$b = \INI_ALL; // グローバル定数 INI_ALL にアクセスします$c = new \Exception('error'); // グローバルクラス Exception のインスタンスを作成します?>
