PHP non riesce a trovare una classe richiesta dal codice. Controlla il nome completo, le dipendenze e il caricamento dei file prima di reinstallare componenti.

Indice dei contenuti

Che cosa significa

PHP tenta di istanziare o usare una classe che non è stata caricata o non esiste con quel nome.

Come riconoscere il problema

Fatal class not found.
Stack trace.
Errore dopo aggiornamento.
Vendor incompleta.
Problema su Linux ma non locale.

Cause più frequenti

Autoload non caricato
Namespace errato
File mancante
Dipendenza plugin non attiva
Case del nome
Deploy o Composer incompleto

Diagnosi passo per passo

Leggere nome classe e stack.
Controllare namespace e use.
Verificare file vendor.
Controllare dipendenze.
Confrontare maiuscole.
Rieseguire deploy in staging.
Verificare versione PHP.

Procedura di risoluzione

Confronta i file con una copia integra della stessa versione del componente.
Nel codice personalizzato, verifica namespace, importazioni e inizializzazione dell’autoloader.
Se il progetto usa Composer, segui il suo processo di installazione con il lock file previsto. Non eseguire aggiornamenti delle dipendenze alla cieca dentro un plugin distribuito già completo.
Verifica che la dipendenza richiesta sia attiva e compatibile e venga caricata prima dell’uso.
Controlla i nomi dei file e i percorsi, che possono distinguere maiuscole e minuscole. Prova browser e processi pianificati.

Guide Xlogic correlate

Riferimenti tecnici

PHP: caricamento automatico delle classi

WordPress Fatal error Class not found ultima modifica: 2026-08-03T01:46:39+02:00 da Team tecnico Xlogic

WordPress Fatal error Class not found