Le mot-clé final

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 24 sur 91.

Bien que l’héritage et la redéfinition de méthodes offrent de la flexibilité, vous devez parfois empêcher certaines classes ou méthodes d’être modifiées. Le mot-clé final verrouille votre code, garantissant que des implémentations spécifiques ne puissent pas être modifiées par des classes enfants.

Lorsque vous marquez une méthode comme final, aucune classe enfant ne peut la redéfinir :

<?php
class BankAccount {
    protected $balance;
    
    public function __construct($balance) {
        $this->balance = $balance;
    }
    
    final public function getAccountId() {
        return "ACC-" . spl_object_id($this);
    }
}

class SavingsAccount extends BankAccount {
    public function addInterest() {
        return $this->balance * 0.05;
    }
}

$account = new SavingsAccount(1000);
echo $account->getAccountId();

Sortie :

ACC-1

La méthode getAccountId() ne peut pas être redéfinie dans SavingsAccount ni dans aucune autre classe enfant. Cela protège les fonctionnalités critiques qui doivent rester cohérentes entre tous les types de comptes.

Vous pouvez également déclarer une classe entière comme final pour empêcher tout héritage :

<?php
final class SecurityManager {
    public function authenticate($user) {
        return "Authenticating $user";
    }
}

$security = new SecurityManager();
echo $security->authenticate("admin");

Sortie :

Authenticating admin

Aucune classe ne peut étendre SecurityManager. Cela est utile pour les classes sensibles en matière de sécurité ou lorsque la conception de la classe est terminée et ne doit pas être modifiée.

Point clé : Utilisez final sur les méthodes pour empêcher leur redéfinition tout en autorisant l’héritage, ou sur les classes pour empêcher entièrement l’héritage. C’est un outil permettant de protéger le code critique qui doit fonctionner exactement comme prévu.

Défi

Facile

Construisons un système de gestion de documents qui montre comment le mot-clé final protège les fonctionnalités critiques contre toute modification par les classes enfants.

Vous allez créer trois fichiers qui fonctionneront ensemble pour gérer différents types de documents, tout en veillant à ce que certaines fonctionnalités de sécurité restent verrouillées :

Document.php : définissez une classe Document qui sert de base à tous les documents. Elle doit posséder une propriété publique $title et une propriété protégée $author. Le constructeur accepte à la fois le titre et l’auteur. Incluez une méthode final appelée getSignature() qui renvoie "Signed by: [author]". Cette fonctionnalité de sécurité ne doit jamais être modifiée par les classes enfants. Ajoutez également une méthode ordinaire getContent() qui renvoie "Document: [title]".
Report.php : définissez une classe Report qui étend Document. Incluez le fichier Document en haut du fichier. Cette classe ajoute une propriété $department. Le constructeur doit accepter le titre, l’auteur et le service : utilisez parent::__construct() pour les deux premiers, puis définissez le service. Redéfinissez la méthode getContent() pour qu’elle renvoie "Report: [title] ([department])". La classe Report hérite de la méthode finale getSignature() sans pouvoir la modifier.
main.php : incluez le fichier Report. Vous recevrez trois entrées : le titre du document, le nom de l’auteur et le service. Créez un objet Report avec ces valeurs. Affichez le résultat de getContent() sur la première ligne, puis affichez le résultat de getSignature() sur la deuxième ligne.

Ce défi montre comment les méthodes final protègent les fonctionnalités critiques : la génération de la signature reste cohérente pour tous les types de documents, tandis que d’autres méthodes comme getContent() peuvent être personnalisées par chaque classe enfant. La classe Report peut modifier la manière dont le contenu est affiché, mais le format de la signature est verrouillé dans la classe parente.

Essayez vous-même

<?php
require_once 'Report.php';

// Lire l'entrée
$title = trim(fgets(STDIN));
$author = trim(fgets(STDIN));
$department = trim(fgets(STDIN));

// TODO: Créer un objet Report avec les valeurs d'entrée

// TODO: Afficher le résultat de getContent()

// TODO: Afficher le résultat de getSignature()
?>