Errori PHP e memoria WordPress: come leggere i log
- Word press
- 2 settembre 2025
Indice dei contenuti
Gli errori PHP in WordPress non si risolvono tutti aumentando la memoria. Un limite esaurito, una funzione mancante e un errore di sintassi indicano problemi diversi. La prima operazione utile è recuperare il messaggio completo associato alla richiesta che fallisce e classificarlo prima di cambiare configurazione.
Questa guida serve a interpretare ciò che trovi nei log. Se hai soltanto una pagina vuota e non sai da dove iniziare, usa prima il percorso per la schermata bianca WordPress.
Quali informazioni leggere in un errore PHP
Raccogli data e ora, tipo di errore, messaggio, percorso del file, riga e traccia delle chiamate quando disponibile. La traccia mostra la sequenza che ha portato al punto di arresto. Il file indicato non è necessariamente il componente che ha originato il problema: può essere una libreria chiamata da altro codice.
Confronta l’orario con l’azione eseguita. Un avviso vecchio trovato in fondo a un log non dimostra di aver causato il guasto attuale. Se possibile, riproduci l’operazione su staging e conserva un estratto circoscritto, oscurando credenziali e dati personali prima di condividerlo.
| Messaggio o categoria | Significato da verificare |
|---|---|
Allowed memory size ... exhausted | La richiesta ha raggiunto il limite di memoria PHP |
Maximum execution time ... exceeded | Il codice ha superato il tempo consentito |
Call to undefined function | La funzione richiesta non è disponibile in quel contesto |
Parse error | PHP non riesce a interpretare il codice |
TypeError | Un valore non rispetta il tipo richiesto dall’operazione |
Warning o Deprecated | Segnalazione da valutare, non prova automatica di arresto |
La classificazione ufficiale degli errori PHP distingue errori fatali, avvisi e segnalazioni di deprecazione. La gestione applicativa può influenzarne gli effetti: conta sempre il comportamento osservato insieme al log.
Memoria esaurita: verificare limite e operazione
Un errore di memoria descrive il limite raggiunto da una richiesta PHP, non lo spazio occupato dai file sul disco. Prima di aumentarlo, identifica quale azione consuma risorse: caricamento di un’immagine, esportazione, ricerca, generazione di un documento o apertura di una schermata amministrativa.
Controlla il valore effettivo del processo web. Il pannello hosting, PHP usato da riga di comando e processo che serve il sito possono avere configurazioni differenti. Le impostazioni WordPress non garantiscono di poter superare i vincoli del provider; il riferimento per il limite PHP è la documentazione di memory_limit.
Come esempio ipotetico, un’esportazione che carica tutti i record contemporaneamente può fallire con un archivio crescente. Suddividere il lavoro in lotti e ridurre i dati mantenuti in memoria può essere più sostenibile di aumentare continuamente il limite. Prima va però verificato che sia davvero questo il comportamento del componente.
Quando aumentare la memoria ha senso
Un aumento può essere appropriato se il carico è previsto, il codice non mostra consumi anomali e l’hosting ha capacità disponibile. Registra valore iniziale, nuovo valore consentito e risultato della stessa prova. Controlla il comportamento anche con più richieste contemporanee: ogni processo contribuisce al consumo complessivo.
Se il consumo cresce senza un rapporto ragionevole con il lavoro, indaga query troppo ampie, elaborazioni ripetute o cicli errati. Un limite più alto può rinviare il guasto. Se invece il messaggio riguarda una funzione mancante o la sintassi, aumentare la memoria non affronta la causa descritta.
Non impostare valori illimitati come soluzione standard. La decisione deve essere compatibile con le risorse dell’account e con il tipo di operazione.
Funzioni mancanti, sintassi e compatibilità PHP
Per una funzione mancante verifica chi dovrebbe fornirla: core, plugin principale, estensione PHP o libreria. Controlla che il componente esista, venga caricato e rispetti la versione richiesta. Un pacchetto incompleto e una dipendenza non attiva possono produrre sintomi simili.
Per un errore di sintassi confronta il file con una copia attendibile e verifica eventuali modifiche manuali. La riga segnalata può essere il punto in cui PHP si accorge del problema, non quello in cui è stato introdotto. Evita correzioni casuali direttamente sul sito pubblico.
Un TypeError richiede anche l’analisi dei dati passati alla funzione. Se il problema è comparso dopo un cambio PHP, riproducilo in una copia con versioni documentate e verifica i requisiti dell’intera installazione. La guida ai plugin incompatibili aiuta a organizzare questo confronto.
Timeout PHP e risposte 502 o 504 non sono equivalenti
Un processo può fallire per tempo di esecuzione, attesa del database, servizio esterno o limite del server davanti a PHP. Il codice HTTP da solo non indica quale livello abbia interrotto l’operazione.
Correla log PHP, web server e hosting sulla stessa richiesta. Per un’importazione lunga verifica se il lavoro può essere suddiviso e ripreso senza duplicare i dati. Un aumento del tempo consentito non corregge automaticamente una chiamata esterna che non risponde.
Verificare la correzione e chiudere il debug
Ripeti la stessa azione con dati equivalenti, controlla i nuovi log e verifica il risultato applicativo: un’esportazione deve contenere i record attesi, un’immagine deve essere disponibile e un salvataggio deve persistere.
Conserva impostazioni iniziali e finali, causa confermata e limiti ancora presenti. Mantieni gli errori dettagliati fuori dalle pagine pubbliche e proteggi i log. Se devi interpretare un errore PHP o valutare il consumo di memoria, posso analizzare il componente WordPress coinvolto e distinguere un adeguamento delle risorse da una correzione del codice.
