Bagaimanakah namespace berfungsi dalam PHP?

Question

Accepted Answer

**Namespace** mengatur kod PHP dan mencegah **pertembungan nama** antara kelas, fungsi, dan pemalar — penting ketika aplikasi berkembang dan menggunakan paket pihak ketiga. Ia berfungsi seperti direktori untuk nama kelas, dan bersepadu dengan autoloading Composer (PSR-4).

## Masalah yang namespace selesaikan

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

## Mengisytihar dan menggunakan 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();
    }
}
```

Sebuah fail mengisytiharkan `namespace` miliknya, dan fail lain `use` (import) kelas untuk merujuknya dengan nama pendek. Nama lengkap (`\App\Models\User`) adalah unik secara global.

## Namespace memetakan ke direktori (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).
```

## Mengimport fungsi, pemalar, dan namespace global

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

## Mengapa ia penting

Namespace adalah penting untuk mengatur kod PHP moden dan adalah asas bagi cara seluruh ekosistem berfungsi.

Memahami mereka adalah penting kerana mereka menyelesaikan masalah kritikal **pertembungan nama** — tanpa namespace, kelas Anda akan bertentangan antara satu sama lain dan dengan banyak paket pihak ketiga yang digunakan aplikasi sebenar (dua kelas `User` tidak boleh wujud bersama-sama), menjadikan aplikasi besar dan ekosistem paket mustahil.

Namespace memberikan setiap kelas nama lengkap yang unik, dan **`use` import** membenarkan Anda merujuk kelas dengan nama pendek dengan bersih.

Paling penting, namespace bersepadu dengan **autoloading Composer melalui PSR-4**, di mana struktur namespace mencerminkan struktur direktori supaya kelas dimuat secara automatik apabila diperlukan — ini adalah asas struktur projek PHP moden dan pengurusan kebergantungan.

Kerana setiap rangka kerja PHP moden, paket, dan aplikasi disusun dengan namespace (dan Anda tidak dapat menggunakan paket Composer tanpa memahaminya), mengetahui cara mengisytiharkan namespace, mengimport kelas dengan `use`, dan cara mereka memetakan ke direktori untuk autoloading adalah pengetahuan asas dan harian untuk sebarang pembangunan PHP moden.

Namespace, Composer, dan autoloading PSR-4 bersama-sama menentukan bagaimana projek PHP kontemporari disusun.