Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

get_class()

A função get_class devolve o nome real da classe do objeto com espaço de nomes e sem barra invertida inicial.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

get_class(object $object = ?): string

A função get_class devolve o nome real da classe do objeto com espaço de nomes e sem barra invertida inicial. Um método herdado que inspeciona $this vê a subclasse concreta. Passar um nome de classe textual em vez do objeto lança TypeError. Desde PHP 8.3 a forma sem argumentos dentro de uma classe está obsoleta e indica o âmbito da declaração. Sem argumento dentro de um método, é emitido E_DEPRECATED e obtém-se a classe que declara o método. Fora de uma classe, a omissão provoca Error.

Assinatura

get_class(object $object = ?): string

Saída do exemplo

Guide\Detail
TypeError
deprecated Guide\BaseRow
Error

Exemplos

<?php
namespace Guide;
class BaseRow {
    public function name(): string { return get_class($this); }
    public function declared(): string { return get_class(); }
}
class Detail extends BaseRow {}
echo (new Detail())->name(), PHP_EOL;
try { get_class(Detail::class); } catch (\TypeError $e) { echo get_class($e), PHP_EOL; }
set_error_handler(static function (int $level): bool {
    echo $level === E_DEPRECATED ? "deprecated " : "other ";
    return true;
});
try { echo (new Detail())->declared(), PHP_EOL; } finally { restore_error_handler(); }
try { get_class(); } catch (\Error $e) { echo get_class($e); }

Resultado

Guide\Detail
TypeError
deprecated Guide\BaseRow
Error

Fontes