In breve: PHP class already declared — indica che la stessa classe viene caricata o dichiarata più di una volta.
Indice dei contenuti
PHP class already declared: significato
Le prime ipotesi da verificare per “PHP class already declared” sono codice non compatibile con la versione PHP; file incluso più volte o dipendenza non caricata.
Sintomi e cause probabili
Sintomi da verificare
- Il messaggio “PHP class already declared” compare durante un’operazione ripetibile.
- La funzione coinvolta in PHP non raggiunge il risultato previsto.
- Il log dell’area PHP registra un evento nello stesso minuto della prova.
- Il comportamento osservato in PHP cambia in base a utente, rete, file o configurazione.
Cause probabili
- Codice non compatibile con la versione PHP
- File incluso più volte o dipendenza non caricata
- Dato null o di tipo diverso da quello atteso
- Output inviato prima degli header
Diagnosi passo per passo
- Leggere messaggio completo, file, riga e stack trace
- Identificare plugin, tema o codice proprietario responsabile
- Riprodurre con lo stesso input in staging
- Verificare tipi, include e percorsi prima della riga
- Confrontare il comportamento con una versione supportata
Log e dati da controllare
- PHP error_log
- WordPress debug.log se applicabile
- versione, estensioni e configurazione PHP
Correzioni sicure
- Aggiornare o correggere il componente responsabile
- Validare tipi e valori prima dell’uso
- Usare include_once o autoload coerente quando necessario
- Rimuovere output prematuro e caratteri invisibili
- Correggere percorso e permessi senza esporre il filesystem
Verifica finale
- La stessa chiamata termina senza warning o fatal error
- Lo stack trace non ricompare
- Frontend e processi in background funzionano
- La correzione resta compatibile con la versione PHP in uso
Errori da evitare
- Non disattivare globalmente WAF, ModSecurity, antispam o verifica TLS per aggirare il sintomo
- Non impostare permessi 777 e non cambiare proprietari in modo ricorsivo senza conoscere la struttura dell’account
- Non cancellare database, chiavi Redis, cache o file di sistema senza backup e senza aver identificato l’oggetto coinvolto
- Non ripetere pagamenti, import o webhook reali finché non hai verificato l’idempotenza
Guide Xlogic correlate
- PHP Fatal error: Cannot instantiate abstract class
- PHP Fatal error: Uncaught ArithmeticError
- PHP Fatal error: Interface not found
Fonti tecniche
Domande frequenti
Che cosa significa “PHP class already declared”?
PHP class already declared — indica che la stessa classe viene caricata o dichiarata più di una volta.
Da cosa può dipendere “PHP class already declared”?
Le cause da verificare per “PHP class already declared” sono: codice non compatibile con la versione PHP; file incluso più volte o dipendenza non caricata; dato null o di tipo diverso da quello atteso.
Quali controlli eseguire per “PHP class already declared”?
Per diagnosticare “PHP class already declared”, controlla nell’ordine: leggere messaggio completo, file, riga e stack trace; identificare plugin, tema o codice proprietario responsabile; riprodurre con lo stesso input in staging. La soluzione è confermata quando la stessa chiamata termina senza warning o fatal error; lo stack trace non ricompare.