PHPのnamespace（名前空間）を使ってコードを整理する方法を初心者向けに解説！
生徒
「PHPのnamespaceって何のために使うんですか？難しそうで…」
先生
「確かに名前空間は最初は難しく感じますが、複数のクラスや関数があるプロジェクトを整理するのにとても役立つ機能なんですよ。」
生徒
「クラス名がかぶるのを防ぐって聞いたことがありますが、どういうことですか？」
先生
「それじゃあ、今日はPHPのnamespace（名前空間）について、わかりやすい例を使って丁寧に説明していきましょう！」
1. PHPのnamespace（名前空間）とは？
PHPのnamespace（名前空間）とは、クラス名や関数名の重複を防ぐための仕組みです。たとえば「田中さん」という名前の人がクラスに2人いたら困りますよね？でも「1年1組の田中さん」と「1年2組の田中さん」とクラスで分ければ区別できます。
これと同じように、PHPのコードもnamespaceを使えば、同じ名前のクラスや関数が共存できるようになります。
2. namespaceの基本的な使い方
namespaceは、ファイルの先頭に1行だけ書きます。そしてその中で定義されるクラスや関数は、その名前空間の中に属するようになります。
namespace App\Controllers;
class UserController {
public function index() {
echo "ユーザー一覧を表示します";
}
}
このように書くと、このクラスはApp\Controllersという名前空間に属します。
3. 同じ名前のクラスが複数あるときの例
たとえば、AチームとBチームが別々に「User」クラスを作ったとします。普通なら名前がかぶってエラーになりますが、namespaceを使えば共存できます。
// AチームのUserクラス
namespace TeamA;
class User {
public function hello() {
echo "TeamAのUserです";
}
}
// BチームのUserクラス
namespace TeamB;
class User {
public function hello() {
echo "TeamBのUserです";
}
}
このように、TeamA\UserとTeamB\Userとして別々に使えます。
4. 別のnamespaceのクラスを使うには？
他の名前空間にあるクラスを使うときは、useというキーワードを使います。
namespace Main;
use TeamA\User;
$u = new User();
$u->hello(); // TeamAのUserです
use TeamA\User;と書くことで、TeamAのUserクラスをこのファイル内で簡単に使えるようになります。
5. フルパスでクラスを呼び出す方法
useを使わずに、直接クラスの「フルパス（完全な場所）」を使って呼び出すこともできます。
$userA = new \TeamA\User();
$userB = new \TeamB\User();
$userA->hello();
$userB->hello();
\で始めるのがポイントです。「PHPの最上位（グローバル）から探します」という意味になります。
6. useで別名をつけて簡単に使う
もし同じ名前のクラスが複数あってややこしい場合は、useで別名（エイリアス）をつけることもできます。
use TeamA\User as UserA;
use TeamB\User as UserB;
$a = new UserA();
$b = new UserB();
$a->hello();
$b->hello();
こうすることで、プログラムがより読みやすくなります。
7. 名前空間とフォルダ構成の関係
名前空間は、フォルダの構成と合わせて使うことが一般的です。たとえば、App/Controllers/UserController.phpというファイルには、次のように書きます。
namespace App\Controllers;
class UserController {
// コード
}
これにより、ファイルとクラスの構造が一致し、保守や拡張がしやすくなります。
8. 自動読み込み（オートローダー）とnamespace
PHPでは名前空間と組み合わせて「オートローダー」という機能を使うことで、ファイルを自動で読み込めるようになります。これにはComposer（コンポーザー）というツールがよく使われます。
composer.jsonに名前空間とフォルダの対応を定義すれば、requireやincludeを書かずに自動で読み込まれます。
初心者のうちは使いこなすのが少し難しいですが、覚えておくと将来的にとても便利です。
9. namespaceを使うとコードがどう良くなる？
名前空間を使うメリットは、以下のようにたくさんあります。
- クラス名や関数名の重複を防げる
- コードが整理され、見やすくなる
- 規模が大きくなっても保守しやすくなる
- 外部ライブラリとの衝突を回避できる
実際の現場では、名前空間を使うのが当たり前になっています。初心者でも早いうちに慣れておくと、後々役立ちます。
