Si funksionojnë emërtarot në PHP?

Question

Accepted Answer

**Emërtarët** organizojnë kodin PHP dhe parandalojnë **përplasjet e emërtimit** midis klasave, funksioneve dhe konstanteve — thelbësor ndërsa aplikacionet rriten dhe përdorin pakete të palëve të treta. Ata punojnë si direktori për emrat e klasave dhe integrohen me ngarkimin automatik të Composer-it (PSR-4).

## Problemi që emërtarët zgjidhin

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

## Deklarimi dhe përdorimi i emërtarëve

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

Një skedar deklaroi `namespace`-in e tij, dhe skedarë të tjerë `use` (importojnë) klasa për t'u referuar atyre me emër të shkurtër. Emri i plotë i kualifikuar (`\App\Models\User`) është globalisht unik.

## Emërtarët hartohen në 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).
```

## Importimi i funksioneve, konstanteve dhe emërtarit 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)
```

## Pse është i rëndësishëm

Emërtarët janë thelbësorë për organizimin e kodit PHP modern dhe janë themeli i mënyrës se si funksionon i gjithë ekosistemi.

Kuptimi i tyre është i rëndësishëm sepse ata zgjidhin problemin kritik të **përplasjes së emërtimit** — pa emërtarë, klasat tuaja do të konfliktojnë me njëra-tjetrën dhe me shumë paketa të palëve të treta që një aplikacion real përdor (dy klasa `User` nuk mund të ekzistojnë në të njëjtën kohë), duke e bërë të pamundur aplikacionet e mëdha dhe ekosistemet e paketave.

Emërtarët i japin çdo klase një emër unik të plotë të kualifikuar, dhe **importet `use`** ju lejojnë të referoheni klasave me emra të shkurtër në mënyrë të pastër.

Më e rëndësishmja, emërtarët integrohen me **ngarkimin automatik të Composer-it përmes PSR-4**, ku struktura e emërtarit reflekton strukturën e direktoeve në mënyrë që klasat të ngarkohen automatikisht sipas kërkesës — kjo është themeli i strukturës moderne të projektit PHP dhe menaxhimit të varësive.

Duke qenë se çdo kornizë PHP moderne, pakete dhe aplikacion është organizuar me emërtarë (dhe nuk mund të përdorni paketa Composer pa i kuptuar), të dini se si të deklaroni emërtarë, të importoni klasa me `use` dhe se si ato hartohen në direktori për ngarkimin automatik është njohuri themelore, përditësore për çdo zhvillim modern PHP.

Emërtarët, Composer-i dhe ngarkimi automatik PSR-4 së bashku përcaktojnë se si strukturohen projektet kontemporare PHP.