array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.class-alias.php', 1 => 'class_alias', 2 => 'Создаёт псевдоним класса', ), 'up' => array ( 0 => 'ref.classobj.php', 1 => 'Функции работы с классами и объектами', ), 'prev' => array ( 0 => 'function.autoload.php', 1 => '__autoload', ), 'next' => array ( 0 => 'function.class-exists.php', 1 => 'class_exists', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/classobj/functions/class-alias.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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. Класс-псевдоним — тот же исходный класс.

Зарезервированные слова нельзя указывать как псевдоним класса.

Замечание: C PHP 8.3.0 функция class_alias() стала поддерживать псевдонимирование внутренних классов PHP.

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

class

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

alias

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

autoload

Требуется ли выполнять автоматическую загрузку класса, если PHP не нашёл исходный класс.

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

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия Описание
8.3.0 Функция class_alias() теперь умеет создавать псевдоним для внутреннего класса.

Примеры

Пример #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.

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