...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Class "Produs" not found in index.php:9

Pe scurt

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, produs merge, pentru că numele claselor nu țin cont de majuscule, dar autoload-ul pe Linux ține cont de numele fișierului);
  • fișierul Produs.php nu e inclus cu require și nu există autoload;
  • în proiecte cu Composer: lipsește require 'vendor/autoload.php', nu ai rulat composer install / composer dump-autoload, sau namespace-ul din fișier nu se potrivește cu autoload.psr-4 din composer.json;
  • clasa e în namespace (App\Models\Produs) și lipsește use App\Models\Produs; (mesajul arată atunci numele complet căutat, de exemplu Class "App\Controllers\Produs" not found).

De ce apare: cauzele frecvente

1Nume scris greșit

Greșit
PHP
<?php
class Produs {}
$p = new Produse();
Corect
PHP
<?php
class Produs {}
$p = new Produs();

Produse e alt nume, pentru care nu există nicio clasă.

2Lipsește use pentru namespace

Greșit
PHP
<?php
namespace App\Controllers;

$p = new Produs(); // caută App\Controllers\Produs
Corect
PHP
<?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

Greșit
PHP
<?php
// clasa e în src/Produs.php
$p = new Produs();
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
}
După reparație, programul afișează
Caiet - 7.5 lei
Pix - 2.25 lei
Indiciu

Compară numele din new cu numele din declarația clasei.

Alte forme ale mesajului

  • PHP Fatal error: Uncaught Error: Class "App\Models\Produs" not found in /var/www/html/src/Controller.php:15
  • Fatal error: Uncaught Error: Class 'Produs' not found in index.php:9
  • Fatal error: Uncaught Error: Class "PDO" not found in db.php:3
  • Fatal 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 use când scrii numele unei clase.
  • Pentru clase PHP din namespace-ul global, într-un fișier cu namespace scrie \DateTime sau 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

← 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.