Что такое «Пространство имён»

Пока проект маленький, имена не пересекаются. Но стоит подключить пару сторонних библиотек, и в каждой может оказаться свой класс Client или функция log(). Без пространств имён остаётся одно — придумывать префиксы: Acme_Shop_Delivery_Client. Пространства имён решают проблему системно: полное имя класса включает путь, например \Acme\Shop\Delivery\Client, а внутри своего пространства можно писать коротко.

Идея есть почти во всех языках: пакеты в Java, модули в Python, namespace в C++ и C#. Тот же принцип используют XML (атрибут xmlns), Kubernetes и ядро Linux — там это изолированные наборы ресурсов. Родственное понятие — область видимости, но она определяет, где имя доступно во время выполнения, а пространство имён — как оно называется полностью.

Объявление и импорт в PHP

В PHP пространства имён появились в версии 5.3. Объявление ставят в начале файла, а чужие классы подключают через use:

namespace Acme\Shop\Delivery;

use Bitrix\Main\Web\HttpClient;

class CdekClient
{
    public function __construct( private HttpClient $http ) {}
}

Ядро 1С-Битрикс D7 целиком лежит в пространстве \Bitrix\Main и соседних, у каждого модуля своё. Ядро WordPress, наоборот, исторически работает без них, поэтому в плагинах принято либо объявлять собственное пространство, либо начинать имена функций с префикса, характерного для этого плагина.

Автозагрузка по стандарту PSR-4

В современных PHP-проектах пространство имён совпадает со структурой папок, и класс подгружается автоматически при первом обращении. В composer.json это одна запись:

"autoload": { "psr-4": { "Acme\\Shop\\": "src/" } }

Класс Acme\Shop\Delivery\CdekClient ищется в файле src/Delivery/CdekClient.php. Частая ошибка — расхождение регистра букв: на Windows всё работает, а на Linux-сервере класс «не найден». Аккуратная структура пространств имён — одна из основ поддерживаемого кода, о чём подробнее на странице о PHP и backend-разработке.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Backend» ↗