PHP の名前空間（namespace）はどのように機能しますか？

Question

Accepted Answer

**名前空間（namespace）** は PHP コードを整理し、クラス、関数、定数間の **名前の衝突** を防ぎます — アプリケーションが成長し、サードパーティパッケージを使用する際に必須です。クラス名用のディレクトリのように機能し、Composer オートローディング（PSR-4）と統合されています。

## 名前空間が解決する問題

```text
Without namespaces, two classes named `User` (yours and a library's) would COLLIDE
("cannot redeclare class"). Namespaces give each a unique fully-qualified name.
```

## 名前空間の宣言と使用

```php
<?php
// declare a namespace at the top of the file (matches the directory, PSR-4)
namespace App\Models;

class User {            // fully-qualified name: App\Models\User
    // ...
}
```

```php
<?php
namespace App\Controllers;

use App\Models\User;            // IMPORT a class so you can use its short name
use App\Services\Mailer as MailService;   // import with an ALIAS

class UserController {
    public function index() {
        $user = new User();      // short name works thanks to the `use` import
        // or use the fully-qualified name: new \App\Models\User();
    }
}
```

ファイルは `namespace` を宣言し、他のファイルは `use`（インポート）でクラスを短い名前で参照します。完全修飾名（`\App\Models\User`）はグローバルに一意です。

## 名前空間はディレクトリにマップされます（PSR-4）

```text
Namespace            File path
App\Models\User   →  src/Models/User.php
App\Services\Mailer → src/Services/Mailer.php
→ PSR-4 autoloading: the namespace structure mirrors the folder structure, so
  Composer can find and load each class automatically (no manual require).
```

## 関数、定数、グローバル名前空間のインポート

```php
use function App\Helpers\format;     // import a function
use const App\Config\VERSION;        // import a constant

\strlen("x");    // a leading \ = the GLOBAL namespace (built-in functions)
```

## なぜ重要なのか

名前空間は、モダンな PHP コードを整理するために不可欠であり、エコシステム全体の動作に基本的です。

理解することが重要なのは、**名前の衝突** という重大な問題を解決するためです — 名前空間なしでは、クラスが互いに競合し、実際のアプリケーションが使用する多くのサードパーティパッケージとも競合します（2 つの `User` クラスは共存できません）。これは大規模なアプリケーションとパッケージエコシステムを不可能にします。

名前空間は、すべてのクラスに一意の完全修飾名を与えます。また、**`use` インポート** により、クラスを短い名前で簡潔に参照できます。

最も重要なのは、名前空間が **Composer オートローディング（PSR-4）** と統合されることです。名前空間の構造がディレクトリ構造を反映するため、クラスがオンデマンドで自動的にロードされます — これがモダンな PHP プロジェクト構造と依存関係管理の基盤です。

すべてのモダンな PHP フレームワーク、パッケージ、アプリケーションは名前空間で整理されています（Composer パッケージを使用する場合、これを理解なしに使うことはできません）。したがって、名前空間を宣言する方法、`use` でクラスをインポートする方法、オートローディング用にディレクトリにマップされる方法を理解することは、モダンな PHP 開発を行うための基本的で日常的な知識です。

名前空間、Composer、PSR-4 オートローディングは、現代的な PHP プロジェクトの構造を定義しています。