Le mot-clé final
empêche les classes enfants de redéfinir
une méthode, une propriété ou constante en préfixant la définition avec
final
. Si la classe elle-même est
définie comme finale, elle ne pourra pas être étendue.
Exemple #1 Exemple de méthode finale
<?php
class BaseClass {
public function test() {
echo "BaseClass::test() appelée\n";
}
final public function moreTesting() {
echo "BaseClass::moreTesting() appelée\n";
}
}
class ChildClass extends BaseClass {
public function moreTesting() {
echo "ChildClass::moreTesting() appelée\n";
}
}
// Résultat : Fatal error: Cannot override final method BaseClass::moreTesting()
?>
Exemple #2 Exemple de classe finale
<?php
final class BaseClass {
public function test() {
echo "BaseClass::test() appelée\n";
}
// Comme la classe est déjà finale, le mot clé final est redondant
final public function moreTesting() {
echo "BaseClass::moreTesting() appelée\n";
}
}
class ChildClass extends BaseClass {
}
// Résultat : Fatal error: Class ChildClass may not inherit from final class (BaseClass)
?>
Exemple #3 Exemple de propriété finale à partir de PHP 8.4.0
<?php
class BaseClass {
final protected string $test;
}
class ChildClass extends BaseClass {
public string $test;
}
// Résultat : Erreur fatale : Impossible de redéfinir la propriété finale BaseClass::$test
?>
Exemple #4 Exemple de constantes finales à partir de PHP 8.1.0
<?php
class Foo
{
final public const X = "foo";
}
class Bar extends Foo
{
public const X = "bar";
}
// Fatal error: Bar::X cannot override final constant Foo::X
?>
Note: À partir de PHP 8.0.0, les méthodes privées ne peuvent plus être déclarées finales, à l'exception du constructeur. Une propriété déclarée
private(set)
est implicitementfinale
.