Conas a oibríonn namespaces i PHP?

Question

Accepted Answer

**Namespaces** eagraíonn siad cód PHP agus cuireann siad cosc ar **imbhuailtí ainmneacha** idir ranganna, feidhmeanna, agus tairisceáin — riachtanach de réir mar a fhásann feidhmchláir agus a úsáideann siad pacáistí tríú páirtí. Oibríonn siad cosúil le fillteáin do ainmneacha rang, agus cuirtear iad in oiriúnacht le uathloádáil Composer (PSR-4).

## An fhadhb a réitíonn namespaces

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

## Namespaces a fhógairt agus a úsáid

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

Déanann comhad a `namespace` a fhógairt, agus déanann comhaid eile `use` (iompórtáil) ar ranganna chun iad a bhaint amach le gearrainm. Is é an t-ainm iomlán-cháilíochtúil (`\App\Models\User`) uathúil ar fud an domhain.

## Namespaces a bhreacadh ar dhréachtoirí (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).
```

## Feidhmeanna, tairisceáin, agus an namespace domhanda a iompórtáil

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

## Cén fáth a bhíonn tábhacht air

Is riachtanach iad namespaces chun cód PHP nua-aimseartha a eagrú agus is bunúsach iad do an chaoi ar oibríonn an ecósistéim ar fad.

Tá sé tábhachtach iad a thuiscint toisc go réitíonn siad an fhadhb chriticiúil de **imbhuailtí ainmneacha** — gan namespaces, bheadh imbhuailt idir do ranganna agus a chéile agus idir na go leor pacáistí tríú páirtí a úsáideann feidhmchlár fíor (ní féidir dhá rang `User` a bheith ann san am céanna), rud a dhéanann feidhmchláir mór agus ecósistéim pacáistí dodhéanta.

Tugann namespaces ainm iomlán-cháilíochtúil uathúil do gach rang, agus tugann na **hiompórtálacha `use`** duit ranganna a thagartha le gearrainm go soiléir.

Ar an tslí is tábhachtaí, cuirtear namespaces in oiriúnacht le **uathloádáil Composer trí PSR-4**, áit ar dhéanann struchtúr an namespace scáthchéim ar struchtúr an dhréachtóra ionas go n-uathloádaítear ranganna ar éileamh — seo an bonn de struchtúr thionscadail PHP nua-aimseartha agus bainistiú spleáchais.
\\
í féidir aon fhramework nua-aimseartha PHP, pacáiste, nó feidhmchlár a eagrú gan namespaces (agus ní féidir pacáistí Composer a úsáid gan iad a thuiscint), tá eolas ar an chaoi ar fhógairt namespaces, ranganna a iompórtáil le `use`, agus an chaoi ar dhéanann siad scáthchéim ar dhréachtoirí le haghaidh uathloádála ina eolas bunúsach, laethúil do aon fhorbróir PHP nua-aimseartha.

Sainmhíníonn Namespaces, Composer, agus uathloádáil PSR-4 le chéile an chaoi ar eagraítear tionscadail PHP comhaimseartha.