class_alias

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

class_alias — Создаёт псевдоним для указанного класса

Описание

class_alias(string $class, string $alias, bool $autoload = true): bool

Создаёт псевдоним alias для пользовательского класса class. Новый класс с псевдонимом будет точно таким же, как и оригинальный класс.

Список параметров

class

Оригинальный класс.

alias

Имя псевдонима для класса.

autoload

Нужно ли автоматически подгружать класс, если он ещё не загружен.

Возвращаемые значения

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования class_alias()

<?php

class Foo { }

class_alias('Foo', 'Bar');

$a = new Foo;
$b = new Bar;

// объекты одинаковы
var_dump($a == $b, $a === $b);
var_dump($a instanceof $b);

// классы одинаковы
var_dump($a instanceof Foo);
var_dump($a instanceof Bar);

var_dump($b instanceof Foo);
var_dump($b instanceof Bar);

?>

Результат выполнения данного примера:

bool(true)
bool(false)
bool(true)
bool(true)
bool(true)
bool(true)
bool(true)

Примечания

Замечание:

Имена классов в PHP не зависят от регистра, что и отражено в данной функции. Псевдонимы, создаваемые функцией class_alias(), объявляются в нижнем регистре. Это означает, что для класса MyClass вызов class_alias('MyClass', 'MyClassAlias') объявит новый псевдоним класса с именем myclassalias.

Смотрите также

  • get_parent_class() - Возвращает имя родительского класса для объекта или класса
  • is_subclass_of() - Проверяет, содержит ли объект в своём дереве предков указанный класс либо прямо реализует его