Aggiornare TubePress

TubePress si aggiorna come WordPress: un clic nel pannello di amministrazione recupera una release firmata, la verifica, esegue un backup, sostituisce il core ed esegue le eventuali migrazioni del database. Temi, plugin, media e impostazioni vengono lasciati intatti.

Questa pagina spiega esattamente cosa cambia un aggiornamento, come applicarlo e come restare al sicuro.

Come funzionano gli aggiornamenti

Le release sono distribuite come pacchetti firmati da tubepress.io. Prima che TubePress tocchi un singolo file, ogni pacchetto viene verificato due volte:

• un checksum SHA-256 — una mancata corrispondenza interrompe l'aggiornamento; e
• una firma Ed25519 — il core rifiuta l'installazione senza una firma valida, quindi un pacchetto core manomesso o non firmato viene rifiutato direttamente.

Un aggiornamento sostituisce esclusivamente il core fisso. In concreto:

Appena prima di sostituire i file, TubePress copia il core attuale in storage/backups/ e crea un backup del database. Se non riesce a creare quel backup del database, l'aggiornamento del core viene interrotto piuttosto che rischiare i tuoi dati. I file vengono quindi sostituiti in modo atomico, le nuove migrazioni numerate in sql/ vengono eseguite automaticamente e il risultato viene scritto in un log degli aggiornamenti che puoi esaminare o da cui puoi ripristinare.

Aggiornamento con un clic

Vai su Admin → Aggiornamenti in /admin/updates (accesso come amministratore richiesto). La schermata mostra la versione attuale e gli aggiornamenti disponibili per il core, i plugin e i temi. Controlla aggiornamenti richiede a tubepress.io su richiesta.

Fai clic per applicare un elemento e TubePress scarica, verifica, esegue il backup, sostituisce e migra — poi registra il risultato. Se qualcosa sembra sbagliato in seguito, puoi ripristinare il backup appena creato.

Aggiornamenti automatici

Preferisci la gestione automatica? Abilita l'impostazione auto_update_enabled (è disattivata per impostazione predefinita). Quando attiva, un'attività pseudo-cron in background controlla periodicamente e applica gli aggiornamenti in sospeso al massimo una volta al giorno. Per sicurezza è volutamente conservativa:

• il core e i plugin gratuiti si aggiornano automaticamente;
• i temi vengono sempre lasciati all'aggiornamento manuale, in modo che le personalizzazioni non vengano mai sovrascritte automaticamente; e
• gli elementi a pagamento vengono ignorati — richiedono un acquisto dal marketplace.

Lo scheduler è lo stesso pseudo-cron integrato usato altrove — vedi Manutenzione.

Aggiornamento manuale

L'updater con un clic è il percorso consigliato perché è l'unico che verifica anche le firme, crea backup ed esegue le migrazioni del database. Se il pannello non riesce a raggiungere tubepress.io (un host con firewall o isolato dalla rete), puoi aggiornare manualmente:

1. Prima fai un backup. Esegui un backup completo di file e database — vedi Backup.
2. Ottieni la release ufficiale. Scarica il file ZIP firmato dalla pagina di download o dal tuo account.
3. Sostituisci solo il core. Sovrascrivi src/, sql/, templates/admin/, templates/install/ e config/app.php dalla nuova release. Lascia themes/, plugins/, public/uploads/ e config/database.php al loro posto.
4. Applica le nuove migrazioni. Applica al database i nuovi file numerati in sql/ — questo è il passaggio che l'updater integrato normalmente esegue per te.

La guardia della versione PHP

TubePress include un piccolo gate sicuro al parsing (config/php-guard.php) che viene eseguito a ogni punto di ingresso prima dell'avvio dell'applicazione. È scritto in PHP volutamente in stile tradizionale in modo da poter essere analizzato su qualsiasi versione — il che significa che se un sito viene spostato su, o retrocesso a, un PHP più vecchio della versione richiesta 8.2, i visitatori vedono una pagina pulita “PHP upgrade required” invece di un errore fatale grezzo.

Questo è importante in relazione agli aggiornamenti: le release più recenti potrebbero usare sintassi PHP più nuova, quindi conferma che il tuo host esegua PHP 8.2 o versioni successive (8.4 consigliato) prima e dopo l'aggiornamento. Maggiori dettagli in Manutenzione.

Prima di aggiornare

Gli aggiornamenti sono progettati per essere sicuri e reversibili, ma un backup è comunque la tua cintura di sicurezza:

• Esegui il backup di file e database — l'updater crea il proprio, ma mantieni anche una copia personale. Vedi Backup.
• Controlla PHP — conferma di essere su 8.2+ (idealmente 8.4).
• Annota le personalizzazioni — le modifiche a temi e plugin vengono preservate, ma un rapido inventario non fa mai male.
• Aggiorna in un momento tranquillo — la sostituzione è quasi istantanea, ma scegli un periodo di basso traffico per ogni evenienza.

Passi successivi