Как работают пространства имён в PHP?

Question

Accepted Answer

**Пространства имён** организуют код PHP и предотвращают **конфликты имён** между классами, функциями и константами — это критически важно по мере роста приложений и использования сторонних пакетов. Они работают как директории для имён классов и интегрируются с автозагрузкой Composer (PSR-4).

## Проблема, которую решают пространства имён

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

## Объявление и использование пространств имён

```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`) глобально уникально.

## Пространства имён отображаются на директории (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).
```

## Импорт функций, констант и глобального пространства имён

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

## Почему это важно

Пространства имён необходимы для организации современного кода PHP и являются фундаментом того, как устроена вся экосистема.

Уметь их использовать важно, потому что они решают критическую проблему **конфликтов имён** — без пространств имён ваши классы будут конфликтовать друг с другом и с множеством сторонних пакетов, которые использует реальное приложение (два класса `User` не могут сосуществовать), что делает большие приложения и экосистему пакетов невозможными.

Пространства имён дают каждому классу уникальное полностью квалифицированное имя, а **импорты `use`** позволяют вам ссылаться на классы по сокращённым именам чисто и удобно.

Самое главное — пространства имён интегрируются с **автозагрузкой Composer через PSR-4**, где структура пространства имён отражает структуру директорий, поэтому классы загружаются автоматически по требованию — это основа современной структуры PHP-проектов и управления зависимостями.

Поскольку каждый современный PHP-фреймворк, пакет и приложение организованы с использованием пространств имён (и вы не можете использовать пакеты Composer без их понимания), умение объявлять пространства имён, импортировать классы с `use` и знание того, как они отображаются на директории для автозагрузки — это фундаментальное, повседневное знание для любого современного PHP-разработчика.

Пространства имён, Composer и автозагрузка PSR-4 вместе определяют, как структурируются современные PHP-проекты.