Combinando tutto questo con l’infrastruttura e gli strumenti di Kinsta, si ottiene un modo per automatizzare l’esecuzione delle migrazioni durante le distribuzioni.<\/p>\n
Perch\u00e9 le modifiche al database di WordPress necessitano di un controllo di versione<\/h2>\n
Le modifiche manuali al database trattano le modifiche allo schema come operazioni una tantum piuttosto che come codice versionato. Ad esempio, esegui una query SQL<\/a> per aggiungere una tabella personalizzata, esegui un’istruzione Spesso gli ambienti di staging iniziano a divergere da quelli locali quando ci si dimentica di documentare le modifiche pi\u00f9 piccole (come l’aggiunta di una colonna al database locale), il che fa fallire anche le distribuzioni di produzione. Ci\u00f2 comporta anche la mancanza di una traccia di controllo.<\/p>\n Le migrazioni di Laravel<\/a> sono un buon modo per eliminare questi errori di coordinamento, poich\u00e9 trattano le modifiche al database come codice in versione che vive nel repository Git. Questo viene distribuito insieme all’applicazione e viene eseguito nello stesso ordine in ogni ambiente.<\/p>\n Le migrazioni Laravel sono file PHP che definiscono le modifiche allo schema del database attraverso due metodi: Il sistema di migrazione tiene traccia delle modifiche eseguite utilizzando una tabella Questo monitoraggio evita che le migrazioni vengano eseguite pi\u00f9 volte e mostra esattamente quali modifiche allo schema sono state applicate a qualsiasi ambiente.<\/p>\n Acorn integra il costruttore di schemi di Laravel, che fornisce una sintassi PHP fluida per creare e modificare le tabelle del database. Invece di scrivere SQL grezzo, si utilizzano metodi come La creazione delle migrazioni avviene tramite WP-CLI<\/a>:<\/p>\n Questo genera un nuovo file di migrazione nella directory Il metodo Esegui le migrazioni in sospeso con il comando Quando hai bisogno di invertire l’ultimo lotto di migrazioni, usa il comando Dopo aver eseguito le migrazioni, Database Studio di Kinsta<\/a> (o qualsiasi altro strumento per database) permette di verificare che le tabelle e le colonne previste esistano con la struttura corretta. Puoi accedere a Database Studio dalla dashboard di MyKinsta navigando in qualsiasi sito e cliccando sulla scheda Database<\/strong>:<\/p>\n La Console SQL inclusa permette di eseguire query di verifica per confermare che le migrazioni abbiano creato la struttura prevista.<\/p>\n Dopo aver creato la tabella Il filtro permette di esaminare record o colonne specifiche senza scrivere query SQL. Qui puoi cliccare sulle intestazioni delle colonne per ordinare, applicare filtri per restringere i risultati ed esportare i dati:<\/p>\n Queste opzioni di esportazione sono utili per testare le procedure di rollback.<\/p>\n Kinsta include l’accesso SSH<\/a> e WP-CLI in tutti i piani. Ci\u00f2 significa che puoi eseguire i comandi di migrazione direttamente sui tuoi ambienti di staging e di produzione senza alcuna configurazione aggiuntiva.<\/p>\n Per eseguire le migrazioni su un ambiente Kinsta, devi prima connetterti ad esso utilizzando SSH<\/a>. Le credenziali si trovano nella schermata delle informazioni<\/strong> di ogni sito di MyKinsta:<\/p>\n Una volta effettuata la connessione e l’autenticazione, vai alla root del documento del sito. Per i siti Radicle, questa \u00e8 la directory Il processo di migrazione visualizza un output che mostra quali migrazioni sono in corso e lo stato di completamento di ciascuna. Questa procedura funziona anche negli ambienti di staging e di produzione<\/a> perch\u00e9 Acorn tiene traccia delle migrazioni in modo indipendente nel database di ciascun ambiente.<\/p>\n Gli ambienti di staging di Kinsta<\/a> sono uno spazio sicuro per testare le migrazioni prima di distribuirle in produzione, ma \u00e8 necessario un flusso di lavoro affidabile per poterle testare. Una volta verificate le modifiche alla migrazione all’interno di Database Studio, prova il rollback per assicurarti che il metodo Per farlo, passa all’ambiente di staging in MyKinsta, naviga nella scheda Database<\/strong> e ispeziona le tabelle create o modificate dalle migrazioni.<\/p>\n Se scopri dei problemi durante i test di staging, il comando Il push selettivo di Kinsta permette di distribuire solo le modifiche che hai testato, quindi puoi scegliere se distribuire solo i file alla produzione o se distribuire sia i file che il database:<\/p>\n Per i flussi di lavoro di migrazione, in genere si effettua il push solo dei file perch\u00e9 le migrazioni vengono eseguite sul database di produzione esistente anzich\u00e9 sovrascriverlo con i dati di staging.<\/p>\n I flussi di lavoro di migrazione automatizzati eseguono le modifiche allo schema del database durante la distribuzione del codice, eliminando i passaggi manuali e riducendo gli errori di distribuzione. Per ottenere questo risultato \u00e8 necessario aggiungere comandi di migrazione al processo di distribuzione, sia che si tratti di script SSH manuali, di automazione delle GitHub Actions<\/a> o di strumenti come Trellis<\/a> di Roots.<\/p>\n Per le distribuzioni manuali tramite SSH, connettiti al tuo ambiente di produzione e naviga nella root del documento. Quindi, esegui questi comandi in sequenza:<\/p>\n Il flag Se utilizzi GitHub Actions per la distribuzione continua, automatizzi le migrazioni nel tuo file di flusso di lavoro. Radicle include una configurazione di Il flusso di lavoro di distribuzione si collega via SSH, naviga nella directory del sito ed esegue il comando di migrazione.<\/p>\n Per le distribuzioni che utilizzano Trellis, le migrazioni si integrano negli hook di distribuzione. Puoi includere i seguenti elementi modificando Questo esegue le migrazioni dopo che Trellis ha completato le altre attivit\u00e0 di distribuzione. Le migrazioni vengono eseguite nella nuova directory di rilascio e Trellis gestisce il rollback se la distribuzione fallisce.<\/p>\n I file di migrazione si trovano nella directory Il flusso di commit per le migrazioni segue uno schema coerente:<\/p>\n Una volta revisionata la migrazione, esegui il merge del branch delle funzionalit\u00e0 a Il comando Tuttavia, non tutte le migrazioni sono completamente reversibili. Mentre puoi semplicemente eliminare una tabella per annullarne la creazione, una migrazione che cancella i dati \u00e8 un’azione permanente. A volte, \u00c8 bene documentare queste limitazioni. I backup automatici<\/a> di Kinsta forniscono una rete di sicurezza, quindi \u00e8 anche importante creare un backup manuale prima di eseguire una migrazione che potrebbe causare problemi:<\/p>\n Vai sul tuo sito, clicca su Backup<\/strong> e genera un backup con un nome descrittivo. Se una migrazione causa problemi imprevisti nella produzione, puoi ripristinare il backup da questo backup attraverso MyKinsta.<\/p>\n Per i rollback delle migrazioni, ripristina solo il database nell’ambiente di produzione. Il ripristino viene completato in pochi minuti e riporta il database all’esatto stato catturato nel backup.<\/p>\n Le migrazioni Laravel attraverso l’implementazione di Acorn di Radicle<\/a> trasformano ci\u00f2 che spesso \u00e8 fonte di ansia in un processo prevedibile e controllato dalla versione. La combinazione di migrazioni come codice, ambienti di staging di Kinsta e Database Studio per la verifica crea un flusso di lavoro che consente di individuare i problemi di schema prima che raggiungano la produzione.<\/p>\n Pertanto, uno sviluppo moderno di WordPress che include strumenti come Radicle e Acorn permette di non dover scegliere tra l’ecosistema di WordPress e i framework di strumenti professionali. Lo stesso schema si applica alle queue di Laravel<\/a>, al templating di Blade<\/a> e ai comandi WP-CLI personalizzati tramite Acorn.<\/p>\nALTER TABLE<\/code> per aggiungere colonne o ti affidi agli hook di attivazione dei plugin per gestire gli aggiornamenti. Queste soluzioni inizialmente funzionano, ma smettono di essere efficaci quando si gestiscono pi\u00f9 ambienti o si lavora con un team.<\/p>\nCome funzionano le migrazioni di Laravel in WordPress con Acorn<\/h2>\n
up()<\/code> applica le modifiche e down()<\/code> le inverte. Ogni file di migrazione riceve un prefisso temporale che determina l’ordine di esecuzione. Acorn di Roots<\/a> porta questo sistema di migrazione (e molto altro) su WordPress senza richiedere un’installazione completa di Laravel.<\/p>\nmigrations<\/code> nel database di WordPress. Quando si esegue wp acorn migrate<\/code>, Acorn compie alcune operazioni:<\/p>\n\n
$table->string('key')->unique()<\/code> o $table->json('value')->nullable()<\/code>. Questo approccio offre una sintassi indipendente dal database, sicurezza dei tipi e codice pi\u00f9 leggibile rispetto alle istruzioni SQL con stringhe concatenate.<\/p>\nCreare ed eseguire la prima migrazione<\/h3>\n
wp acorn make:migration create_app_settings_table<\/code><\/pre>\ndatabase\/migrations\/<\/code> con il timestamp corrente e il nome specificato:<\/p>\n<?php\nuse IlluminateDatabaseMigrationsMigration;\nuse IlluminateDatabaseSchemaBlueprint;\nuse IlluminateSupportFacadesSchema;\n\nreturn new class extends Migration\n{\n public function up(): void\n {\n Schema::create('app_settings', function (Blueprint $table) {\n $table->id();\n $table->string('key')->unique();\n $table->json('value')->nullable();\n $table->string('group')->default('general');\n $table->boolean('is_public')->default(false);\n $table->text('description')->nullable();\n $table->timestamps();\n $table->index('group');\n $table->index('is_public');\n });\n }\n\n public function down(): void\n {\n Schema::dropIfExists('app_settings');\n }\n};<\/code><\/pre>\nup()<\/code> crea la tabella con le colonne per la memorizzazione delle coppie chiave-valore, le impostazioni di raggruppamento e il monitoraggio delle voci create o modificate. Gli indici su group<\/code> e is_public<\/code> migliorano le prestazioni delle query. Il metodo down()<\/code> rimuove completamente la tabella, consentendo di invertire la migrazione.<\/p>\nwp acorn migrate<\/code>. Questo comando esegue tutte le migrazioni non ancora eseguite, crea tabelle e modifica lo schema del database. Puoi verificare quali migrazioni sono state eseguite con il comando wp acorn migrate:status<\/code>. L’output di stato mostra ogni file di migrazione con gli indicatori di esecuzione.<\/p>\nwp acorn migrate:rollback<\/code>. Questo comando esegue il metodo down() <\/code>per ogni migrazione dell’ultimo lotto per annullare le modifiche.<\/p>\nVerifica delle migrazioni con Database Studio<\/h2>\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/database-studio.png\")
app_settings<\/code>, la query DESCRIBE app_settings;<\/code> permette di controllare le colonne. Questa restituisce la struttura della tabella con i nomi delle colonne, i tipi e gli indici. Un’altra query: SELECT * FROM app_settings;<\/code>, permette di controllare che la tabella accetti gli inserimenti.<\/p>\n![\"Un'istanza](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/database-filters.png\")
Eseguire le migrazioni con SSH e WP-CLI su Kinsta<\/h2>\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/ssh-credentials.png\")
public<\/code>. Esegui quindi wp acorn migrate<\/code>.<\/p>\nTestare le migrazioni negli ambienti di staging di Kinsta<\/h3>\n
![\"La](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/create-environment.png\")
down()<\/code> funzioni correttamente.<\/p>\nwp acorn migrate:rollback<\/code> ti permette di ripristinare l’ultimo lotto di migrazioni e di apportare le correzioni senza influire sulla produzione. Potrai quindi modificare i file di migrazione, eseguire il commit delle modifiche, distribuire nuovamente in staging e ripetere i test.<\/p>\n![\"L'interfaccia](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/selective-push.png\")
Flusso di lavoro di distribuzione con migrazioni automatiche<\/h2>\n
git pull origin main\ncomposer install --no-dev\nnpm install && npm run build\nwp acorn optimize\nwp acorn migrate --force<\/code><\/pre>\n--force<\/code> indica ad Acorn di eseguire le migrazioni senza richieste di conferma, il che \u00e8 essenziale per le distribuzioni automatizzate in cui non puoi interagire con il terminale. L’esecuzione di questo comando dopo wp acorn optimize<\/code> assicura che la cache dell’applicazione sia vuota prima dell’esecuzione delle migrazioni.<\/p>\n.github\/workflows\/deploy.yml<\/code> che puoi modificare per includere una fase di migrazione dopo il processo di compilazione:<\/p>\n- name: Run migrations\n run: |\n ssh user@host -p port 'cd \/path\/to\/site && wp acorn migrate --force'<\/code><\/pre>\ndeploy-hooks\/finalize-after.yml<\/code>:<\/p>\n- name: Run Acorn migrations\n command: wp acorn migrate --force\n args:\n chdir: \"{{ deploy_helper.new_release_path }}\"<\/code><\/pre>\nControllo della versione dei file di migrazione con Git<\/h3>\n
database\/migrations\/<\/code> all’interno della struttura del progetto Radicle. Questa directory fa parte del repo Git<\/a>, il che significa che le migrazioni viaggiano con il tuo codice attraverso il controllo di versione. Il flusso di lavoro rispecchia lo sviluppo standard: crea le migrazioni localmente, esegui il commit in un branch di funzionalit\u00e0 e unisci al branch principale dopo il test.<\/p>\ngit add database\/migrations\/2025_01_03_140000_create_app_settings_table.php\ngit commit -m \"Add app_settings table migration\"\ngit push origin feature-branch<\/code><\/pre>\nmain<\/code>. Questo rende la migrazione disponibile per le distribuzioni di staging e di produzione.<\/p>\nwp acorn migrate:status<\/code> verifica che in tutti gli ambienti siano applicate le stesse migrazioni. Il comando viene eseguito su tutti gli ambienti per verificare che siano sincronizzati. Se un ambiente mostra migrazioni in sospeso, significa che ha bisogno di una distribuzione o di una migrazione manuale per mettersi in pari.<\/p>\nStrategie di rollback e backup del database<\/h2>\n
down()<\/code> spiega perch\u00e9 non \u00e8 possibile effettuare un rollback:<\/p>\npublic function down(): void\n{\n \/\/ This migration cannot be reversed as we're deleting data\n Log::warning(\"Migration cannot be reversed - data permanently deleted\");\n}<\/code><\/pre>\n![](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/manual-backups.png\")
Creare flussi di lavoro affidabili per WordPress<\/h2>\n