Namespace hoạt động như thế nào trong PHP?

Question

Accepted Answer

**Namespace** tổ chức code PHP và ngăn **xung đột tên** giữa các class, hàm và hằng số — thiết yếu khi ứng dụng lớn lên và dùng các gói bên thứ ba. Chúng hoạt động như thư mục cho tên class, và tích hợp với autoload của Composer (PSR-4).

## Vấn đề mà namespace giải quyết

```text
Không có namespace, hai class cùng tên `User` (của bạn và của một thư viện) sẽ XUNG ĐỘT
("cannot redeclare class"). Namespace cho mỗi cái một tên đầy đủ định tính duy nhất.
```

## Khai báo và dùng namespace

```php
<?php
// khai báo một namespace ở đầu file (khớp với thư mục, PSR-4)
namespace App\Models;

class User {            // tên đầy đủ định tính: App\Models\User
    // ...
}
```

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

use App\Models\User;            // IMPORT một class để dùng tên ngắn của nó
use App\Services\Mailer as MailService;   // import với một BÍ DANH

class UserController {
    public function index() {
        $user = new User();      // tên ngắn dùng được nhờ `use` import
        // hoặc dùng tên đầy đủ định tính: new \App\Models\User();
    }
}
```

Một file khai báo `namespace` của nó, và các file khác `use` (import) class để tham chiếu chúng bằng tên ngắn. Tên đầy đủ định tính (`\App\Models\User`) là duy nhất toàn cục.

## Namespace ánh xạ sang thư mục (PSR-4)

```text
Namespace            Đường dẫn file
App\Models\User   →  src/Models/User.php
App\Services\Mailer → src/Services/Mailer.php
→ Autoload PSR-4: cấu trúc namespace phản chiếu cấu trúc thư mục, nên
  Composer có thể tìm và nạp mỗi class tự động (không cần require thủ công).
```

## Import hàm, hằng số và namespace toàn cục

```php
use function App\Helpers\format;     // import một hàm
use const App\Config\VERSION;        // import một hằng số

\strlen("x");    // dấu \ đứng đầu = namespace TOÀN CỤC (các hàm dựng sẵn)
```

## Tại sao điều này quan trọng

Namespace là thiết yếu để tổ chức code PHP hiện đại và là nền tảng cho cách toàn bộ hệ sinh thái hoạt động.

Hiểu chúng quan trọng vì chúng giải quyết vấn đề then chốt về **xung đột tên** — không có namespace, các class của bạn sẽ xung đột với nhau và với nhiều gói bên thứ ba mà một ứng dụng thực dùng (hai class `User` không thể cùng tồn tại), khiến các ứng dụng lớn và hệ sinh thái gói trở nên bất khả thi.

Namespace cho mỗi class một tên đầy đủ định tính duy nhất, và các **`use` import** cho phép bạn tham chiếu class bằng tên ngắn một cách gọn gàng.

Quan trọng nhất, namespace tích hợp với **autoload của Composer qua PSR-4**, nơi cấu trúc namespace phản chiếu cấu trúc thư mục để class được nạp tự động theo nhu cầu — đây là nền tảng của cấu trúc dự án PHP hiện đại và quản lý phụ thuộc.

Vì mọi framework, gói và ứng dụng PHP hiện đại đều được tổ chức bằng namespace (và bạn không thể dùng gói Composer mà không hiểu chúng), biết cách khai báo namespace, import class với `use`, và cách chúng ánh xạ sang thư mục cho autoload là kiến thức nền tảng, hằng ngày cho mọi phát triển PHP hiện đại.

Namespace, Composer và autoload PSR-4 cùng nhau định nghĩa cách các dự án PHP đương đại được cấu trúc.