1. 導入
PHPの開発において、1ファイル1クラス（あるいは1名前空間）が現在の標準的なコーディング規約（PSR-4など）ですが、特定のライブラリ開発やスクリプトの結合において、1つのファイル内に複数の名前空間を記述する必要に迫られるケースがあります。この記事では、PHPで複数の名前空間を定義する手法とその正しい実装方法、そして実務で遭遇する落とし穴について解説します。
2. 基礎知識
名前空間（Namespace）は、クラス、関数、定数の名前の衝突を防ぐための仕組みです。通常、ファイル先頭に `namespace A;` と記述しますが、PHPでは同一ファイル内に複数の名前空間を記述することが文法上許容されています。これには「非中括弧構文」と「中括弧構文」の2種類が存在します。
3. 実装/解決策
実務においては、コードの可読性と安全性を考慮し、必ず中括弧構文を使用することを推奨します。
非中括弧構文では、ファイル全体がその名前空間の影響を受けるため、複数の名前空間を混在させると意図しない挙動やバグの原因となります。一方、中括弧構文であれば名前空間のスコープが明確になり、グローバル空間のコードと混在させることも可能です。
4. サンプルプログラム
以下のコードは、中括弧構文を使用して複数の名前空間を定義し、さらにグローバル空間のコード（`session_start`など）を組み合わせた実用的な構成例です。
run() . PHP_EOL;
echo $b->run() . PHP_EOL;
echo “グローバル空間の処理完了” . PHP_EOL;
}
?>
5. 応用・注意点
現場で活用する際には、以下の点に注意してください。
1. 構文の混在は厳禁
非中括弧構文（`namespace A;`）と中括弧構文（`namespace A { … }`）を同じファイル内で混在させると、致命的なエラー（Fatal Error）が発生します。基本的にはすべてのコードを中括弧で囲むスタイルに統一してください。
2. 可読性の低下
複数の名前空間を1ファイルに詰め込むと、IDE（PHPStormなど）の自動読み込み機能やクラス検索が複雑になります。コードの保守性が著しく低下するため、特別な理由がない限りは「1ファイル1名前空間」の原則を守るのが賢明です。
3. 空白や改行の罠
中括弧構文を使用する場合、名前空間のブロック外にコードを記述することはできません。特に、ファイルの末尾に不要な改行や空白があると、それがエラーの原因になることがあります。また、PHPの終了タグ `?>` をファイルの末尾に書く癖がある場合は、その後の空白が予期せぬ挙動を引き起こす可能性があるため、純粋なPHPファイルでは終了タグを省略するのがベストプラクティスです。