Пространства имён

Понятие пространств имен позволяет давать элементам системы более четкие имена, избавиться от множества префиксов имен, а также избежать потенциальных конфликтов. Все классы, поставляемые в стандартном дистрибутиве, должны находиться в пространстве имен Bitrix, которое не пересекается ни с PHP, ни с разработками партнёров. Каждый стандартный модуль определяет в пространстве имен Bitrix свое подпространство, совпадающее с именем модуля. Например, для модуля forum пространством имен будет Bitrix\Forum, а для модуля main - Bitrix\Main.

namespace Asd\Metrika;  
 
class CountersTable extends Entity\DataManager  
{  
   ....

\Asd\Metrika\CountersTable::update();

При необходимости модуль может организовывать подпространства внутри своего пространства имен. Например, Bitrix\Main\IO, Bitrix\Forum\SomeName\SomeNameTwo. Но такой возможностью следует пользоваться только если это оправдано для организации правильной архитектуры данного модуля.

Правила наименования

• Пространства имен должны именоваться "ВерхнимКэмелКейсом".
• Не могут содержать в названии никаких символов, кроме букв латинского алфавита.
• Название класса должно быть существительным. Надо стараться избегать ненужных сокращений и аббревиатур.

Примеры:

namespace Bitrix\Main\Localization;
namespace Bitrix\Main\Entity\Validator;

Сокращения, не являющиеся общепринятыми (в Bitrix Framework), использовать нельзя.

Допустимо сокращение полной записи. Вместо \Bitrix\Main\Class::Function() можно писать Main\Class::Function().

Также допустимо и использование синонимов, вместо длинных пространств имен. Для этого необходимо использовать use. Например, мы имеем длинную конструкцию:

\Bitrix\Main\Localization\Loc::getMessage("NAME");

Чтобы сократить ее, объявим в начале файла синоним и далее уже будем использовать сокращенный вариант вызова:

use \Bitrix\Main\Localization\Loc;
...
Loc::getMessage("NAME");