Пространства имён: псевдонимирование и импорт

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    Способность ссылаться на внешнее абсолютное имя по псевдониму или импортировать внешние абсолютные имена — это важное свойство пространств имён. Это похоже на способность файловых систем на основе Unix создавать символические ссылки на файл или директорию.

    PHP умеет создавать псевдонимы или импортировать константы, функции, классы, интерфейсы, трейты, перечисления и пространства имён.

    Псевдоним имени создают через ключевое слово use. Вот пример, который показывает 5 типов импорта:

    Пример #1 Импорт или псевдонимирование через ключевое слово use

    <?php

    namespace foo;

    use     My\Full\Classname as Another;

    // Это то же, что и My\Full\NSname as NSname
    use My\Full\NSname;

    // Импортирование глобального класса
    use ArrayObject;

    // Импортирование функции
    use function My\Full\functionName;

    // Создание псевдонима функции
    use function My\Full\functionName as func;

    // Импортирование константы
    use const My\Full\CONSTANT;

    $obj = new namespace\Another; // Создаёт экземпляр класса foo\Another
    $obj = new Another; // Создаёт объект класса My\Full\Classname
    NSname\subns\func(); // Вызывает функцию My\Full\NSname\subns\func

    $a = new ArrayObject(array(1)); // Создаёт объект класса ArrayObject
    // без выражения use ArrayObject был бы создан объект класса foo\ArrayObject

    func(); // вызывает функцию My\Full\functionName
    echo CONSTANT; // выводит содержимое константы My\Full\CONSTANT

    ?>
    Обратите внимание, что именам внутри пространства имён (абсолютным именам пространств имён, которые содержат разделитель пространств имён, например Foo\Bar, в отличие от глобальных имён, которые его не содержат, например FooBar) начальный обратный слеш (\) не нужен и не рекомендован, поскольку импортируемые имена должны быть абсолютными и не обрабатываются относительно текущего пространства имён.

    PHP дополнительно поддерживает удобное сокращение для задания нескольких операторов use в одной и той же строке

    Пример #2 Импорт или создание псевдонима через ключевое слово use, комбинирование нескольких выражений

    <?php

    use My\Full\Classname as Another, My\Full\NSname;

    $obj = new Another; // Создаёт объект класса My\Full\Classname
    NSname\subns\func(); // Вызывает функцию My\Full\NSname\subns\func

    ?>

    Импорт выполняется во время компиляции поэтому не влияет на имена динамических классов, функций или констант.

    Пример #3 Импорт и динамические имена

    <?php

    use My\Full\Classname as Another, My\Full\NSname;

    $obj = new Another; // Создаёт объект класса My\Full\Classname
    $a = 'Another';
    $obj = new $a; // Создаёт объект класса Another

    ?>

    В дополнение, импорт распространяется только на неполные и полные имена. На абсолютные имена операция импорта не влияет.

    Пример #4 Импортирование и абсолютные имена

    <?php

    use My\Full\Classname as Another, My\Full\NSname;

    $obj = new Another; // Создаёт объект класса My\Full\Classname
    $obj = new \Another; // Создаёт объект класса Another
    $obj = new Another\thing; // Создаёт объект класса My\Full\Classname\thing
    $obj = new \Another\thing; // Создаёт объект класса Another\thing

    ?>

    Обзор правил для импорта

    Ключевое слово use должно быть указано в самом начале файла (в глобальной области) или внутри объявления пространства имён. Это нужно, потому что импорт выполняется во время компиляции, а не во время исполнения, поэтому его нельзя ограничить блоком кода. Следующий пример показывает недопустимое указание ключевого слова use:

    Пример #5 Недопустимое правило импорта

    <?php

    namespace Languages;

    function     toGreenlandic()
    {
    use     Languages\Danish;

    //...
    }

    ?>

    Замечание:

    Правила импорта задают на каждый файл отдельно. Поэтому присоединяемые файлы НЕ будут наследовать правила импорта из родительского файла.

    Групповые объявления через ключевое слово use

    Классы, функции и константы, импортируемые из одного и того же пространства имён (namespace), разрешено группировать в одном выражении с ключевым словом use.

    <?php

    use some\namespace\ClassA;
    use     some\namespace\ClassB;
    use     some\namespace\ClassC as C;

    use function     some\namespace\fn_a;
    use function     some\namespace\fn_b;
    use function     some\namespace\fn_c;

    use const     some\namespace\ConstA;
    use const     some\namespace\ConstB;
    use const     some\namespace\ConstC;

    // Эквивалентно следующему групповому объявлению с ключевым словом use
    use some\namespace\{ClassA, ClassB, ClassC as C};
    use function     some\namespace\{fn_a, fn_b, fn_c};
    use const     some\namespace\{ConstA, ConstB, ConstC};
    To Top