{"id":6182,"date":"2012-08-03T11:40:47","date_gmt":"2012-08-03T09:40:47","guid":{"rendered":"http:\/\/xlogic.org\/blog\/?p=6182"},"modified":"2026-08-01T18:22:20","modified_gmt":"2026-08-01T16:22:20","slug":"cosa-fare-quando-un-plugin-causa-un-crash-in-wordpress","status":"publish","type":"post","link":"https:\/\/xlogic.org\/blog\/cosa-fare-quando-un-plugin-causa-un-crash-in-wordpress.html\/","title":{"rendered":"Plugin WordPress causa crash: come ripristinare il sito"},"content":{"rendered":"<p><strong>Quando un plugin WordPress causa un crash, il sito pu\u00f2 mostrare un errore critico, una pagina bianca, un errore HTTP 500 oppure rendere inaccessibile la bacheca.<\/strong> La priorit\u00e0 \u00e8 ripristinare l&#8217;accesso senza cancellare file o dati: identifica il componente coinvolto, disattivalo in modo reversibile e consulta il messaggio PHP che ha provocato il blocco.<\/p>\n<p>Un crash subito dopo l&#8217;installazione o l&#8217;aggiornamento di un plugin non dimostra necessariamente che il plugin sia difettoso. Pu\u00f2 esserci un conflitto con il tema o con un altro componente, una versione PHP non compatibile, un&#8217;estensione mancante, memoria insufficiente oppure un aggiornamento incompleto. Prima di intervenire, annota l&#8217;ora dell&#8217;errore e l&#8217;ultima operazione eseguita.<\/p>\n<h2>Cosa fare subito quando WordPress va in crash<\/h2>\n<p>Evita modifiche multiple contemporaneamente: renderebbero difficile capire quale azione ha risolto o peggiorato il problema. Procedi in questo ordine:<\/p>\n<ol>\n<li>Non aggiornare la pagina ripetutamente e non eliminare subito il plugin.<\/li>\n<li>Annota URL, ora esatta, messaggio visualizzato e operazione appena eseguita.<\/li>\n<li>Controlla l&#8217;email dell&#8217;amministratore per un eventuale collegamento alla modalit\u00e0 di ripristino.<\/li>\n<li>Crea, se possibile, un backup dei file e del database prima di modificare il sito.<\/li>\n<li>Disattiva soltanto il plugin sospetto con il metodo meno invasivo disponibile.<\/li>\n<li>Svuota le cache e verifica il frontend e la bacheca in una finestra anonima.<\/li>\n<li>Consulta il log PHP per individuare file e riga che hanno generato l&#8217;errore.<\/li>\n<\/ol>\n<p>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&#8217;accesso, valutando il ripristino soltanto dopo aver confrontato le date.<\/p>\n<h2>Usare la modalit\u00e0 di ripristino di WordPress<\/h2>\n<p>Dalla versione 5.2, WordPress include una protezione dagli errori fatali. Quando rileva un problema in un plugin o nel tema, pu\u00f2 mostrare il messaggio \u201cSi \u00e8 verificato un errore critico sul tuo sito web\u201d e inviare un&#8217;email all&#8217;indirizzo amministrativo. Il collegamento contenuto nel messaggio permette di accedere alla <strong>Recovery Mode<\/strong>, dove il componente problematico viene sospeso per la sessione dell&#8217;amministratore.<\/p>\n<p>Apri l&#8217;email soltanto dopo aver verificato che il dominio del collegamento appartenga realmente al sito. Una volta entrato:<\/p>\n<ol>\n<li>vai in <strong>Plugin \u2192 Plugin installati<\/strong>;<\/li>\n<li>individua il componente indicato da WordPress;<\/li>\n<li>disattivalo senza eliminarlo;<\/li>\n<li>esci dalla modalit\u00e0 di ripristino;<\/li>\n<li>controlla sia le pagine pubbliche sia <code>\/wp-admin\/<\/code>.<\/li>\n<\/ol>\n<p>Se l&#8217;email non arriva, verifica che l&#8217;indirizzo in <strong>Impostazioni \u2192 Generali<\/strong> sia corretto e controlla spam e recapito della posta. Non \u00e8 necessario attendere il messaggio: puoi utilizzare File Manager, SFTP o WP-CLI per disattivare il plugin.<\/p>\n<h2>Disattivare il plugin dalla bacheca<\/h2>\n<p>Se l&#8217;amministrazione \u00e8 ancora accessibile, apri <strong>Plugin \u2192 Plugin installati<\/strong> e disattiva il componente aggiornato o attivato immediatamente prima del crash. Non premere \u201cElimina\u201d: la disattivazione \u00e8 reversibile e conserva i file, mentre la disinstallazione pu\u00f2 rimuovere dati o impostazioni se il plugin prevede una routine di pulizia.<\/p>\n<p>Dopo la disattivazione, svuota la cache di WordPress e l&#8217;eventuale cache server, quindi verifica il sito senza essere autenticato. Se l&#8217;errore scompare, conserva il plugin inattivo mentre controlli changelog, requisiti PHP, ticket di supporto e disponibilit\u00e0 di una versione corretta.<\/p>\n<p>Se l&#8217;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.<\/p>\n<h2>Disattivare un plugin con File Manager, SFTP o FTP<\/h2>\n<p>Quando <code>\/wp-admin\/<\/code> non si apre, accedi ai file tramite il File Manager di cPanel oppure con SFTP. SFTP \u00e8 preferibile quando disponibile perch\u00e9 cifra la connessione; la guida sulle <a href=\"https:\/\/xlogic.org\/kb\/knowledgebase\/sftp-ftps-ftp-differenze-configurazione-sicura\/\">differenze tra SFTP, FTPS e FTP<\/a> aiuta a scegliere il protocollo corretto.<\/p>\n<h3>Se conosci il plugin responsabile<\/h3>\n<p>Apri <code>wp-content\/plugins\/<\/code>, individua la cartella del plugin e rinominala aggiungendo un suffisso, per esempio:<\/p>\n<pre><code>nome-plugin\r\nnome-plugin.disattivato<\/code><\/pre>\n<p>WordPress non trover\u00e0 pi\u00f9 il componente nel percorso registrato e lo considerer\u00e0 disattivato. Non cancellare la cartella: rinominarla permette di tornare indietro e conserva una copia utile per l&#8217;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\u00e0 segnato come mancante.<\/p>\n<h3>Se non sai quale plugin causa il crash<\/h3>\n<p>Rinomina temporaneamente l&#8217;intera cartella:<\/p>\n<pre><code>wp-content\/plugins\r\nwp-content\/plugins.hold<\/code><\/pre>\n<p>Se il sito torna accessibile, entra nella bacheca e visita la schermata dei plugin; quindi ripristina il nome <code>plugins<\/code>. I componenti standard risulteranno disattivati e potranno essere riattivati uno alla volta. Verifica il sito dopo ogni riattivazione, finch\u00e9 l&#8217;errore ricompare.<\/p>\n<p>Non rinominare <code>wp-content<\/code> e non spostare cartelle non correlate. I plugin must-use presenti in <code>wp-content\/mu-plugins\/<\/code> 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.<\/p>\n<h2>Disattivare il plugin tramite WP-CLI<\/h2>\n<p>Con accesso SSH, WP-CLI consente di verificare e disattivare i plugin senza aprire WordPress nel browser. Posizionati nella directory corretta dell&#8217;installazione oppure specifica il percorso con <code>--path<\/code>.<\/p>\n<h3>Elencare i plugin e il loro stato<\/h3>\n<pre><code>wp plugin list<\/code><\/pre>\n<p>La colonna <code>status<\/code> mostra quali componenti sono attivi. Per disattivare soltanto quello sospetto usa lo slug della directory, non il nome commerciale mostrato nella bacheca:<\/p>\n<pre><code>wp plugin deactivate nome-plugin<\/code><\/pre>\n<h3>Se un plugin impedisce l&#8217;avvio di WP-CLI<\/h3>\n<p>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&#8217;operazione:<\/p>\n<pre><code>wp --skip-plugins plugin deactivate nome-plugin<\/code><\/pre>\n<p>Se il problema riguarda un solo componente e ne conosci lo slug, puoi anche usare <code>--skip-plugins=nome-plugin<\/code>. I must-use plugin vengono comunque caricati: un errore in <code>mu-plugins<\/code> richiede un intervento specifico.<\/p>\n<h3>Disattivare tutti i plugin come test<\/h3>\n<pre><code>wp --skip-plugins plugin deactivate --all<\/code><\/pre>\n<p>Questa operazione va usata solo quando non \u00e8 possibile individuare il componente dal log. In un e-commerce o in un sito con funzioni critiche, disattivare tutto pu\u00f2 interrompere pagamenti, moduli, aree riservate e cache: pianifica il test, registra lo stato iniziale e riattiva i plugin uno alla volta.<\/p>\n<h2>Leggere il messaggio che ha causato il crash<\/h2>\n<p>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 <strong>Metriche \u2192 Errori<\/strong>; in alcune configurazioni \u00e8 presente anche un file <code>error_log<\/code> nella directory del sito.<\/p>\n<h3>Informazioni utili nel PHP fatal error<\/h3>\n<p>Una riga simile a <code>PHP Fatal error<\/code> contiene normalmente il tipo di errore, il percorso del file e il numero di riga. Alcuni messaggi frequenti sono:<\/p>\n<table>\n<thead>\n<tr>\n<th>Messaggio<\/th>\n<th>Possibile significato<\/th>\n<th>Controllo iniziale<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>Call to undefined function<\/code><\/td>\n<td>Funzione o estensione non disponibile<\/td>\n<td>Versione PHP, estensioni e dipendenze<\/td>\n<\/tr>\n<tr>\n<td><code>Allowed memory size exhausted<\/code><\/td>\n<td>Memoria PHP esaurita<\/td>\n<td>Consumo del processo e limite assegnato<\/td>\n<\/tr>\n<tr>\n<td><code>Uncaught TypeError<\/code><\/td>\n<td>Codice incompatibile o dato inatteso<\/td>\n<td>Versioni di PHP, plugin e tema<\/td>\n<\/tr>\n<tr>\n<td><code>Cannot redeclare<\/code><\/td>\n<td>Funzione o classe dichiarata due volte<\/td>\n<td>Conflitto o duplicazione dei file<\/td>\n<\/tr>\n<tr>\n<td><code>Failed opening required<\/code><\/td>\n<td>File mancante o percorso errato<\/td>\n<td>Integrit\u00e0 dell&#8217;aggiornamento e permessi<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Non pubblicare l&#8217;intero log: pu\u00f2 contenere percorsi del server, indirizzi IP, query o altri dati riservati. Quando chiedi assistenza, invia solo le righe pertinenti, l&#8217;ora con fuso orario, l&#8217;URL coinvolto e le operazioni gi\u00e0 eseguite.<\/p>\n<h2>Attivare WP_DEBUG_LOG senza mostrare errori ai visitatori<\/h2>\n<p>Se i log disponibili non mostrano abbastanza dettagli, WordPress pu\u00f2 scrivere gli errori in <code>wp-content\/debug.log<\/code>. Crea prima una copia di <code>wp-config.php<\/code>, quindi inserisci temporaneamente queste costanti prima della riga finale che interrompe le modifiche:<\/p>\n<pre><code>define( 'WP_DEBUG', true );\r\ndefine( 'WP_DEBUG_LOG', true );\r\ndefine( 'WP_DEBUG_DISPLAY', false );\r\n@ini_set( 'display_errors', 0 );<\/code><\/pre>\n<p>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 <code>debug.log<\/code> pu\u00f2 crescere rapidamente e contenere informazioni sensibili; eliminalo o proteggilo quando l&#8217;analisi \u00e8 terminata. Consulta anche la <a href=\"https:\/\/developer.wordpress.org\/advanced-administration\/debug\/debug-wordpress\/\" rel=\"noopener\" target=\"_blank\">documentazione ufficiale sul debug di WordPress<\/a>.<\/p>\n<h2>Perch\u00e9 un plugin manda WordPress in crash<\/h2>\n<h3>Plugin non compatibile con la versione PHP<\/h3>\n<p>Un componente datato pu\u00f2 utilizzare funzioni rimosse o comportamenti diventati pi\u00f9 rigorosi nelle versioni recenti di PHP. Confronta i requisiti dichiarati dal plugin con la versione attiva in cPanel. Un downgrade PHP pu\u00f2 essere utile come test temporaneo, ma non \u00e8 una soluzione permanente: mantenere una versione non supportata aumenta i rischi di sicurezza e compatibilit\u00e0.<\/p>\n<h3>Conflitto con un altro plugin o con il tema<\/h3>\n<p>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.<\/p>\n<h3>Aggiornamento incompleto o file mancanti<\/h3>\n<p>Una connessione interrotta o lo spazio disco insufficiente possono lasciare il plugin in uno stato parziale. Non sovrascrivere subito l&#8217;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.<\/p>\n<h3>Memoria PHP o risorse esaurite<\/h3>\n<p>Importazioni, backup, scansioni o query pesanti possono superare memoria, CPU o processi disponibili. Aumentare il limite senza capire il consumo pu\u00f2 soltanto rinviare il problema. Confronta l&#8217;ora dell&#8217;errore con le statistiche di cPanel e verifica se il log indica <code>Allowed memory size exhausted<\/code> o un timeout.<\/p>\n<h3>Dipendenza mancante o ordine di caricamento<\/h3>\n<p>Alcuni plugin richiedono un componente principale, un&#8217;estensione PHP o una versione minima di WordPress. Controlla la pagina dei requisiti e il changelog. Se il crash \u00e8 comparso dopo l&#8217;aggiornamento di una dipendenza, prova la combinazione corretta in un ambiente di staging prima di modificare nuovamente il sito pubblico.<\/p>\n<h2>Come riattivare il sito in sicurezza<\/h2>\n<p>Dopo aver individuato il plugin, non riattivarlo direttamente in produzione per \u201cvedere se funziona\u201d. 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.<\/p>\n<ol>\n<li>conserva il plugin problematico disattivato;<\/li>\n<li>crea un nuovo backup dello stato funzionante;<\/li>\n<li>aggiorna il plugin da una fonte ufficiale o ripristina una versione nota e compatibile;<\/li>\n<li>esegui il test in staging con la stessa versione PHP della produzione;<\/li>\n<li>controlla pagine, moduli, login, checkout, cron e log;<\/li>\n<li>applica la correzione al sito pubblico in una finestra di manutenzione;<\/li>\n<li>svuota tutte le cache e monitora gli errori.<\/li>\n<\/ol>\n<p>Se il plugin non \u00e8 pi\u00f9 mantenuto, valuta un&#8217;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.<\/p>\n<h2>Quando ripristinare un backup<\/h2>\n<p>Il ripristino \u00e8 indicato quando l&#8217;aggiornamento ha modificato dati o file in modo non facilmente reversibile, quando pi\u00f9 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.<\/p>\n<p>Prima di procedere, considera i dati creati dopo il backup: ordini, email, commenti, utenti e modifiche editoriali potrebbero andare persi. Nei siti dinamici pu\u00f2 essere preferibile ripristinare soltanto i file del plugin o lavorare su una copia, anzich\u00e9 riportare indietro l&#8217;intero database.<\/p>\n<p>Dopo il ripristino cambia la versione del componente responsabile o lascialo disattivato; ripristinare lo stesso stato che ha causato il crash farebbe ricomparire l&#8217;errore. Controlla inoltre che il backup sia integro e conserva una copia dello stato attuale prima di sovrascriverlo.<\/p>\n<h2>Non sostituire wp-admin e wp-includes senza una diagnosi<\/h2>\n<p>Un plugin normalmente non dovrebbe modificare i file del core. Sostituire indiscriminatamente <code>wp-admin<\/code> e <code>wp-includes<\/code> non \u00e8 quindi il secondo passaggio standard dopo un crash: pu\u00f2 introdurre file di una versione diversa e nascondere la causa reale.<\/p>\n<p>Con accesso SSH, verifica prima l&#8217;integrit\u00e0 del core con:<\/p>\n<pre><code>wp core verify-checksums<\/code><\/pre>\n<p>Il comando confronta i file dell&#8217;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 <code>wp-content<\/code> e <code>wp-config.php<\/code>. La <a href=\"https:\/\/developer.wordpress.org\/cli\/commands\/core\/verify-checksums\/\" rel=\"noopener\" target=\"_blank\">documentazione WP-CLI sui checksum<\/a> descrive opzioni e limiti del controllo.<\/p>\n<h2>Domande frequenti sui crash causati dai plugin<\/h2>\n<h3>Rinominare la cartella elimina il plugin?<\/h3>\n<p>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.<\/p>\n<h3>Posso cancellare direttamente il plugin via FTP?<\/h3>\n<p>\u00c8 preferibile di no. La cancellazione \u00e8 meno reversibile e rende pi\u00f9 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.<\/p>\n<h3>La disattivazione cancella le impostazioni?<\/h3>\n<p>Di norma no, ma il comportamento dipende dal componente. La disinstallazione pu\u00f2 eseguire routine che eliminano tabelle o opzioni, mentre la semplice disattivazione normalmente conserva i dati. Consulta la documentazione del plugin prima di cancellarlo.<\/p>\n<h3>Il sito funziona ma non riesco ad accedere a wp-admin: \u00e8 comunque un plugin?<\/h3>\n<p>S\u00ec, un errore pu\u00f2 interessare soltanto le pagine amministrative. Consulta il log relativo all&#8217;URL di accesso e disattiva il componente indicato. Verifica anche il tema e i must-use plugin se il problema persiste.<\/p>\n<h3>Quando devo contattare l&#8217;assistenza?<\/h3>\n<p>Quando non puoi accedere ai file o ai log, quando il crash coinvolge ownership, configurazione PHP o limiti non gestibili dall&#8217;account, oppure quando il sito resta irraggiungibile dopo aver disattivato i plugin. Comunica dominio, URL, ora, messaggio e operazioni gi\u00e0 tentate senza inviare password o log completi.<\/p>\n<p>Per una panoramica pi\u00f9 ampia consulta anche la guida Xlogic sull&#8217;<a href=\"https:\/\/xlogic.org\/kb\/knowledgebase\/errore-critico-wordpress-cause-soluzioni\/\">errore critico di WordPress<\/a> e la procedura ufficiale per gli <a href=\"https:\/\/developer.wordpress.org\/advanced-administration\/wordpress\/common-errors\/\" rel=\"noopener\" target=\"_blank\">errori comuni di WordPress<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Quando un plugin WordPress causa un crash, il sito pu\u00f2 mostrare un errore critico, una pagina bianca, un errore HTTP 500 oppure rendere inaccessibile la bacheca. La priorit\u00e0 \u00e8 ripristinare l&#8217;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 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":19156,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"no","_lmt_disable":"","footnotes":""},"categories":[1401],"tags":[28,698,32],"class_list":["post-6182","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress","tag-wordpress","tag-wordpress-crash","tag-wordpress-plugin"],"modified_by":"Team tecnico Xlogic","_links":{"self":[{"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/posts\/6182","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/comments?post=6182"}],"version-history":[{"count":0,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/posts\/6182\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/media\/19156"}],"wp:attachment":[{"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/media?parent=6182"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/categories?post=6182"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/xlogic.org\/blog\/wp-json\/wp\/v2\/tags?post=6182"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}