Aggiornamento Moodle bloccato? Ecco come risolvere

Come riconoscere un aggiornamento fallito

• Pagina bianca dopo l’aggiornamento
• Errore PHP o 500 subito dopo il login
• Pagina “Upgrade Moodle Database” che si ripete
• Moodle si blocca a metà aggiornamento e non prosegue
• Schermata che richiede costantemente la conferma dell’aggiornamento

Perché l’aggiornamento si blocca?

• File Moodle incompleti o sovrascritti male
• Permessi errati nelle cartelle
• Database corrotto o interrotto durante l’update
• Plugin o temi non compatibili
• Timeout del server durante la fase di upgrade

Come ripristinare e completare l’aggiornamento

1. Controlla i file Moodle

Carica nuovamente tutti i file di Moodle scaricati dal sito ufficiale, sovrascrivendo tutto tranne:

• config.php
• la cartella moodledata

2. Attiva il debug

In config.php, aggiungi queste righe per visualizzare eventuali errori:

$CFG->debug = (E_ALL | E_STRICT);
$CFG->debugdisplay = true;

3. Forza l’aggiornamento via URL

Vai a:
https://tuosito.it/admin/index.php
Questo forza Moodle a riprendere il processo di aggiornamento.

4. Verifica i permessi

Le cartelle devono avere permessi `755`, i file `644`. Cartelle come `/theme`, `/mod`, `/admin` devono essere leggibili ed eseguibili dal server.

5. Rimuovi plugin non compatibili

Se l’aggiornamento si blocca su un plugin, accedi via FTP e rinomina la cartella del plugin. Esempio:
/mod/plugin_buggato → /mod/plugin_buggato_old

Come evitare problemi con i prossimi aggiornamenti

• Fai sempre un backup completo prima dell’upgrade
• Testa l’aggiornamento in un ambiente di staging
• Verifica compatibilità di plugin e tema prima di aggiornare
• Segui le istruzioni ufficiali Moodle passo per passo