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.

Exemplo #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()
?>

Exemplo #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)
?>

Exemplo #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
?>

Exemplo #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
?>

Nota: A partir do PHP 8.0.0, métodos privados não podem ser declarados finais, com exceção do construtor.

Nota: Uma propriedade que é declarada private(set) é, implicitamente, final.