Ao combinar isso com a infraestrutura e as ferramentas da Kinsta, voc\u00ea obt\u00e9m uma forma de automatizar a execu\u00e7\u00e3o de migra\u00e7\u00f5es durante as implanta\u00e7\u00f5es.<\/p>\n
Por que as altera\u00e7\u00f5es no banco de dados do WordPress precisam de controle de vers\u00e3o<\/h2>\n
As modifica\u00e7\u00f5es manuais no banco de dados tratam mudan\u00e7as de esquema como opera\u00e7\u00f5es isoladas, e n\u00e3o como c\u00f3digo versionado. Por exemplo, executar uma query SQL<\/a> para criar uma tabela personalizada, usar um comando Os ambientes de teste geralmente come\u00e7am a divergir dos ambientes locais quando voc\u00ea se esquece de documentar altera\u00e7\u00f5es menores (como adicionar uma coluna ao banco de dados local), o que tamb\u00e9m causa falhas nas implanta\u00e7\u00f5es de produ\u00e7\u00e3o. Isso tamb\u00e9m significa que n\u00e3o h\u00e1 um registro de auditoria.<\/p>\n As migra\u00e7\u00f5es do Laravel<\/a> resolvem esses problemas ao tratar mudan\u00e7as no banco de dados como c\u00f3digo versionado que vive no seu reposit\u00f3rio Git. Esse c\u00f3digo \u00e9 implantado junto com a aplica\u00e7\u00e3o e executado na mesma ordem em todos os ambientes.<\/p>\n As migra\u00e7\u00f5es do Laravel s\u00e3o arquivos PHP que definem altera\u00e7\u00f5es no esquema do banco de dados por meio de dois m\u00e9todos: O sistema de migra\u00e7\u00e3o rastreia quais altera\u00e7\u00f5es foram executadas usando uma tabela Esse rastreamento impede que migra\u00e7\u00f5es sejam executadas mais de uma vez e mostra exatamente quais altera\u00e7\u00f5es de esquema foram aplicadas em cada ambiente.<\/p>\n O Acorn integra o construtor de esquemas do Laravel, que oferece uma sintaxe PHP fluida e expressiva para criar e modificar tabelas do banco de dados. Em vez de escrever SQL bruto, voc\u00ea utiliza m\u00e9todos como Voc\u00ea cria migra\u00e7\u00f5es usando o WP-CLI<\/a>:<\/p>\n Isso gera um novo arquivo de migra\u00e7\u00e3o no diret\u00f3rio O m\u00e9todo Voc\u00ea executa migra\u00e7\u00f5es pendentes com o comando Quando voc\u00ea precisa reverter o \u00faltimo lote de migra\u00e7\u00f5es, utilize o comando Depois de executar as migra\u00e7\u00f5es, o Database Studio da Kinsta<\/a> (ou qualquer outra ferramenta de banco de dados) permite verificar se as tabelas e colunas esperadas existem com a estrutura correta. Voc\u00ea acessa o Database Studio por meio do painel MyKinsta, navegando para qualquer site e clicando na aba Banco de dados<\/strong>:<\/p>\n O Console SQL inclu\u00eddo permite executar queries de verifica\u00e7\u00e3o para confirmar que suas migra\u00e7\u00f5es criaram a estrutura esperada.<\/p>\n Ap\u00f3s criar a tabela Os filtros permitem examinar registros ou colunas espec\u00edficas sem escrever queries SQL. Aqui, voc\u00ea pode clicar nos cabe\u00e7alhos das colunas para ordenar, aplicar filtros para restringir os resultados e exportar seus dados:<\/p>\n Essas op\u00e7\u00f5es de exporta\u00e7\u00e3o s\u00e3o \u00fateis antes de voc\u00ea testar os procedimentos de revers\u00e3o.<\/p>\n A Kinsta inclui acesso SSH<\/a> e WP-CLI em todos os planos. Isso significa que voc\u00ea pode executar comandos de migra\u00e7\u00e3o diretamente em seus ambientes de teste e produ\u00e7\u00e3o sem nenhuma configura\u00e7\u00e3o adicional.<\/p>\n Para executar migra\u00e7\u00f5es em um ambiente Kinsta, primeiro voc\u00ea deve se conectar a ele usando SSH<\/a>. As credenciais est\u00e3o na tela de informa\u00e7\u00f5es<\/strong> de qualquer site no MyKinsta:<\/p>\n Ap\u00f3s conectar-se e autenticar-se, navegue at\u00e9 o diret\u00f3rio raiz do site. Para sites Radicle, esse diret\u00f3rio \u00e9 o O processo de migra\u00e7\u00e3o exibe uma sa\u00edda que mostra quais migra\u00e7\u00f5es est\u00e3o em execu\u00e7\u00e3o e o status de conclus\u00e3o de cada uma. Isso tamb\u00e9m funciona em ambientes de teste e produ\u00e7\u00e3o<\/a> porque o Acorn rastreia as migra\u00e7\u00f5es de forma independente no banco de dados de cada ambiente.<\/p>\n Os ambientes de teste da Kinsta<\/a> s\u00e3o um espa\u00e7o seguro para testar as migra\u00e7\u00f5es antes de implant\u00e1-las na produ\u00e7\u00e3o, mas voc\u00ea precisa de um fluxo de trabalho confi\u00e1vel para test\u00e1-las. Depois que voc\u00ea tiver verificado as altera\u00e7\u00f5es de migra\u00e7\u00e3o no Database Studio, procure testar a revers\u00e3o para garantir que o m\u00e9todo Para fazer isso, mude para o ambiente de teste no MyKinsta, navegue at\u00e9 a aba Banco de dados<\/strong>\u00a0e inspecione as tabelas que as migra\u00e7\u00f5es criaram ou modificaram.<\/p>\n Se voc\u00ea encontrar problemas durante os testes no ambiente de teste, o comando O recurso de Mover seletivamente da Kinsta permite implantar apenas as altera\u00e7\u00f5es que voc\u00ea testou, escolhendo enviar apenas os arquivos para produ\u00e7\u00e3o ou enviar arquivos e banco de dados:<\/p>\n Para fluxos de trabalho com migra\u00e7\u00f5es, normalmente voc\u00ea envia apenas os arquivos, pois as migra\u00e7\u00f5es s\u00e3o executadas no banco de dados existente em produ\u00e7\u00e3o, em vez de sobrescrev\u00ea-lo com dados do ambiente de teste.<\/p>\n Fluxos de trabalho com migra\u00e7\u00f5es automatizadas executam altera\u00e7\u00f5es no esquema do banco de dados durante a implanta\u00e7\u00e3o do c\u00f3digo, eliminando etapas manuais e reduzindo erros. Isso \u00e9 feito adicionando comandos de migra\u00e7\u00e3o ao processo de implanta\u00e7\u00e3o, seja por scripts manuais via SSH, automa\u00e7\u00e3o com GitHub Actions<\/a> ou ferramentas como o Trellis<\/a> da Roots.<\/p>\n Para implanta\u00e7\u00f5es manuais usando SSH, conecte-se ao ambiente de produ\u00e7\u00e3o e navegue at\u00e9 o diret\u00f3rio raiz do site. Em seguida, execute os seguintes comandos em sequ\u00eancia:<\/p>\n A flag Se voc\u00ea utiliza GitHub Actions para implanta\u00e7\u00e3o cont\u00ednua, pode automatizar as migra\u00e7\u00f5es no arquivo de workflow. O Radicle inclui uma configura\u00e7\u00e3o O fluxo de implanta\u00e7\u00e3o conecta via SSH, navega at\u00e9 o diret\u00f3rio do site e executa o comando de migra\u00e7\u00e3o.<\/p>\n Para implanta\u00e7\u00f5es usando o Trellis, as migra\u00e7\u00f5es s\u00e3o integradas aos hooks de implanta\u00e7\u00e3o. Voc\u00ea inclui o seguinte modificando o arquivo Isso executa as migra\u00e7\u00f5es depois que o Trellis conclui outras tarefas de implanta\u00e7\u00e3o. As migra\u00e7\u00f5es s\u00e3o executadas no diret\u00f3rio da nova vers\u00e3o, e o Trellis lida com a revers\u00e3o se a implanta\u00e7\u00e3o falhar.<\/p>\n Os arquivos de migra\u00e7\u00e3o ficam no diret\u00f3rio O fluxo de trabalho de commit para migra\u00e7\u00f5es segue um padr\u00e3o consistente:<\/p>\n Ap\u00f3s revisar a migra\u00e7\u00e3o, voc\u00ea mescla a branch de funcionalidade na branch principal. Isso torna a migra\u00e7\u00e3o dispon\u00edvel para implanta\u00e7\u00f5es em ambientes de teste e produ\u00e7\u00e3o.<\/p>\n O comando Nem todas as migra\u00e7\u00f5es s\u00e3o totalmente revers\u00edveis. Embora seja simples remover uma tabela para desfazer sua cria\u00e7\u00e3o, uma migra\u00e7\u00e3o que exclui dados \u00e9 uma a\u00e7\u00e3o permanente. Em alguns casos, o m\u00e9todo \u00c9 bom que voc\u00ea documente essas limita\u00e7\u00f5es. Os backups automatizados<\/a> da Kinsta fornecem uma rede de seguran\u00e7a, portanto, tamb\u00e9m \u00e9 importante que voc\u00ea crie um backup manual antes de executar uma migra\u00e7\u00e3o que possa causar problemas:<\/p>\n Navegue at\u00e9 seu site, clique em Backups<\/strong> e gere um backup com um nome descritivo. Se uma migra\u00e7\u00e3o causar problemas inesperados na produ\u00e7\u00e3o, voc\u00ea poder\u00e1 restaurar a partir desse backup por meio do MyKinsta.<\/p>\n Para revers\u00f5es de migra\u00e7\u00e3o, voc\u00ea restaura apenas o banco de dados para o ambiente de produ\u00e7\u00e3o. A restaura\u00e7\u00e3o \u00e9 conclu\u00edda em minutos e retorna o banco de dados ao estado exato capturado no backup.<\/p>\n As migra\u00e7\u00f5es do Laravel, por meio da implementa\u00e7\u00e3o do Acorn<\/a> no Radicle<\/a>, transformam um dos pontos mais cr\u00edticos do desenvolvimento em um processo previs\u00edvel e controlado por vers\u00e3o. A combina\u00e7\u00e3o de migra\u00e7\u00f5es como c\u00f3digo, ambientes de teste da Kinsta e o Database Studio para verifica\u00e7\u00e3o cria um fluxo de trabalho que permite identificar problemas de esquema antes que cheguem \u00e0 produ\u00e7\u00e3o.<\/p>\n Com isso, o desenvolvimento moderno em WordPress, utilizando ferramentas como Radicle e Acorn, elimina a necessidade de escolher entre o ecossistema do WordPress e frameworks profissionais. O mesmo padr\u00e3o se aplica a filas do Laravel<\/a>, templates Blade<\/a> e comandos personalizados do WP-CLI por meio do Acorn.<\/p>\nALTER TABLE<\/code> para adicionar colunas ou depender de hooks de ativa\u00e7\u00e3o de plugins para aplicar atualiza\u00e7\u00f5es. Essas abordagens funcionam inicialmente, mas falham quando voc\u00ea gerencia v\u00e1rios ambientes ou trabalha em equipe.<\/p>\nComo funcionam as migra\u00e7\u00f5es do Laravel no WordPress com o Acorn<\/h2>\n
up()<\/code> aplica as altera\u00e7\u00f5es e down()<\/code> as reverte. Cada arquivo de migra\u00e7\u00e3o recebe um prefixo de registro de data e hora que determina a ordem de execu\u00e7\u00e3o. O Acorn, da Roots<\/a>, traz esse sistema de migra\u00e7\u00f5es e outros recursos para o WordPress sem exigir uma instala\u00e7\u00e3o completa do Laravel.<\/p>\nmigrations<\/code> em seu banco de dados do WordPress. Quando voc\u00ea executa wp acorn migrate<\/code>, o Acorn realiza algumas tarefas:<\/p>\n\n
$table->string('key')->unique()<\/code> ou $table->json('value')->nullable()<\/code>. Essa abordagem fornece sintaxe independente de banco de dados, seguran\u00e7a de tipos e c\u00f3digo mais leg\u00edvel do que instru\u00e7\u00f5es SQL com strings concatenadas manualmente.<\/p>\nCriando e executando sua primeira migra\u00e7\u00e3o<\/h3>\n
wp acorn make:migration create_app_settings_table<\/code><\/pre>\ndatabase\/migrations\/<\/code> com o registro de data e hora atual e o nome que voc\u00ea especificou:<\/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> cria a tabela com colunas para armazenar pares chave-valor, agrupar configura\u00e7\u00f5es e registrar quando os registros foram criados ou modificados. Os \u00edndices em group<\/code> e is_public<\/code> melhoram o desempenho das consultas. O m\u00e9todo down()<\/code> remove completamente a tabela, permitindo reverter a migra\u00e7\u00e3o.<\/p>\nwp acorn migrate<\/code>. Ele executa todas as migra\u00e7\u00f5es que ainda n\u00e3o foram aplicadas, cria tabelas e modifica o esquema do banco de dados. Para verificar quais migra\u00e7\u00f5es j\u00e1 foram executadas, use wp acorn migrate:status<\/code>. A sa\u00edda mostra cada arquivo de migra\u00e7\u00e3o e indica se ele j\u00e1 foi executado.<\/p>\nwp acorn migrate:rollback<\/code>. Ele executa o m\u00e9todo down()<\/code> de cada migra\u00e7\u00e3o do \u00faltimo lote, desfazendo as altera\u00e7\u00f5es.<\/p>\nVerificando migra\u00e7\u00f5es com o Database Studio da Kinsta<\/h2>\n
![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/database-studio.png\")
app_settings<\/code>, a query DESCRIBE app_settings;<\/code> permite verificar as colunas. Isso retorna a estrutura da tabela, mostrando nomes das colunas, tipos e \u00edndices. Outra query, SELECT * FROM app_settings;<\/code>, permite testar se a tabela aceita inser\u00e7\u00f5es.<\/p>\n![\"Uma](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/database-filters.png\")
Executando migra\u00e7\u00f5es com SSH e WP-CLI na Kinsta<\/h2>\n
![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/ssh-credentials.png\")
public<\/code>. Em seguida, execute wp acorn migrate<\/code>.<\/p>\nTestando migra\u00e7\u00f5es em ambientes de teste da Kinsta<\/h3>\n
![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/create-environment.png\")
down()<\/code> funcione corretamente.<\/p>\nwp acorn migrate:rollback<\/code> permite reverter o \u00faltimo lote de migra\u00e7\u00f5es e fazer corre\u00e7\u00f5es sem afetar a produ\u00e7\u00e3o. Em seguida, voc\u00ea pode modificar seus arquivos de migra\u00e7\u00e3o, fazer commit das altera\u00e7\u00f5es, implantar novamente no ambiente de teste e testar novamente.<\/p>\n![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/selective-push.png\")
Fluxo de trabalho de implanta\u00e7\u00e3o com migra\u00e7\u00f5es automatizadas<\/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> instrui o Acorn a executar as migra\u00e7\u00f5es sem prompts de confirma\u00e7\u00e3o, o que \u00e9 essencial para implanta\u00e7\u00f5es automatizadas onde n\u00e3o h\u00e1 intera\u00e7\u00e3o humana com o terminal. Executar esse comando ap\u00f3s wp acorn optimize<\/code> garante que o cache da aplica\u00e7\u00e3o esteja atualizado antes da execu\u00e7\u00e3o das migra\u00e7\u00f5es.<\/p>\n.github\/workflows\/deploy.yml<\/code> que pode ser modificada para incluir uma etapa de migra\u00e7\u00e3o ap\u00f3s o processo de build:<\/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>\nControle de vers\u00e3o de arquivos de migra\u00e7\u00e3o com o Git<\/h3>\n
database\/migrations\/<\/code> dentro da estrutura do projeto Radicle. Esse diret\u00f3rio faz parte do reposit\u00f3rio Git<\/a>, o que significa que as migra\u00e7\u00f5es acompanham o c\u00f3digo pelo controle de vers\u00e3o. O fluxo de trabalho segue o padr\u00e3o de desenvolvimento: criar migra\u00e7\u00f5es localmente, fazer commit em uma branch de funcionalidade e mesclar na branch principal ap\u00f3s os testes.<\/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>\nwp acorn migrate:status<\/code> verifica se todos os ambientes t\u00eam as mesmas migra\u00e7\u00f5es aplicadas. Voc\u00ea pode executar esse comando em todos os ambientes para confirmar que est\u00e3o sincronizados. Se algum ambiente mostrar migra\u00e7\u00f5es pendentes, isso indica que ele precisa de uma implanta\u00e7\u00e3o ou de uma execu\u00e7\u00e3o manual de migra\u00e7\u00e3o para se atualizar.<\/p>\nEstrat\u00e9gias de revers\u00e3o e backups do banco de dados<\/h2>\n
down()<\/code> pode indicar que uma revers\u00e3o n\u00e3o \u00e9 poss\u00edvel:<\/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![\"A](\"https:\/\/kinsta.com\/wp-content\/uploads\/2026\/01\/manual-backups.png\")
Criando fluxos de trabalho de banco de dados confi\u00e1veis para o WordPress<\/h2>\n