Class alias: примеры (PHP)

Базовые примеры использования

class OriginalClass {}
class_alias('OriginalClass', 'NewClass');
$obj = new NewClass();
echo get_class($obj);

OriginalClass

namespace App\Models;
class User {}

class_alias('App\Models\User', 'Customer');
$customer = new Customer();
echo get_class($customer);

App\Models\User

class_alias('NonExistentClass', 'AliasClass', false);
echo class_exists('AliasClass') ? 'Существует' : 'Не существует';

Не существует

Альтернативы в PHP

Создание дочернего класса, который наследует функциональность родительского. Отличие: создает новый класс, а не псевдоним.

class Original {}
class Alias extends Original {}
$obj = new Alias();
echo get_class($obj);

Alias

Повторное использование кода через трейты. Подходит для горизонтального повторного использования, но не создает алиасы классов.

Использование eval() или анонимных классов для создания классов на лету. Более ресурсоемко и менее безопасно.

Аналоги в других языках

import module as alias
from module import Class as AliasClass

const Original = require('./original');
const Alias = Original;
// Или для конструкторов
function Original() {}
const Alias = Original;

CREATE VIEW alias_table AS SELECT * FROM original_table;

В Python и JavaScript алиасы создаются на уровне импорта или присваивания, а в PHP - на уровне времени выполнения с сохранением оригинального имени класса.

Типичные ошибки

class_alias('UndefinedClass', 'MyAlias');
// При autoload=true и отсутствии автозагрузчика
// Вызовет фатальную ошибку

class MyClass {}
class_alias('MyClass', 'MyClass');
// Предупреждение: нельзя создать алиас с именем существующего класса

if (false) {
    class_alias('Class1', 'Class2');
}
// Алиас не будет создан, так как условие ложно

Изменения в версиях PHP

Улучшена обработка ошибок при создании алиасов. Более строгая проверка типов аргументов.

Добавлена поддержка создания алиасов для внутренних классов движка PHP.

Появилась поддержка пространств имен, что расширило возможности использования class_alias.

Расширенные примеры

$classes = ['User', 'Product', 'Order'];
foreach ($classes as $class) {
    $alias = 'My' . $class;
    class_alias('App\Models\' . $class, $alias);
}
$obj = new MyUser();

class Original {}
class_alias('Original', 'Alias1');
class_alias('Alias1', 'Alias2');
$obj = new Alias2();
echo get_class($obj);

Original

class_alias('DateTime', 'MyDateTime');
$date = new MyDateTime();
echo get_class($date);

DateTime

class Test {}
class_alias('Test', 'TestAlias');
echo class_exists('TestAlias') ? 'Да' : 'Нет';
echo get_parent_class('TestAlias');

Да