PHPで1つのファイルに複数の名前空間を定義する方法

はじめに

拡張子が「.php」のファイル1つの中に、複数の名前空間（namespace）を定義することができます。このために用意されている記述方法は2種類あり、「組み合わせ構文（連続記法）」と「波括弧（ブレース）構文」と呼ばれます。それぞれの書き方と動作を、具体的なコード例とともに見ていきましょう。

組み合わせ構文による複数の名前空間の定義

この例では、2つの名前空間を上下に続けて定義しています。最初の名前空間に属する関数や定数などのリソースは、次の名前空間の定義が始まるまでの間のみ有効です。特定の名前空間を現在の名前空間として扱いたい場合は、useキーワードを使って読み込みます。

サンプルコード

<?php
namespace myspace1;
function hello() {
    echo "Hello World from space1\n";
}
echo "myspace1 : ";
hello();
namespace myspace\space2;
function hello(){
    echo "Hello World from space2\n";
}
echo "myspace2 : ";
hello();
use myspace1;
hello();
use myspace2;
hello();
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

myspace1 : Hello World from space1
myspace2 : Hello World from space2
Hello World from space2
Hello World from space2

波括弧構文による複数の名前空間の定義

次の例では、各名前空間の適用範囲を波括弧「{ }」で明示することにより、2つの名前空間を同じファイル内に定義しています。どのコードがどの名前空間に属しているのかが視覚的に分かりやすくなるのが特徴です。

サンプルコード

<?php
namespace myspace1{
    function hello() {
        echo "Hello World from space1\n";
    }
    echo "myspace1 : ";
    hello();
}
namespace myspace\space2{
function hello(){
    echo "Hello World from space2\n";
}
echo "myspace2 : ";
hello();
}
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

myspace1 : Hello World from space1
myspace2 : Hello World from space2

どちらの構文を使うべきか

複数の名前空間を1つのファイルに定義する場合は、組み合わせ構文よりも波括弧構文が推奨されています。ただし、波括弧を使った名前空間と使わない名前空間を同一ファイル内で混在させることはできません。また、ファイル先頭のdeclare文を除き、名前空間の波括弧の外側に他のPHPコードを記述することも許されていません。さらに、グローバル名前空間と名前付き名前空間を1つのファイル内で組み合わせたい場合にも、波括弧構文のみが使用可能です。これらの制約を理解した上で、可読性の高い波括弧構文を採用するのが良いでしょう。