WordPress piantato? Come fare il downgrade da terminale prima che sia tardi

I downgraded di WordPress sono un po’ come i viaggi nel tempo: se non stai attento a cosa tocchi, rischi di cancellare la tua stessa esistenza (o almeno quella del tuo sito web).

Eppure, ammettiamolo. Capita a tutti. Aggiorni un plugin, fai scattare l’ultima major release di WordPress e… boom: schermata bianca della morte, layout completamente sfigurato o dashboard inaccessibile. Se la bacheca standard non ne vuole sapere di aprirsi, l’unica scialuppa di salvataggio si chiama terminale.

Niente panico. Niente interfaccia grafica? Meglio. Usare la riga di comando con WP-CLI non è solo un trucco da smanettoni, è il modo più rapido, pulito e sicuro per rimettere in piedi le cose.

Mettiti comodo: vediamo come fare un downgrade al millimetro, senza sudare freddo.

La regola d’oro: prima imbraga il paracadute

Prima di toccare qualsiasi tasto, fermati un secondo. Non fare il fenomeno. Fare un downgrade significa cambiare la struttura interna dei file di sistema e, spesso, fare un passo indietro nel database.

Prima di digitare anche una sola riga di codice, devi fare due cose fondamentali:

1. Un backup completo dei file e del database. Se qualcosa va storto, vuoi poter tornare al punto di partenza con un click.
2. Un backup autonomo del solo database.

Se hai già WP-CLI installato sul tuo server, ti basta posizionarti nella cartella principale del tuo sito (la classica public_html o www) ed estrarre il database al volo con questo comando:

wp db export backup-di-emergenza.sql

Un secondo, invio, fatto. Adesso hai la rete di protezione.

Passo 1: Verifica dove ti trovi

Prima di cambiare rotta, devi sapere esattamente a quale fermata sei sceso. Chiediamo a WP-CLI quale versione di WordPress è attualmente in esecuzione:

wp core version

Il terminale ti sputerà fuori un numero, ad esempio 6.7.1. Mettiamo il caso che questa versione ti stia creando problemi con il tema del sito e tu voglia tornare stabilmente alla 6.6.2.

Passo 2: Il salto all’indietro (con un solo comando)

Ecco la magia della riga di comando. Non devi scaricare archivi .zip, scompattarli via FTP o sovrascrivere cartelle a mano rischiando di perderti pezzi per strada.

Diciamo a WP-CLI di scaricare esattamente la versione che ci serve e di sovrascrivere i file di sistema, usando il flag --force:

wp core update --version=6.6.2 --force

Premi Invio. In una manciata di secondi vedrai scorrere a schermo il download del pacchetto, l’estrazione e la sovrascrittura.

A questo punto la struttura dei file di WordPress è già tornata al passato. Ma manca ancora un piccolo dettaglio.

Passo 3: Allinea il Database

Quando si cambia versione del core di WordPress, quasi sempre cambia anche la struttura del database. Se salti questo passaggio, rischi di ritrovarti con errori strani ogni volta che provi ad accedere all’amministrazione.

Lancia subito questo comando per aggiornare (o riallineare) le tabelle:

wp core update-db

Se il database era già a posto, WP-CLI ti dirà che non c’è niente da fare. In caso contrario, sistemerà le chiavi e le tabelle in un batter d’occhio.

Passo 4: Metti le manette agli aggiornamenti automatici

Hai appena riportato la nave in porto, ma c’è un insidia: se hai gli aggiornamenti automatici attivi, WordPress potrebbe decidere di aggiornarsi di nuovo da solo questa notte stessa, vanificando tutto il lavoro fatto.

Per evitare questo effetto “Giorno della Marmotta”, disattiva temporaneamente i minor e major update automatici. Puoi farlo aggiungendo questa riga direttamente all’interno del tuo file wp-config.php:

define( 'AUTOMATIC_UPDATER_DISABLED', true );

(Ricordati di riattivare la protezione appena avrai risolto i conflitti con plugin o temi e sarai pronto a riaggiornare!)

E se qualcosa va ancora storto?

Se dopo il downgrade il sito continua a fare i capricci, quasi sicuramente la colpa non è di WordPress, ma di un plugin rimasto “incastrato” o incompatibile.

Niente paura, sei sempre nel terminale. Puoi spegnere tutti i plugin in un colpo solo per isolare il problema:

wp plugin deactivate --all

Ora ricarica il sito. Funziona? Bene! Riattivali uno alla volta finché non trovi il colpevole.

Fuori dal tunnel

Hai visto? Niente panico, niente ore passate a caricare file via FTP sperando che la connessione non salti a metà. Usare WP-CLI trasformare operazioni da incubo in una routine da due minuti d’orologio.

Ora il tuo sito è di nuovo online, stabile e funzionante. Tieni la mente fredda, sistema ciò che causava il problema originale e, quando sarai pronto, riparti verso la versione più recente!