...
Eroare PHP · Clase și obiecte

Fatal error: Class PlataCard cannot extend final class Plata in index.php on line 9

Pe scurt

Clasa părinte e declarată final, adică autorul ei a interzis moștenirea. Nu o poți extinde; în loc de extends, folosește compunerea (păstrezi un obiect Plata într-o proprietate) sau implementezi aceeași interfață.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

final class Plata înseamnă că nicio altă clasă nu are voie să scrie extends Plata. Similar, final public function proceseaza() interzice suprascrierea doar a acelei metode (mesajul devine Cannot override final method Plata::proceseaza()). PHP verifică la compilare, deci nu rulează nimic.

Autorii de biblioteci și framework-uri marchează clasele final intenționat: vor să poată schimba detaliile interne fără să strice clasele altora și te îndeamnă să folosești compunerea în locul moștenirii. Soluția corectă nu e să ștergi final dintr-o bibliotecă (modificarea se pierde la actualizare), ci să construiești o clasă proprie care conține un obiect Plata sau implementează aceeași interfață.

De ce apare: cauzele frecvente

1Vrei să adaugi comportament unei clase final

Greșit
PHP
<?php
final class Plata {
    public function proceseaza(float $s): string { return "Plătit $s"; }
}
class PlataCard extends Plata {}
Corect
PHP
<?php
final class Plata {
    public function proceseaza(float $s): string { return "Plătit $s"; }
}
class PlataCard {
    public function __construct(private Plata $plata) {}
    public function proceseaza(float $s): string { return $this->plata->proceseaza($s) . ' cu cardul'; }
}

PlataCard folosește un obiect Plata din interior (compunere) și îi adaugă comportament.

2Suprascrii o metodă final

Greșit
PHP
<?php
class Plata {
    final public function id(): string { return 'P1'; }
}
class PlataCard extends Plata {
    public function id(): string { return 'C1'; }
}
Corect
PHP
<?php
class Plata {
    final public function id(): string { return 'P1'; }
}
class PlataCard extends Plata {
    public function idCard(): string { return 'C' . substr($this->id(), 1); }
}

O metodă final nu se poate suprascrie, dar poți adăuga metode noi care o folosesc. Mesajul ar fi Cannot override final method Plata::id().

Repară tu

Repară eroarea, direct în pagină

Clasa Plata dintr-o bibliotecă este final, iar PlataCard încearcă s-o extindă: Class PlataCard cannot extend final class Plata. Fără să modifici clasa Plata, rescrie PlataCard prin compunere (păstrează un obiect Plata în interior), ca programul să afișeze Plătit 120 lei cu cardul ****4242.

Codul care dă eroarea
PHP
<?php
final class Plata
{
    public function proceseaza(float $suma): string
    {
        return "Plătit $suma lei";
    }
}

class PlataCard extends Plata
{
    public function __construct(private string $card) {}

    public function proceseazaCuCard(float $suma): string
    {
        return $this->proceseaza($suma) . ' cu cardul ****' . substr($this->card, -4);
    }
}

$p = new PlataCard('0000000000004242');
echo $p->proceseazaCuCard(120) . "\n";
După reparație, programul afișează
Plătit 120 lei cu cardul ****4242
Indiciu

Primește un obiect Plata în constructor și apelează-i metoda proceseaza() din metoda ta.

Alte forme ale mesajului

  • Fatal error: Cannot override final method Plata::proceseaza() in index.php on line 12
  • Fatal error: Class PlataCard cannot extend final class Plata in index.php on line 9
  • Fatal error: Class PlataCard may not inherit from final class (Plata) in index.php on line 9
  • Fatal error: Class Status cannot extend final class UnitEnum in index.php on line 3

Cum o eviți pe viitor

  • Când o clasă dintr-o bibliotecă e final, caută interfața pe care o implementează și scrie clasa ta pe baza ei.
  • Preferă compunerea („are un”) moștenirii („este un”) când vrei doar să refolosești cod.
  • În clasele tale, folosește final pentru clasele care nu au fost gândite pentru moștenire: e mai ușor să scoți final mai târziu decât să-l adaugi.

Întrebări frecvente

Pot scoate final din codul bibliotecii?

Tehnic da, dar modificarea se pierde la următorul composer update și poate strica biblioteca. Folosește compunerea sau interfața pe care o oferă.

Enum-urile pot fi moștenite?

Nu. Enum-urile sunt implicit finale; poți doar să implementezi interfețe în ele și să folosești traits.

Erori înrudite

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PHP de la zero, cu exerciții la fiecare lecție

Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.