როგორ მუშაობს namespaces PHP-ში?

Question

Accepted Answer

**Namespaces** აწყობს PHP კოდს და ხელს უშლის **სახელწოდების კონფლიქტებს** კლასებს, ფუნქციებსა და მუდმივებს შორის — აუცილებელი როდესაც აპლიკაციები იზრდება და იყენებენ მესამე მხარის პაკეტებს. ისინი მოქმედებენ როგორც დირექტორიები კლასების სახელებისთვის და ინტეგრირებულია Composer autoloading-ის საথ (PSR-4).

## პრობლემა, რომელიც 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-ის დეკლარირება და გამოყენება

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

ფაილი დეკლარირებს თავის `namespace`-ს, ხოლო სხვა ფაილები `use` (იმპორტ) აკეთებენ კლასებს, რათა მათზე მოკლე სახელით მიმართონ. სრული სახელი (`\App\Models\User`) უნიკალურია გლობალურად.

## Namespaces ემთხვევა დირექტორიებს (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).
```

## ფუნქციების, მუდმივების და გლობალური 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)
```

## რატომ მნიშვნელოვანია

Namespaces აუცილებელი მოდერნული PHP კოდის დასამწყობებლად და ფუნდამენტალური მთელი ეკოსისტემის ფუნქციონირებისთვის.

მათი გაგება მნიშვნელოვანია, რადგან ისინი ხსნის **სახელწოდების კონფლიქტის** კრიტიკულ პრობლემას — namespaces-ის გარეშე, თქვენი კლასები ერთმანეთის და მნიშვნელოვნად მეტი მესამე მხარის პაკეტის კონფლიქტში შედიოდა, რომელსაც რეალური აპლიკაცია იყენებს (ორი `User` კლასი არ შეიძლება ერთდროულად არსებობდეს), რაც დიდი აპლიკაციებსა და პაკეტის ეკოსისტემებს შეუძლებელი ხდის.

Namespaces თითოეულ კლასს უნიკალური სრული სახელი აძლევს, ხოლო **`use` იმპორტი** საშუალებას გაძლევთ კლასებს მოკლე სახელებით წაფლებით მიმართოთ.

ყველაზე მნიშვნელოვანი, namespaces ინტეგრირებულია **Composer autoloading-ის სათ PSR-4-ის მეშვეობით**, სადაც namespace სტრუქტურა ემთხვევა დირექტორიის სტრუქტურას, ასე რომ კლასები თვითონ იტვირთებიან მოთხოვნის სახით — ეს არის მოდერნული PHP პროექტის სტრუქტურისა და დამოკიდებულების მართვის საფუძველი.

როგორც ყველა მოდერნული PHP ფრეიმვორკი, პაკეტი და აპლიკაცია ორგანიზებულია namespaces-თან (და თქვენ არ შეგიძლიათ Composer პაკეტის გამოყენება მათი გაგების გარეშე), namespaces-ის დეკლარირება, კლასების იმპორტი `use`-ის სამეშვეობით და როგორ ემთხვევა ისინი დირექტორიებს autoloading-ის საზე ცოდნა ფუნდამენტალური, ყოველდღიური კითხვაა ნებისმიერი მოდერნული PHP განვითარებისთვის.

Namespaces, Composer და PSR-4 autoloading ერთად განსაზღვრავს თუ როგორ არის სტრუქტურირებული ციდან PHP პროექტები.