Home/ Manual/ classobj / functions/ class_alias

class_alias

PHP function Edit on GitHub ✎

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

Creates an alias for a class

Description

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

Creates an alias named alias based on the user defined class class. The aliased class is exactly the same as the original class.

The class alias cannot be any of the PHP reserved words.

Note

As of PHP 8.3.0, class_alias() also supports creating an alias of a PHP internal class.

Parameters

class: The original class.
alias: The alias name for the class.
autoload: Whether to autoload if the original class is not found.

Return Values

Success

Changelog

Version	Description
8.3.0	`class_alias()` now supports creating an alias of an internal class.

Examples

class_alias() example

php

<?php

class Foo { }

class_alias('Foo', 'Bar');

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

// the objects are the same
var_dump($a == $b, $a === $b);
var_dump($a instanceof $b);

// the classes are the same
var_dump($a instanceof Foo);
var_dump($a instanceof Bar);

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

?>

The above example will output:

output

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

Notes