final
A palavra-chave final evita que classes filhas sobrescrevam um método, propriedade ou constante
prefixando a definição com final
. Se a própria
classe estiver definida como final, ela não pode ser estendida.
Example #1 Exemplo de método final
<?php
class ClasseBase {
public function teste() {
echo "ClasseBase::teste() chamado\n";
}
final public function maisTeste() {
echo "ClasseBase::maisTeste() chamado\n";
}
}
class ClasseFilha extends ClasseBase {
public function maisTeste() {
echo "ClasseFilha::maisTeste() called\n";
}
}
// Resulta em erro fatal: Não é possível substituir o método final ClasseBase::maisTeste()
?>
Example #2 Exemplo de classe final
<?php
final class ClasseBase {
public function teste() {
echo "Método ClasseBase::teste() chamado\n";
}
// Como a classe já é final, a palavra-chave final é rendundante.
final public function maisTeste() {
echo "Método ClasseBase::maisTeste() chamado\n";
}
}
class ClasseFilha extends ClasseBase {
}
// Resulta em erro fatal: Classe ClasseFilha não pode herdar da classe final (ClasseBase)
?>
Example #3 Exemplo de propriedade final a partir do PHP 8.4.0
<?php
class ClasseBase {
final protected string $teste;
}
class ClasseFilha extends ClasseBase {
public string $teste;
}
// Resulta em erro fatal: Não é possível substituir a propriedade final ClasseBase::$teste
?>
Example #4 Exemplo de constante final a partir do PHP 8.1.0
<?php
class Foo
{
final public const X = "foo";
}
class Bar extends Foo
{
public const X = "bar";
}
// Erro fatal: Bar::X não pode substituir a constante final Foo::X
?>
Note: A partir do PHP 8.0.0, métodos privados não podem ser declarados finais, com exceção do construtor.
Note: Uma propriedade que é declarada
private(set)
é, implicitamente,final
.