Kif jaħdmu l-namespaces f'PHP?

Question

Accepted Answer

**Namespaces** jorganizzaw il-kod PHP u jipprevjenu **kolliżjonijiet ta' isem** bejn klassijiet, funzjonijiet u kostanti — essenzjali hekk kif l-applikazzjonijiet jikbru u jużaw pakketti ta' parti terza. Jaħdmu bħal directories għal ismijiet ta' klassijiet, u jintegraw mal-Composer autoloading (PSR-4).

## Il-problema li namespaces isolvu

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

## Tiddikjara u tuża l-namespaces

```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();
    }
}
```

Fajl iwaddal il-`namespace` tiegħu, u fajls oħra `use` (jimportaw) klassijiet biex jirreferixxu għalihom bi isem qasir. L-isem komplett (`\App\Models\User`) huwa uniku globalment.

## Namespaces jimappaw għal directories (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).
```

## Importazzjoni ta' funzjonijiet, kostanti, u l-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)
```

## Għaliex hu importanti

Namespaces huma essenzjali għall-organizzazzjoni tal-kod PHP moderni u huma fundamentali għal kif jaħdem l-intier ekosistema.

L-għarfien tiegħu huwa importanti għax isolvu l-problema kritikal tal-**kolliżjonijiet ta' isem** — mingħajr namespaces, il-klassijiet tiegħek jikollkizaw mal-ħadd u ma' ħafna pakketti ta' parti terza li applikazzjoni reali tuża (żewġ klassijiet `User` ma jistgħux jeżistu flimkien), ix-xejn li jagħmel applikazzjonijiet kbar u ekosistemi ta' pakketti impossibbli.

Namespaces jagħtu lil kull klassi isem komplett uniku, u l-**`use` imports** jippermettulek li tirreferi għal klassijiet bi ismijiet qosra bi ħelsien.

Aktar importanti, namespaces jintegraw mal-**Composer autoloading via PSR-4**, fejn l-istruttura ta' namespace tirrifletti l-istruttura ta' directory sabiex il-klassijiet jittalqaw awtomatikament fuq talba — din hija l-fondazzjoni tal-istruttura tal-projett PHP moderni u l-ġestjoni tal-dipendenza.

Sefax kull framework PHP moderni, pakkett, u applikazzjoni huma organizzati bi namespaces (u ma tistax tuża pakketti Composer mingħajr li tifhem), l-għarfien ta' kif tiddikjara namespaces, timporta klassijiet bi `use`, u kif jimappaw għal directories għall-autoloading huwa għarfien fundamentali, kuljum għal kwalunkwe żvilup PHP moderni.

Namespaces, Composer, u PSR-4 autoloading flimkien jiddefinixxu kif il-proġetti PHP kontemporanj huma strutturati.