Что такое «Пространство имён»
Пока проект маленький, имена не пересекаются. Но стоит подключить пару сторонних библиотек, и в каждой может оказаться свой класс 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

