WordPress non funziona dopo l'aggiornamento: come tornare indietro

Che cosa è stato aggiornato?

Su un sito WordPress si aggiornano quattro cose, e ognuna torna indietro in modo diverso: il core di WordPress, i plugin, il tema e la versione di PHP del server, che il provider aggiorna secondo il proprio calendario. Per capire quale si è mosso:

• Le email di WordPress: dopo un aggiornamento automatico, WordPress scrive all'indirizzo di amministrazione del sito con un oggetto come «[Nome del sito] Alcuni plugin sono stati aggiornati automaticamente», con l'elenco di ciò che è cambiato.
• La schermata Plugin: la colonna «Aggiornamenti automatici» mostra quali plugin si aggiornano da soli, e ogni riga indica la versione installata.
• Strumenti > Salute del sito (Site Health) > Informazioni: la sezione Server indica la versione di PHP, e le sezioni dei plugin e dei temi la versione di ogni componente.
• Le date delle cartelle: la cartella di un plugin riscritta da un aggiornamento porta la data di quell'aggiornamento.

wp plugin list
ls -lt wp-content/plugins | head

Il primo comando elenca i plugin con versione e stato; il secondo elenca le cartelle dei plugin dalla modificata più di recente alla più vecchia. Confrontatele con il momento in cui il sito è cambiato.

Svuotare le cache prima di trarre conclusioni

Dopo un aggiornamento cambiano i file CSS e JavaScript, e una cache può continuare a servire quelli vecchi. Il risultato sembra un guasto: impaginazione a pezzi, menu che non si aprono più. Svuotate, in quest'ordine, la cache del plugin di cache o di ottimizzazione, quella del provider di hosting se ne offre una, poi quella del browser, e ricaricate. Se il sito torna, l'aggiornamento non era il problema.

Il sito è bloccato in modalità manutenzione

Durante un aggiornamento, WordPress crea un file .maintenance nella cartella principale del sito e mostra «Momentaneamente non disponibile per manutenzione. Riprova fra un minuto.» Quando l'aggiornamento si interrompe, il file resta al suo posto. WordPress lo ignora dieci minuti dopo l'ora registrata al suo interno; per non aspettare, o se il messaggio persiste, eliminatelo via SFTP o con il file manager del provider. Il suo nome comincia con un punto: attivate la visualizzazione dei file nascosti per vederlo.

Poi andate in Bacheca > Aggiornamenti: l'elemento il cui aggiornamento si è interrotto va aggiornato di nuovo, o reinstallato nella versione precedente.

Rimettere la versione precedente di un plugin

Reinstallare la versione precedente sostituisce i file del plugin e ne conserva le impostazioni, che stanno nel database.

wp plugin install nome-plugin --version=2.4.1 --force

• Plugin della directory di WordPress.org: nella sua pagina pubblica, il link «Visualizzazione avanzata» porta alla sezione «Versioni precedenti e di sviluppo». Scaricate l'archivio che vi serve, poi nella schermata «Aggiungi plugin» fate clic su «Carica plugin»: WordPress riconosce il plugin già installato e propone «Sostituisci l'attuale con quello caricato».
• Plugin acquistato da uno sviluppatore: le versioni precedenti si scaricano di solito dal vostro account cliente presso di lui.
• Poi: fate clic su «Disabilita gli aggiornamenti automatici» accanto a quel plugin, finché lo sviluppatore non pubblica una correzione.

WordPress torna già indietro da solo in due casi. Dalla versione 6.3, quando l'aggiornamento di un plugin o di un tema non riesce a metà, la vecchia versione viene rimessa al suo posto. Dalla versione 6.6, quando l'aggiornamento automatico di un plugin attivo provoca un errore fatale, WordPress reinstalla la versione precedente. Un aggiornamento che va a buon fine e rompe una funzione senza errore fatale si annulla invece a mano.

Il tema: la versione precedente, e le personalizzazioni perse

wp theme install nome-tema --version=3.1.0 --force

Un aggiornamento del tema sostituisce tutti i suoi file. Le modifiche fatte direttamente nei file del tema, in functions.php o in un foglio di stile per esempio, spariscono quindi a ogni aggiornamento. Il backup fatto prima dell'aggiornamento permette di recuperarle; per conservarle in modo stabile, vanno messe in un tema child, che gli aggiornamenti del tema principale lasciano intatto.

Il core di WordPress

WP-CLI reinstalla una versione precisa del core:

wp core update --version=7.0 --force

Un aggiornamento principale del core può anche modificare la struttura del database, che questo comando lascia com'è. La strada più sicura è spesso tenere il core aggiornato e riportare indietro il plugin o il tema incompatibile. Se tornare indietro sul core è inevitabile, fatelo da un backup completo precedente all'aggiornamento.

La versione di PHP, cambiata dal provider

I provider fanno avanzare PHP man mano che le versioni più vecchie smettono di ricevere correzioni di sicurezza. Un plugin o un tema datato può allora fermarsi su un errore fatale. I pannelli di hosting permettono di solito di scegliere la versione di PHP del sito:

1. Annotate la versione attuale, poi tornate alla precedente.
2. Verificate che il sito funzioni di nuovo.
3. Aggiornate o sostituite il componente responsabile, individuato grazie al log di debug.
4. Tornate alla versione recente.

Questo passaggio serve alla diagnosi: una versione di PHP senza correzioni di sicurezza lascia il sito esposto. Secondo il calendario ufficiale di php.net, PHP 8.1 non riceve più correzioni di sicurezza dal 31 dicembre 2025, PHP 8.2 le riceve fino al 31 dicembre 2026 e PHP 8.3 fino al 31 dicembre 2027. WordPress consiglia PHP 8.3 o superiore.

Ripristinare un backup completo, come ultima risorsa

Un ripristino riporta i file e il database allo stato del backup. Tutto ciò che il sito ha ricevuto da allora va perso: ordini, messaggi dei moduli, commenti, iscrizioni, articoli pubblicati.

1. Esportate prima ciò che è arrivato dopo il backup: ordini, invii dei moduli, nuovi account.
2. Ripristinate file e database dello stesso momento, con lo strumento del provider o con il vostro plugin di backup. File di un giorno e database di un altro producono errori difficili da leggere.
3. Importate di nuovo i dati esportati.
4. Riapplicate gli aggiornamenti uno alla volta, controllando il sito tra l'uno e l'altro: l'ultimo applicato prima del guasto è quello che lo provoca.

Per il prossimo aggiornamento

• Una copia di prova: molti provider offrono un ambiente di staging che copia il sito con un clic. Gli aggiornamenti passano prima da lì.
• Un backup subito prima, file e database insieme.
• Un aggiornamento alla volta, controllando nel frattempo le pagine chiave: home page, modulo di contatto, carrello.
• Il registro delle modifiche del plugin o del tema, letto prima di un aggiornamento importante.