Quando un plugin WordPress causa un crash, il sito può mostrare un errore critico, una pagina bianca, un errore HTTP 500 oppure rendere inaccessibile la bacheca. La priorità è ripristinare l’accesso senza cancellare file o dati: identifica il componente coinvolto, disattivalo in modo reversibile e consulta il messaggio PHP che ha provocato il blocco.
Un crash subito dopo l’installazione o l’aggiornamento di un plugin non dimostra necessariamente che il plugin sia difettoso. Può esserci un conflitto con il tema o con un altro componente, una versione PHP non compatibile, un’estensione mancante, memoria insufficiente oppure un aggiornamento incompleto. Prima di intervenire, annota l’ora dell’errore e l’ultima operazione eseguita.
Cosa fare subito quando WordPress va in crash
Evita modifiche multiple contemporaneamente: renderebbero difficile capire quale azione ha risolto o peggiorato il problema. Procedi in questo ordine:
- Non aggiornare la pagina ripetutamente e non eliminare subito il plugin.
- Annota URL, ora esatta, messaggio visualizzato e operazione appena eseguita.
- Controlla l’email dell’amministratore per un eventuale collegamento alla modalità di ripristino.
- Crea, se possibile, un backup dei file e del database prima di modificare il sito.
- Disattiva soltanto il plugin sospetto con il metodo meno invasivo disponibile.
- Svuota le cache e verifica il frontend e la bacheca in una finestra anonima.
- Consulta il log PHP per individuare file e riga che hanno generato l’errore.
Se il sito gestisce ordini, prenotazioni o iscrizioni, evita di ripristinare immediatamente un vecchio database: potresti perdere dati creati dopo il backup. In questi casi conviene prima disattivare il componente e recuperare l’accesso, valutando il ripristino soltanto dopo aver confrontato le date.
Usare la modalità di ripristino di WordPress
Dalla versione 5.2, WordPress include una protezione dagli errori fatali. Quando rileva un problema in un plugin o nel tema, può mostrare il messaggio “Si è verificato un errore critico sul tuo sito web” e inviare un’email all’indirizzo amministrativo. Il collegamento contenuto nel messaggio permette di accedere alla Recovery Mode, dove il componente problematico viene sospeso per la sessione dell’amministratore.
Apri l’email soltanto dopo aver verificato che il dominio del collegamento appartenga realmente al sito. Una volta entrato:
- vai in Plugin → Plugin installati;
- individua il componente indicato da WordPress;
- disattivalo senza eliminarlo;
- esci dalla modalità di ripristino;
- controlla sia le pagine pubbliche sia
/wp-admin/.
Se l’email non arriva, verifica che l’indirizzo in Impostazioni → Generali sia corretto e controlla spam e recapito della posta. Non è necessario attendere il messaggio: puoi utilizzare File Manager, SFTP o WP-CLI per disattivare il plugin.
Disattivare il plugin dalla bacheca
Se l’amministrazione è ancora accessibile, apri Plugin → Plugin installati e disattiva il componente aggiornato o attivato immediatamente prima del crash. Non premere “Elimina”: la disattivazione è reversibile e conserva i file, mentre la disinstallazione può rimuovere dati o impostazioni se il plugin prevede una routine di pulizia.
Dopo la disattivazione, svuota la cache di WordPress e l’eventuale cache server, quindi verifica il sito senza essere autenticato. Se l’errore scompare, conserva il plugin inattivo mentre controlli changelog, requisiti PHP, ticket di supporto e disponibilità di una versione corretta.
Se l’errore resta, non riattivare subito tutto. Potrebbe essere coinvolto un altro plugin, il tema o il core; passa alla lettura dei log prima di formulare una diagnosi.
Disattivare un plugin con File Manager, SFTP o FTP
Quando /wp-admin/ non si apre, accedi ai file tramite il File Manager di cPanel oppure con SFTP. SFTP è preferibile quando disponibile perché cifra la connessione; la guida sulle differenze tra SFTP, FTPS e FTP aiuta a scegliere il protocollo corretto.
Se conosci il plugin responsabile
Apri wp-content/plugins/, individua la cartella del plugin e rinominala aggiungendo un suffisso, per esempio:
nome-plugin
nome-plugin.disattivatoWordPress non troverà più il componente nel percorso registrato e lo considererà disattivato. Non cancellare la cartella: rinominarla permette di tornare indietro e conserva una copia utile per l’analisi. Se il sito riparte, accedi alla pagina dei plugin, verifica che il componente risulti disattivato e riporta la cartella al nome originale. Il semplice ripristino del nome non dovrebbe riattivare automaticamente un plugin che WordPress ha già segnato come mancante.
Se non sai quale plugin causa il crash
Rinomina temporaneamente l’intera cartella:
wp-content/plugins
wp-content/plugins.holdSe il sito torna accessibile, entra nella bacheca e visita la schermata dei plugin; quindi ripristina il nome plugins. I componenti standard risulteranno disattivati e potranno essere riattivati uno alla volta. Verifica il sito dopo ogni riattivazione, finché l’errore ricompare.
Non rinominare wp-content e non spostare cartelle non correlate. I plugin must-use presenti in wp-content/mu-plugins/ vengono caricati automaticamente e non sono gestiti dalla normale schermata: se il log indica uno di questi file, chiedi allo sviluppatore o al provider prima di modificarlo.
Disattivare il plugin tramite WP-CLI
Con accesso SSH, WP-CLI consente di verificare e disattivare i plugin senza aprire WordPress nel browser. Posizionati nella directory corretta dell’installazione oppure specifica il percorso con --path.
Elencare i plugin e il loro stato
wp plugin listLa colonna status mostra quali componenti sono attivi. Per disattivare soltanto quello sospetto usa lo slug della directory, non il nome commerciale mostrato nella bacheca:
wp plugin deactivate nome-pluginSe un plugin impedisce l’avvio di WP-CLI
Alcuni errori fatali si verificano durante il caricamento di WordPress e bloccano anche i comandi. Puoi chiedere a WP-CLI di non caricare i plugin durante l’operazione:
wp --skip-plugins plugin deactivate nome-pluginSe il problema riguarda un solo componente e ne conosci lo slug, puoi anche usare --skip-plugins=nome-plugin. I must-use plugin vengono comunque caricati: un errore in mu-plugins richiede un intervento specifico.
Disattivare tutti i plugin come test
wp --skip-plugins plugin deactivate --allQuesta operazione va usata solo quando non è possibile individuare il componente dal log. In un e-commerce o in un sito con funzioni critiche, disattivare tutto può interrompere pagamenti, moduli, aree riservate e cache: pianifica il test, registra lo stato iniziale e riattiva i plugin uno alla volta.
Leggere il messaggio che ha causato il crash
Il fatto che il sito riparta dopo la disattivazione dimostra il coinvolgimento del plugin, ma non spiega ancora la causa. Cerca nel log una voce con lo stesso orario del crash. In cPanel puoi consultare Metriche → Errori; in alcune configurazioni è presente anche un file error_log nella directory del sito.
Informazioni utili nel PHP fatal error
Una riga simile a PHP Fatal error contiene normalmente il tipo di errore, il percorso del file e il numero di riga. Alcuni messaggi frequenti sono:
| Messaggio | Possibile significato | Controllo iniziale |
|---|---|---|
Call to undefined function | Funzione o estensione non disponibile | Versione PHP, estensioni e dipendenze |
Allowed memory size exhausted | Memoria PHP esaurita | Consumo del processo e limite assegnato |
Uncaught TypeError | Codice incompatibile o dato inatteso | Versioni di PHP, plugin e tema |
Cannot redeclare | Funzione o classe dichiarata due volte | Conflitto o duplicazione dei file |
Failed opening required | File mancante o percorso errato | Integrità dell’aggiornamento e permessi |
Non pubblicare l’intero log: può contenere percorsi del server, indirizzi IP, query o altri dati riservati. Quando chiedi assistenza, invia solo le righe pertinenti, l’ora con fuso orario, l’URL coinvolto e le operazioni già eseguite.
Attivare WP_DEBUG_LOG senza mostrare errori ai visitatori
Se i log disponibili non mostrano abbastanza dettagli, WordPress può scrivere gli errori in wp-content/debug.log. Crea prima una copia di wp-config.php, quindi inserisci temporaneamente queste costanti prima della riga finale che interrompe le modifiche:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );Riproduci il crash una volta, scarica le righe generate e poi disattiva il debug. In produzione gli errori non devono essere mostrati ai visitatori. Il file debug.log può crescere rapidamente e contenere informazioni sensibili; eliminalo o proteggilo quando l’analisi è terminata. Consulta anche la documentazione ufficiale sul debug di WordPress.
Perché un plugin manda WordPress in crash
Plugin non compatibile con la versione PHP
Un componente datato può utilizzare funzioni rimosse o comportamenti diventati più rigorosi nelle versioni recenti di PHP. Confronta i requisiti dichiarati dal plugin con la versione attiva in cPanel. Un downgrade PHP può essere utile come test temporaneo, ma non è una soluzione permanente: mantenere una versione non supportata aumenta i rischi di sicurezza e compatibilità.
Conflitto con un altro plugin o con il tema
Due componenti possono caricare la stessa libreria, modificare lo stesso hook o aspettarsi formati di dati differenti. Dopo aver creato un backup, prova in staging con un tema predefinito e con gli altri plugin disattivati. Riattivali uno alla volta, controllando ogni volta frontend, bacheca e log.
Aggiornamento incompleto o file mancanti
Una connessione interrotta o lo spazio disco insufficiente possono lasciare il plugin in uno stato parziale. Non sovrascrivere subito l’intero core di WordPress. Scarica una copia autentica della stessa versione del plugin, confronta i file e reinstalla il solo componente dopo aver salvato la configurazione e verificato che la licenza consenta il download.
Memoria PHP o risorse esaurite
Importazioni, backup, scansioni o query pesanti possono superare memoria, CPU o processi disponibili. Aumentare il limite senza capire il consumo può soltanto rinviare il problema. Confronta l’ora dell’errore con le statistiche di cPanel e verifica se il log indica Allowed memory size exhausted o un timeout.
Dipendenza mancante o ordine di caricamento
Alcuni plugin richiedono un componente principale, un’estensione PHP o una versione minima di WordPress. Controlla la pagina dei requisiti e il changelog. Se il crash è comparso dopo l’aggiornamento di una dipendenza, prova la combinazione corretta in un ambiente di staging prima di modificare nuovamente il sito pubblico.
Come riattivare il sito in sicurezza
Dopo aver individuato il plugin, non riattivarlo direttamente in produzione per “vedere se funziona”. Prima aggiorna o sostituisci il componente, verifica che WordPress, PHP e le dipendenze rispettino i requisiti e prova la modifica su una copia di staging.
- conserva il plugin problematico disattivato;
- crea un nuovo backup dello stato funzionante;
- aggiorna il plugin da una fonte ufficiale o ripristina una versione nota e compatibile;
- esegui il test in staging con la stessa versione PHP della produzione;
- controlla pagine, moduli, login, checkout, cron e log;
- applica la correzione al sito pubblico in una finestra di manutenzione;
- svuota tutte le cache e monitora gli errori.
Se il plugin non è più mantenuto, valuta un’alternativa. La semplice riattivazione di un componente vulnerabile o incompatibile espone il sito a nuovi blocchi. Conserva un elenco delle funzioni utilizzate prima di sostituirlo, soprattutto quando gestisce shortcode, campi personalizzati o dati proprietari.
Quando ripristinare un backup
Il ripristino è indicato quando l’aggiornamento ha modificato dati o file in modo non facilmente reversibile, quando più componenti sono stati aggiornati insieme oppure quando il sito non torna stabile dopo la disattivazione. Scegli un punto di ripristino precedente al crash e verifica che il backup comprenda sia file sia database.
Prima di procedere, considera i dati creati dopo il backup: ordini, email, commenti, utenti e modifiche editoriali potrebbero andare persi. Nei siti dinamici può essere preferibile ripristinare soltanto i file del plugin o lavorare su una copia, anziché riportare indietro l’intero database.
Dopo il ripristino cambia la versione del componente responsabile o lascialo disattivato; ripristinare lo stesso stato che ha causato il crash farebbe ricomparire l’errore. Controlla inoltre che il backup sia integro e conserva una copia dello stato attuale prima di sovrascriverlo.
Non sostituire wp-admin e wp-includes senza una diagnosi
Un plugin normalmente non dovrebbe modificare i file del core. Sostituire indiscriminatamente wp-admin e wp-includes non è quindi il secondo passaggio standard dopo un crash: può introdurre file di una versione diversa e nascondere la causa reale.
Con accesso SSH, verifica prima l’integrità del core con:
wp core verify-checksumsIl comando confronta i file dell’installazione con i checksum ufficiali della versione e della lingua rilevate. Se emergono differenze, crea un backup e reinstalla il core con una procedura controllata, preservando wp-content e wp-config.php. La documentazione WP-CLI sui checksum descrive opzioni e limiti del controllo.
Domande frequenti sui crash causati dai plugin
Rinominare la cartella elimina il plugin?
No. La rinomina rende il percorso non disponibile e permette a WordPress di disattivare il componente, ma conserva i file. Dopo aver visitato la schermata dei plugin puoi ripristinare il nome originale lasciando il plugin inattivo.
Posso cancellare direttamente il plugin via FTP?
È preferibile di no. La cancellazione è meno reversibile e rende più difficile analizzare il problema. Prima rinomina la cartella o usa il comando di disattivazione; elimina il plugin soltanto quando hai un backup e hai deciso di disinstallarlo.
La disattivazione cancella le impostazioni?
Di norma no, ma il comportamento dipende dal componente. La disinstallazione può eseguire routine che eliminano tabelle o opzioni, mentre la semplice disattivazione normalmente conserva i dati. Consulta la documentazione del plugin prima di cancellarlo.
Il sito funziona ma non riesco ad accedere a wp-admin: è comunque un plugin?
Sì, un errore può interessare soltanto le pagine amministrative. Consulta il log relativo all’URL di accesso e disattiva il componente indicato. Verifica anche il tema e i must-use plugin se il problema persiste.
Quando devo contattare l’assistenza?
Quando non puoi accedere ai file o ai log, quando il crash coinvolge ownership, configurazione PHP o limiti non gestibili dall’account, oppure quando il sito resta irraggiungibile dopo aver disattivato i plugin. Comunica dominio, URL, ora, messaggio e operazioni già tentate senza inviare password o log completi.
Per una panoramica più ampia consulta anche la guida Xlogic sull’errore critico di WordPress e la procedura ufficiale per gli errori comuni di WordPress.
