class_alias

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

class_alias — Cria um apelido para uma classe

Descrição

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

Criando um apelido com o nome informado em alias com base na classe definida pelo usuário class. A classe com apelido é exatamente igual à classe original.

Note: A partir do PHP 8.3.0, class_alias() também suporta a criação de um apelido de uma classe interna do PHP.

Parâmetros

class

A classe original.

alias

O nome do alias da classe.

autoload

Se deve-se carregar automaticamente caso a classe original não seja encontrada.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.3.0 class_alias() agora suporta criação de apelido de uma classe interna.

Exemplos

Example #1 Exemplo de class_alias()

<?php

class Foo { }

class_alias('Foo', 'Bar');

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

// os objetos são os mesmos
var_dump($a == $b, $a === $b);
var_dump($a instanceof $b);

// as classes são as mesmas
var_dump($a instanceof Foo);
var_dump($a instanceof Bar);

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

?>

O exemplo acima produzirá:

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

Notas

Note:

Nomes de classe não são sensíveis a maiúsculas/minúsculas no PHP, e isto é refletido nesta função. Apelidos criados por class_alias() são declarados em minúsculas. Isto significa que para uma classe MinhaClasse, a chamada a class_alias('MinhaClasse', 'ApelidoDaMinhaClasse') irá declarar um novo apelido de classe chamado apelidodaminhaclasse.

Veja Também