In breve: “Fatal error: Uncaught TypeError” indica che PHP ha ricevuto un valore di tipo diverso da quello richiesto da una funzione, un metodo o una proprietà. In WordPress la causa più comune è un’incompatibilità tra plugin, tema, versione PHP o dati inattesi. La riga finale non basta: leggi messaggio e stack trace per identificare il primo file del componente coinvolto.
Indice dei contenuti
Che cosa significa TypeError
PHP genera un TypeError, per esempio, quando un parametro richiede una stringa ma riceve un array, una proprietà tipizzata riceve un valore incompatibile oppure una funzione restituisce un tipo diverso da quello dichiarato. Da PHP 7, TypeError appartiene alla gerarchia Error e implementa Throwable.
Non è normalmente un problema di cache, DNS o permessi dei file. Questi elementi vanno controllati soltanto se il messaggio o il contesto mostrano una relazione concreta.
Raccogliere l’errore completo
- Annota l’azione che produce l’errore e l’ora esatta.
- Controlla il log PHP dell’account e l’eventuale
wp-content/debug.log. - Copia messaggio, file, numero di riga e stack trace.
- Nascondi percorsi sensibili, token e dati personali prima di condividere il log.
Per attivare temporaneamente il log WordPress, usa le costanti ufficiali in wp-config.php e mantieni WP_DEBUG_DISPLAY disattivato sul sito pubblico. Dopo la diagnosi rimuovi o disattiva il debug e controlla la dimensione del file.
Individuare il componente responsabile
Cerca nel messaggio il primo percorso dentro wp-content/plugins, wp-content/themes o un plugin mu-plugins. Una riga del core WordPress può essere il punto in cui l’errore emerge, mentre il valore errato è stato passato da un componente esterno.
Verifica gli aggiornamenti recenti e la compatibilità dichiarata dal produttore. In un ambiente di staging, disattiva il solo plugin indicato oppure passa temporaneamente a un tema predefinito. Se il sito non consente l’accesso alla Bacheca, usa la modalità di recupero WordPress o rinomina esclusivamente la cartella del componente identificato, dopo un backup.
Controllare la versione PHP
Un passaggio a una versione PHP più recente può rendere visibile codice che prima accettava conversioni implicite o valori non validi. Verifica la versione attiva per il dominio e i requisiti di WordPress, tema e plugin.
Come prova reversibile puoi tornare alla versione PHP precedente ancora supportata dal progetto, ma non considerarla la soluzione definitiva. Aggiorna o sostituisci il componente incompatibile e riprova la versione moderna in staging.
Ripristinare il sito
- Crea o verifica un backup coerente.
- Isola il componente indicato dal trace.
- Aggiornalo a una versione compatibile oppure ripristina la versione precedente funzionante.
- Svuota la cache PHP e quella applicativa solo dopo aver cambiato i file.
- Ripeti l’azione che generava l’errore e controlla i log.
- Verifica pagine pubbliche, Bacheca, moduli e funzioni dinamiche.
Se il problema è causato da dati corrotti o da una migrazione, ripristinare i soli file potrebbe non bastare. Confronta configurazione e record coinvolti prima di sovrascrivere il database.
Se il codice è personalizzato
Leggi firma della funzione e valore effettivamente passato. Correggi l’origine del dato e gestisci esplicitamente casi null, array vuoti o formati inattesi. Non limitarti a rimuovere le dichiarazioni di tipo: perderesti un controllo utile senza risolvere il flusso errato.
Un blocco catch (Throwable $e) può gestire un errore previsto, ma non deve nascondere sistematicamente i difetti. Registra informazioni sufficienti per la diagnosi senza mostrare lo stack trace ai visitatori.
Cosa non fare
- non modificare il core WordPress;
- non sostituire valori alla cieca nella riga segnalata;
- non lasciare errori e stack trace visibili pubblicamente;
- non cambiare PHP, tema e più plugin nello stesso test;
- non ripristinare un database datato su un sito con nuovi ordini o utenti.
Quando contattare l’assistenza Xlogic
Apri un ticket se il sito non è accessibile, non riesci a recuperare il trace o il cambio PHP non viene applicato. Indica dominio, URL, azione eseguita, data e ora, versione PHP, modifiche recenti e messaggio completo con dati sensibili rimossi. L’assistenza può verificare ambiente e log; la correzione del codice del plugin o del tema può richiedere lo sviluppatore.
Guide Xlogic correlate
- Errore critico WordPress: diagnosi e soluzioni
- Cambiare versione PHP senza bloccare WordPress
- WordPress debug.log: attivazione e gestione sicura
Domande frequenti
Uncaught TypeError dipende sempre da PHP 8?
No. TypeError esiste da PHP 7 e può essere causato da codice o dati incompatibili. Un aggiornamento PHP può renderlo visibile, ma il trace serve per identificare la causa reale.
Quale riga del trace devo controllare?
Parti dal messaggio iniziale e cerca il primo file del plugin, tema o codice personalizzato coinvolto. L’ultima riga del core può mostrare dove l’errore emerge, non chi ha creato il valore errato.
Posso risolvere tornando a una versione PHP precedente?
Può essere una misura temporanea se la versione è ancora supportata dal progetto. La soluzione definitiva è aggiornare o correggere il componente incompatibile e verificare la versione PHP moderna in staging.
Devo modificare il core WordPress?
No. Le modifiche al core vengono perse agli aggiornamenti e raramente correggono l’origine del TypeError. Intervieni sul plugin, tema, codice personalizzato o dato indicato dalla diagnosi.