namespaces ใน PHP ทำงานอย่างไร?

Question

Accepted Answer

**Namespaces** จัดระเบียบโค้ด PHP และป้องกัน **การชนกันของชื่อ (naming collisions)** ระหว่างคลาส ฟังก์ชัน และค่าคงที่ ซึ่งจำเป็นเมื่อแอปพลิเคชันเติบโตขึ้นและใช้แพ็กเกจจากภายนอก มันทำงานเหมือนไดเรกทอรีสำหรับชื่อคลาส และทำงานร่วมกับ Composer autoloading (PSR-4)

## ปัญหาที่ namespace แก้ไข

```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.
```

## การประกาศและใช้ namespace

```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` (import) คลาสเพื่ออ้างถึงด้วยชื่อสั้น fully-qualified name (`\App\Models\User`) มีเอกลักษณ์เฉพาะในระดับ global

## namespace แมปกับไดเรกทอรี (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).
```

## การ import ฟังก์ชัน, ค่าคงที่ และ global namespace

```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)
```

## ทำไมจึงสำคัญ

Namespaces จำเป็นต่อการจัดระเบียบโค้ด PHP สมัยใหม่ และเป็นพื้นฐานของวิธีที่ระบบนิเวศทั้งหมดทำงาน

การเข้าใจมันสำคัญเพราะแก้ปัญหาวิกฤตของ **การชนกันของชื่อ** หากไม่มี namespace คลาสของคุณจะขัดแย้งกันเองและกับแพ็กเกจจากภายนอกจำนวนมากที่แอปพลิเคชันจริงใช้ (คลาส `User` สองคลาสอยู่ร่วมกันไม่ได้) ทำให้แอปพลิเคชันขนาดใหญ่และระบบนิเวศแพ็กเกจเป็นไปไม่ได้

Namespace ให้ทุกคลาสมี fully-qualified name ที่เป็นเอกลักษณ์ และ **`use` import** ช่วยให้คุณอ้างถึงคลาสด้วยชื่อสั้นได้อย่างสะอาดตา

ที่สำคัญที่สุด namespace ทำงานร่วมกับ **Composer autoloading ผ่าน PSR-4** ที่โครงสร้าง namespace สะท้อนโครงสร้างไดเรกทอรี ดังนั้นคลาสจึงถูกโหลดอัตโนมัติตามความต้องการ นี่คือรากฐานของโครงสร้างโปรเจกต์ PHP สมัยใหม่และการจัดการ dependency

เนื่องจากเฟรมเวิร์ก แพ็กเกจ และแอปพลิเคชัน PHP สมัยใหม่ทุกตัวจัดระเบียบด้วย namespace (และคุณใช้แพ็กเกจ Composer ไม่ได้หากไม่เข้าใจมัน) การรู้วิธีประกาศ namespace, import คลาสด้วย `use` และวิธีที่มันแมปกับไดเรกทอรีเพื่อ autoloading จึงเป็นความรู้พื้นฐานในชีวิตประจำวันสำหรับการพัฒนา PHP สมัยใหม่ใด ๆ

Namespace, Composer และ PSR-4 autoloading รวมกันเป็นตัวกำหนดวิธีที่โปรเจกต์ PHP ร่วมสมัยถูกจัดโครงสร้าง