PHPで名前空間を使う方法｜クラス・関数・定数への3つのアクセス手法を解説

はじめに

PHPでは、名前空間（namespace）内で定義されたクラス、関数、定数を利用する際に、主に以下の3つの方法があります。

• 現在の名前空間にあるクラスや関数をそのまま呼び出す
• 現在の名前空間からの相対パスで名前空間を指定する
• 先頭にバックスラッシュを付けた完全修飾名（FQCN）で指定する

それぞれの使い方を、具体的なコード例とともに見ていきましょう。

1. 現在の名前空間から参照する

まず、読み込む側のファイルとして test1.php を用意します。このファイルには myspace\space1 という名前空間が定義されています。

test1.php のコード例

#test1.php
<?php
namespace myspace\space1;
const MAX = 100;
function hello() {echo "hello in space1\n";}
class myclass{
    static function hellomethod() {echo "hello in space1\n";}
}
?>

次に、このファイルを読み込んで使用するコードです。名前空間を付けずに関数やクラス名だけを記述した場合、現在の名前空間に定義されたものが参照されます。

使用例

<?php
namespace myspace;
include 'test1.php';
const MAX = 200;
function hello() {echo "hello in myspace\n";}
class myclass{
    static function hellomethod() {echo "hello in myspace\n";}
}
hello();
myclass::hellomethod();
echo MAX;
?>

実行結果

hello in myspace
hello in myspace
200

このように、名前空間の指定がない呼び出しはすべて myspace 側の定義が優先され、space1 内の同名の関数やクラスは呼び出されません。

2. 相対的な名前空間で参照する

続いて、現在の名前空間を基準とした相対的な名前空間でサブ名前空間内の要素にアクセスする例です。名前空間名の後にバックスラッシュを付けて、対象の関数やクラスを指定します。

使用例

<?php
namespace myspace;
include 'test1.php';
const MAX = 200;
function hello() {echo "hello in myspace\n";}
class myclass{
    static function hellomethod() {echo "hello in myspace\n";}
}
space1\hello();
space1\myclass::hellomethod();
echo space1\MAX;
?>

実行結果

hello in space1
hello in space1
100

相対指定では、現在の名前空間 myspace を起点として myspace\space1 内の要素が正しく参照されていることがわかります。

3. 完全修飾名前空間で参照する

最後に、グローバル空間を起点とする完全修飾名によるアクセス方法です。先頭にバックスラッシュ（\）を付けることで、現在いる名前空間に関係なく、絶対的な位置から対象を特定できます。

使用例

<?php
namespace myspace;
include 'test1.php';
const MAX = 200;
function hello() {echo "hello in myspace\n";}
class myclass{
    static function hellomethod() {echo "hello in myspace\n";}
}
\myspace\hello();
\myspace\space1\hello();
\myspace\myclass::hellomethod();
\myspace\space1\myclass::hellomethod();
echo \myspace\MAX . "\n";
echo \myspace\space1\MAX;
?>

実行結果

hello in myspace
hello in space1
hello in myspace
hello in space1
200
100

完全修飾名を使えば、myspace と myspace\space1 の両方の要素を明確に区別して呼び出せるため、大規模なプロジェクトでも名前の衝突を避けながら安全にコードを書くことができます。

まとめ

PHPの名前空間には「現在の名前空間からの直接参照」「相対的な指定」「完全修飾名による絶対指定」の3つのアクセス方法があります。用途に応じて使い分けることで、クラスや関数の名前衝突を防ぎ、保守性の高いコードを実現できます。