
Una mattina il sito risponde con una pagina bianca, o con un secco HTTP 500. Nessuno ha toccato niente, giurano tutti, compreso il sito. Se gira su Joomla 3, quasi sempre la causa è una sola: il server è passato a una versione nuova di PHP.
Perché succede
Joomla 3 ha smesso di ricevere aggiornamenti nel 2023 ed è stato scritto per versioni di PHP che oggi sono fuori supporto. Quando l'hosting aggiorna PHP, per esempio alla 8.3, il codice vecchio va in errore fatale e il sito si ferma, amministrazione compresa. Non puoi nemmeno entrare a vedere cosa succede: è come restare chiusi fuori casa con le chiavi dentro, e la casa ha anche staccato il campanello.
A quel punto c'è sempre qualcuno che alza il dito e pronuncia la formula sacra: «Abbiamo sempre fatto così e ha sempre funzionato». Verissimo. Fino a stamattina alle otto.
Le tre strade
- Tornare a un PHP vecchio: rimette in piedi il sito in cinque minuti, ma su un software senza aggiornamenti di sicurezza. È una toppa, non una soluzione: un cerotto su una diga, che regge benissimo finché non piove.
- Passare a Joomla 4 e poi 5: la strada ufficiale, a tappe. Funziona se le estensioni installate hanno versioni compatibili. Se una è stata abbandonata dal suo autore anni fa, la tappa diventa un pellegrinaggio.
- Migrare direttamente a Joomla 6: si ricostruisce il sito su una base pulita e si portano i contenuti. È la strada giusta quando il sito usa componenti abbandonati.
Come la facciamo noi
Prima di tutto una copia di prova, separata dal sito pubblico e ricostruibile da zero con uno script. È il nostro laboratorio segreto sotto la montagna: là dentro può esplodere qualunque cosa, e fuori nessuno sente niente. Lì si convertono i contenuti, si sostituiscono le estensioni morte e si verifica ogni indirizzo.
# controllo dei redirect dopo la migrazione
grep -c " 301 " controllo_url.log
grep " 404 " controllo_url.log | head
Tradotto: la prima riga conta gli indirizzi reindirizzati correttamente, la seconda mostra i primi che non si trovano più. Il numero che sogno la notte, per la seconda, è zero.
Gli URL sono sacri
Il punto più delicato sono gli indirizzi delle pagine: anni di link e di posizionamento passano da lì. Con un plugin su misura gli indirizzi storici restano identici, e quelli cambiati hanno il loro 301. Google non deve accorgersi di niente. Deve pensare che il sito sia solo andato dal parrucchiere.
Il gran ritorno
Solo quando la copia è perfetta si passa in produzione. Il sito torna online su una base che durerà anni, non mesi, e l'errore 500 diventa un aneddoto da raccontare a cena. A cena tra sistemisti, s'intende: gli altri commensali di solito se ne vanno prima del dolce.