{"id":74614,"date":"2026-02-25T07:02:52","date_gmt":"2026-02-25T10:02:52","guid":{"rendered":"https:\/\/kinsta.com\/pt\/?p=74614&preview=true&preview_id=74614"},"modified":"2026-03-02T11:16:48","modified_gmt":"2026-03-02T14:16:48","slug":"comandos-wp-cli-personalizados-acorn","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/comandos-wp-cli-personalizados-acorn\/","title":{"rendered":"Como criar comandos WP-CLI personalizados e automatizar a manuten\u00e7\u00e3o do WordPress com o Acorn"},"content":{"rendered":"

Voc\u00ea provavelmente tem scripts em PHP que executam diversas tarefas, como limpar metadados \u00f3rf\u00e3os de artigos ou excluir transients expirados. Com o tempo, essa cole\u00e7\u00e3o cresce e passa a viver em um arquivo de tema, em uma pasta de plugin ou em algum diret\u00f3rio pouco acess\u00edvel. O Acorn ajuda a organizar essa desordem ao trazer o Artisan Console do Laravel para o WordPress.<\/p>\n

Isso significa que voc\u00ea pode criar comandos WP-CLI personalizados com arquivos de classe estruturados que centralizam sua l\u00f3gica de manuten\u00e7\u00e3o. Esses comandos s\u00e3o executados de forma consistente em desenvolvimento, teste e produ\u00e7\u00e3o, usando indicadores de progresso, sa\u00edda em tabela formatada, tratamento adequado de erros e muito mais. Em seguida, voc\u00ea pode acion\u00e1-los via SSH, agend\u00e1-los com cron jobs ou execut\u00e1-los durante implanta\u00e7\u00f5es.<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Como instalar o Acorn e executar comandos<\/h2>\n

O primeiro passo \u00e9 instalar as depend\u00eancias necess\u00e1rias. O Acorn precisa do PHP 8.2<\/a> ou superior, do Composer<\/a> para gerenciar depend\u00eancias e do WP-CLI<\/a> em execu\u00e7\u00e3o no seu servidor. A Kinsta inclui o WP-CLI em todos os planos de hospedagem, para que voc\u00ea possa come\u00e7ar a criar comandos imediatamente.<\/p>\n

Voc\u00ea instala o Acorn via Composer usando composer require roots\/acorn<\/code> na raiz do projeto. Em seguida, adicione o c\u00f3digo de inicializa\u00e7\u00e3o ao arquivo functions.php do seu tema ou ao arquivo principal do seu plugin:<\/p>\n

<?php\nuse Roots\\Acorn\\Application;\nif (! class_exists(\\Roots\\Acorn\\Application::class)) {\n    wp_die(\n        __('You need to install Acorn to use this site.', 'domain'),\n        '',\n        [\n            'link_url' => 'https:\/\/roots.io\/acorn\/docs\/installation\/',\n            'link_text' => __('Acorn Docs: Installation', 'domain'),\n        ]\n    );\n}\n\nadd_action('after_setup_theme', function () {\n    Application::configure()\n        ->withProviders([\n            App\\Providers\\ThemeServiceProvider::class,\n        ])\n        ->boot();\n}, 0);\n<\/code><\/pre>\n
A configura\u00e7\u00e3o sem necessidade de ajustes armazena o cache do aplicativo e os registros no diret\u00f3rio de cache do WordPress<\/a> em [wp-content]\/cache\/acorn\/<\/code>, com seus comandos no diret\u00f3rio app\/<\/code> do tema.<\/p>\n
A estrutura tradicional segue as conven\u00e7\u00f5es do Laravel, como diret\u00f3rios dedicados para app\/<\/code>, config\/<\/code>, storage\/<\/code> e resources\/<\/code> na raiz do seu projeto. Voc\u00ea configura isso com uma linha:<\/p>\n
wp acorn acorn:init storage && wp acorn vendor:publish --tag=acorn\n<\/code><\/pre>\n
Se voc\u00ea executar wp acorn list<\/code>, isso verificar\u00e1 sua instala\u00e7\u00e3o, exibindo todos os comandos Acorn dispon\u00edveis. A partir desse ponto, todos os comandos personalizados que voc\u00ea criar ser\u00e3o armazenados no diret\u00f3rio app\/Console\/Commands\/<\/code>. O Acorn descobre automaticamente todas as classes de comando nesse local e as registra no WP-CLI.<\/p>\n