Fatal error: Uncaught Error: Class "Produs" not found in index.php:9
PHP nu găsește definiția clasei: numele e scris greșit, fișierul clasei nu e inclus (sau autoload-ul Composer nu e configurat), ori clasa e într-un namespace și lipsește use. Verifică numele, require-ul sau use-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când scrii new Produs(), Produs::metoda() sau Produs::class într-un context care are nevoie de clasă, PHP caută definiția ei. Dacă nu o găsește nici în fișierele încărcate, nici prin autoload, aruncă Error: Class "Produs" not found.
Cauzele cele mai frecvente:
- numele e scris diferit (
Produse,produsmerge, pentru că numele claselor nu țin cont de majuscule, dar autoload-ul pe Linux ține cont de numele fișierului); - fișierul
Produs.phpnu e inclus curequireși nu există autoload; - în proiecte cu Composer: lipsește
require 'vendor/autoload.php', nu ai rulatcomposer install/composer dump-autoload, sau namespace-ul din fișier nu se potrivește cuautoload.psr-4dincomposer.json; - clasa e în namespace (
App\Models\Produs) și lipseșteuse App\Models\Produs;(mesajul arată atunci numele complet căutat, de exempluClass "App\Controllers\Produs" not found).
De ce apare: cauzele frecvente
1Nume scris greșit
<?php
class Produs {}
$p = new Produse();<?php
class Produs {}
$p = new Produs();Produse e alt nume, pentru care nu există nicio clasă.
2Lipsește use pentru namespace
<?php
namespace App\Controllers;
$p = new Produs(); // caută App\Controllers\Produs<?php
namespace App\Controllers;
use App\Models\Produs;
$p = new Produs();Într-un namespace, numele scurt e căutat în namespace-ul curent. use spune unde se află de fapt clasa.
3Fișierul nu e încărcat
<?php
// clasa e în src/Produs.php
$p = new Produs();<?php
require __DIR__ . '/vendor/autoload.php';
// sau: require_once __DIR__ . '/src/Produs.php';
$p = new Produs();Clasa trebuie încărcată înainte de folosire, manual sau prin autoload-ul Composer.
Repară eroarea, direct în pagină
Scriptul creează două produse, dar se oprește cu Fatal error: Uncaught Error: Class "Produse" not found. Repară instanțierea, ca programul să afișeze Caiet - 7.5 lei și Pix - 2.25 lei.
<?php
class Produs
{
public function __construct(
public string $nume,
public float $pret,
) {}
}
$produse = [new Produse('Caiet', 7.5), new Produse('Pix', 2.25)];
foreach ($produse as $p) {
echo "{$p->nume} - {$p->pret} lei\n";
}Caiet - 7.5 lei Pix - 2.25 lei
Indiciu
Compară numele din new cu numele din declarația clasei.
Reparația
<?php
class Produs
{
public function __construct(
public string $nume,
public float $pret,
) {}
}
$produse = [new Produs('Caiet', 7.5), new Produs('Pix', 2.25)];
foreach ($produse as $p) {
echo "{$p->nume} - {$p->pret} lei\n";
}De ce merge
Clasa se numește Produs, dar codul crea obiecte cu new Produse(...). PHP a căutat o clasă Produse, nu a găsit-o nici declarată, nici prin autoload, și a aruncat Error: Class "Produse" not found.
Cu numele corect, obiectele se creează, iar constructorul cu proprietăți promovate (public string $nume) le salvează direct valorile. Într-un proiect cu mai multe fișiere, aceeași eroare apare și când clasa e scrisă corect, dar fișierul ei nu e încărcat.
Alte forme ale mesajului
PHP Fatal error: Uncaught Error: Class "App\Models\Produs" not found in /var/www/html/src/Controller.php:15Fatal error: Uncaught Error: Class 'Produs' not found in index.php:9Fatal error: Uncaught Error: Class "PDO" not found in db.php:3Fatal error: Uncaught Error: Interface "Platibil" not found in index.php:4
Cum o eviți pe viitor
- În proiecte reale folosește autoload-ul Composer (PSR-4): o clasă pe fișier, numele fișierului identic cu numele clasei, namespace-ul identic cu structura folderelor.
- După ce adaugi sau muți clase, rulează
composer dump-autoload. - Lasă editorul să adauge automat
usecând scrii numele unei clase. - Pentru clase PHP din namespace-ul global, într-un fișier cu namespace scrie
\DateTimesau adaugăuse DateTime;.
Întrebări frecvente
Pe Windows merge, pe server (Linux) nu. De ce?
Autoload-ul transformă numele clasei în cale de fișier. Pe Windows produs.php și Produs.php sunt același fișier, pe Linux nu. Asigură-te că numele fișierului are exact aceleași majuscule ca numele clasei.
De ce primesc Class "PDO" not found?
Extensia PDO nu e activă în PHP-ul care rulează scriptul sau, într-un fișier cu namespace, lipsește use PDO; (ori \PDO). Verifică cu php -m dacă extensia e încărcată.
Erori înrudite
Fatal error: Uncaught Error: Call to undefined function calculeazaTotal() in index.php:7 Apelezi o funcție pe care PHP n-o cunoaște: numele e scris greșit, fișierul în care e definită nu e inclus, sau funcția ține de o extensie care nu e activă. Verifică numele, include fișierul cu require și, pentru extensii, activează-le în php.ini. Warning: require(config.php): Failed to open stream: No such file or directory in index.php on line 2 PHP nu găsește fișierul pe care îl incluzi cu require sau include, de obicei pentru că o cale relativă e rezolvată față de alt folder decât crezi. Folosește o cale absolută pornind de la __DIR__: require __DIR__ . '/config.php';. Fatal error: Uncaught Error: Call to undefined method Produs::getPret() in index.php:10 Clasa obiectului nu are metoda pe care o apelezi: numele e greșit, metoda e în altă clasă sau ai un obiect de alt tip decât credeai. Verifică numele metodei în clasă (și clasa din mesaj). Î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.
