A Palavra-chave final

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 24 de 91.

Embora a herança e a sobrescrita de métodos ofereçam flexibilidade, às vezes você precisa impedir que determinadas classes ou métodos sejam alterados. A palavra-chave final bloqueia seu código, garantindo que implementações específicas não possam ser alteradas por classes filhas.

Quando você marca um método como final, nenhuma classe filha pode substituí-lo:

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

Saída:

ACC-1

O método getAccountId() não pode ser sobrescrito em SavingsAccount nem em qualquer outra classe filha. Isso protege funcionalidades críticas que devem permanecer consistentes em todos os tipos de conta.

Você também pode marcar uma classe inteira como final para impedir qualquer herança:

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

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

Saída:

Authenticating admin

Nenhuma classe pode estender SecurityManager. Isso é útil para classes sensíveis à segurança ou quando o design da classe está completo e não deve ser modificado.

Ponto-chave: Use final em métodos para impedir a sobrescrita e ainda permitir a herança, ou em classes para impedir completamente a herança. É uma ferramenta para proteger códigos críticos que devem funcionar exatamente conforme projetados.

Desafio

Fácil

Vamos criar um sistema de gerenciamento de documentos que demonstra como a palavra-chave final protege funcionalidades críticas contra modificações por classes filhas.

Você criará três arquivos que trabalham juntos para gerenciar diferentes tipos de documentos, garantindo que determinados recursos de segurança permaneçam bloqueados:

Document.php: Defina uma classe Document que sirva como base para todos os documentos. Ela deve ter uma propriedade pública $title e uma propriedade protegida $author. O construtor aceita tanto o título quanto o autor. Inclua um método final chamado getSignature() que retorna "Signed by: [author]". Esse recurso de segurança nunca deve ser alterado por classes filhas. Adicione também um método regular getContent() que retorna "Document: [title]".
Report.php: Defina uma classe Report que estenda Document. Inclua o arquivo Document no início. Essa classe adiciona uma propriedade $department. O construtor deve aceitar título, autor e departamento: use parent::__construct() para os dois primeiros e, em seguida, defina o departamento. Substitua o método getContent() para retornar "Report: [title] ([department])". A classe Report herda o método final getSignature() sem poder alterá-lo.
main.php: Inclua o arquivo Report. Você receberá três entradas: o título do documento, o nome do autor e o departamento. Crie um objeto Report com esses valores. Imprima o resultado de getContent() na primeira linha e, em seguida, imprima o resultado de getSignature() na segunda linha.

Este desafio mostra como os métodos final protegem funcionalidades críticas: a geração da assinatura permanece consistente em todos os tipos de documento, enquanto outros métodos, como getContent(), podem ser personalizados por cada classe filha. O Report pode alterar a forma como o conteúdo é exibido, mas o formato da assinatura fica definido na classe pai.

Experimente você mesmo

<?php
require_once 'Report.php';

// Ler entrada
$title = trim(fgets(STDIN));
$author = trim(fgets(STDIN));
$department = trim(fgets(STDIN));

// TODO: Crie um objeto Report com os valores de entrada

// TODO: Imprima o resultado de getContent()

// TODO: Imprima o resultado de getSignature()
?>