PHPのnamespace（名前空間）を使ってコードを整理する方法を初心者向けに解説！
生徒
「PHPのnamespaceって何のために使うんですか？難しそうで…」
先生
「確かに名前空間は最初は難しく感じますが、複数のクラスや関数があるプロジェクトを整理するのにとても役立つ機能なんですよ。」
生徒
「クラス名がかぶるのを防ぐって聞いたことがありますが、どういうことですか？」
先生
「それじゃあ、今日はPHPのnamespace（名前空間）について、わかりやすい例を使って丁寧に説明していきましょう！」
1. PHPのnamespace（名前空間）とは？
PHPのnamespace（名前空間）を一言でいうと、プログラム内の「名前の衝突」を防ぐための「住所」のような仕組みです。プログラミング初心者の方でも、パソコンの「フォルダ（ディレクトリ）」をイメージすると分かりやすくなります。
例えば、デスクトップに「メモ.txt」というファイルが2つあったら、どちらが最新か分からなくなりますし、そもそも同じ場所に同じ名前のファイルは作れませんよね。でも、「仕事用」フォルダと「プライベート用」フォルダに分ければ、両方に「メモ.txt」を置くことができます。これと同じ役割をコード上で行うのが名前空間です。
「田中さん」という名前の人が2人いたら、呼びかけるときに困ります。しかし、「1年1組の田中さん」と「2年3組の田中さん」のように所属（クラス）を付け加えれば、どちらを指しているか明確に区別できます。PHPの世界では、この「組」にあたるのが
namespaceです。
プログラミングが大規模になると、自分が作ったクラス名と、他の人が作った便利なプログラム（ライブラリ）のクラス名が偶然一致してしまうことがあります。名前空間を適切に設定しておくことで、システムが「どっちのクラスを使えばいいの？」と混乱してエラーになるのを未然に防ぎ、コードの整理整頓ができるようになります。
// 名前空間を使わない場合（同じ名前は1つしか作れない）
class User { }
// class User { } // ← ここで「既に存在します」というエラーが発生する
このように、namespaceは大人数での開発や、複雑なシステムを作る上で欠かせない「整理術」なのです。それでは、具体的にどのようにコードを書いていくのか見ていきましょう。
2. namespaceの基本的な使い方
PHPで名前空間（namespace）を定義するのは非常に簡単です。PHPファイルの最も先頭（<?phpのすぐ下）に、namespaceというキーワードに続けて、そのファイルの「住所」となる名前を書くだけで完了します。
namespaceよりも前にコード（HTMLや空白行を含む）を書いてはいけません。必ずファイルの1行目に記述するというルールを覚えておきましょう。
まずは、一番シンプルな書き方を見てみましょう。ここでは「お菓子作り（Cooking）」という名前の空間を作って、その中に「クッキー（Cookie）」というクラスを作ってみます。
namespace Cooking;
// このクラスは「Cooking」という住所（名前空間）に所属します
class Cookie {
public function eat() {
echo "サクサクのクッキーを食べました！";
}
}
このように記述することで、このCookieクラスの正式名称は、単なる「Cookie」ではなく、名前空間を含めた「Cooking\Cookie」になります。
また、フォルダのように階層を深くすることもできます。例えば、「アプリの中の、コントローラーという役割の場所」を指す場合は、バックスラッシュ（\）を使って区切ります。
namespace App\Controllers;
class UserController {
public function index() {
echo "ユーザー一覧を表示します。ここはAppフォルダ内のControllersという住所です。";
}
}
プログラミング未経験の方でも、「どのグループに属しているプログラムなのか」を1行目で宣言しているだけ、と考えるとイメージしやすいはずです。この1行があるおかげで、後から同じ「UserController」という名前のファイルが出てきても、住所が違えばエラーにならずに済むようになります。
3. 同じ名前のクラスが複数あるときの例
PHPで開発を進めていると、自分以外の人が作ったプログラムを組み合わせて使うことがよくあります。その際、偶然にも「クラスの名前が全く同じになってしまう」というトラブルが起こり得ます。
<p>例えば、大規模なプロジェクトで「Aチーム」と「Bチーム」がそれぞれユーザー情報を管理するプログラムを作ったとしましょう。どちらのチームも、自然な流れでクラス名を <code>User</code> と名付けてしまいました。もし <code>namespace</code> がなければ、PHPは「どちらのUserを使えばいいのかわからない！」と混乱してエラーを出し、システムが止まってしまいます。</p> <div class="row"> <div class="col-md-6"> <div class="card shadow-sm mb-3"> <div class="card-header bg-primary text-white">Aチームが作成</div> <div class="card-body">
namespace TeamA;
class User {
public function hello() {
echo "こちらは【TeamA】のUserクラスです。";
}
}
