Le mot-clé final

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

Alors que l'héritage et la redéfinition de méthode offrent de la flexibilité, il est parfois nécessaire d'empêcher la modification de certaines classes ou méthodes. Le mot-clé final verrouille votre code, garantissant que des implémentations spécifiques ne peuvent 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 ou toute autre classe enfant. Cela protège une fonctionnalité critique qui doit rester cohérente pour tous les types de comptes.

Vous pouvez également marquer 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. Ceci est utile pour les classes sensibles à la sécurité ou lorsque la conception de la classe est terminée et ne devrait pas être modifiée.

Point clé : Utilisez final sur les méthodes pour empêcher la redéfinition (overriding) tout en permettant l'héritage, ou sur les classes pour empêcher complètement l'héritage. C'est un outil pour protéger le code critique qui doit fonctionner exactement comme prévu.

Défi

Facile

Construisons un système de gestion de documents qui dé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 travaillent ensemble pour gérer différents types de documents tout en garantissant 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 avoir 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 retourne "Signed by: " . $this->author — cette fonctionnalité de sécurité ne doit jamais être modifiée par les classes enfants. Ajoutez également une méthode getContent() classique qui retourne "Document: " . $this->title.
Report.php — Définissez une classe Report qui étend Document. Incluez le fichier Document en haut. Cette classe ajoute une propriété $department. Le constructeur doit accepter le titre, l'auteur et le département — utilisez parent::__construct() pour les deux premiers, puis définissez le département. Surchargez la méthode getContent() pour qu'elle retourne "Report: " . $this->title . " (" . $this->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 département. 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. Le Report peut modifier la façon dont le contenu est affiché, mais le format de la signature est verrouillé dans la classe parente.

Aide-mémoire

Le mot-clé final empêche les classes ou les méthodes d'être modifiées par des classes enfants.

Méthodes finales : Marquez une méthode comme final pour empêcher les classes enfants de la surcharger :

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

class SavingsAccount extends BankAccount {
    // Cannot override getAccountId()
}

Classes finales : Marquez une classe entière comme final pour empêcher tout héritage :

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

// No class can extend SecurityManager

Utilisez final sur les méthodes pour protéger des fonctionnalités spécifiques tout en permettant l'héritage, ou sur les classes pour empêcher totalement l'héritage. Ceci est utile pour le code sensible à la sécurité ou lorsque les implémentations doivent rester cohérentes.

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