WP-CLI: como instalar e automatizar tarefas do WordPress via terminal

Comente! ,

Tempo de leitura: 4 minutos

Atualizar plugin por plugin clicando no painel, exportar banco de dados pelo phpMyAdmin, limpar cache manualmente depois de cada deploy. Tudo isso também dá para fazer com um único comando. O WP-CLI é a ferramenta oficial de linha de comando do WordPress, e quem administra mais de um site sente a diferença já na primeira semana de uso.

Este guia mostra como instalar o WP-CLI numa VPS Linux, os comandos que mais economizam tempo no dia a dia e como automatizar tarefas recorrentes com CRON.

O que é o WP-CLI e por que instalar

O WP-CLI é um projeto oficial do próprio WordPress, mantido pela comunidade com apoio da Automattic. Ele expõe praticamente tudo que o painel administrativo faz. Atualizar núcleo, plugins e temas, gerenciar usuários, exportar e importar banco de dados, limpar cache. Como comandos de terminal. A vantagem aparece em três situações: manutenção em lote (atualizar vários sites de uma vez), automação (rodar tarefas sozinho, sem clicar em nada) e recuperação (quando o painel trava ou fica lento demais para abrir, o terminal continua funcionando).

Como instalar o WP-CLI numa VPS Linux

Com acesso SSH à VPS (veja o guia de acesso à VPS Linux via terminal se ainda não tiver feito isso), o primeiro passo é baixar o executável oficial, disponível como um arquivo .phar no repositório do projeto no GitHub (wp-cli/builds, pasta gh-pages/phar). Baixe esse arquivo para a VPS com o gerenciador de download da sua preferência.

Teste se o arquivo baixou corretamente antes de prosseguir:

php wp-cli.phar --info

Se aparecer a versão do PHP e do WP-CLI sem erro, dê permissão de execução e mova para um lugar acessível de qualquer diretório:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

A partir daqui, o comando wp funciona de qualquer pasta. Confirme com:

wp --info

Importante: os comandos do WP-CLI precisam ser rodados de dentro da pasta de instalação do WordPress (onde está o wp-config.php), ou usando a flag --path=/caminho/do/site para apontar para ela.

Comandos essenciais no dia a dia

Alguns comandos cobrem a maior parte da manutenção de rotina:

  • wp plugin update --all: atualiza todos os plugins de uma vez.
  • wp core update: atualiza o núcleo do WordPress para a versão mais recente.
  • wp db export backup.sql: exporta o banco de dados sem precisar abrir o phpMyAdmin.
  • wp user list: lista todos os usuários cadastrados, útil para auditar acessos.
  • wp cache flush: limpa o cache de objetos, o primeiro passo clássico para descartar uma tela em branco ou um erro 500 no WordPress antes de investigar mais fundo.
  • wp plugin list --status=active: mostra só os plugins ativos, prático para isolar qual deles está causando um problema.

Quem já usa um cache de objetos como o Redis no WordPress sente a diferença de velocidade também nos próprios comandos do WP-CLI, já que boa parte deles passa pelas mesmas rotinas internas do WordPress.

Automatizando tarefas com CRON e WP-CLI

A combinação que realmente economiza tempo é agendar comandos do WP-CLI no CRON da VPS. Um exemplo comum é atualizar plugins toda madrugada e registrar o resultado num log:

0 3 * * * /usr/local/bin/wp --path=/caminho/do/site plugin update --all

A flag --path evita a necessidade de trocar de pasta antes do comando, o que deixa a linha do CRON mais simples de revisar depois. Vale registrar a saída num arquivo de log próprio para acompanhar se a atualização automática está rodando sem erro.

Outro uso frequente é limpar cache automaticamente depois de um deploy, ou exportar backup do banco antes de qualquer atualização automática rodar. Assim, se algo der errado, existe um ponto de restauração recente.

Cuidados antes de rodar comandos em produção

Automatizar é ótimo, mas alguns cuidados evitam dor de cabeça:

  • Rode o WP-CLI com o mesmo usuário que é dono dos arquivos do WordPress, não como root. Evita problemas de permissão depois.
  • Teste comandos novos manualmente antes de colocar no CRON, principalmente os que alteram banco de dados.
  • Sempre exporte um backup do banco antes de uma atualização automática de plugins ou núcleo. Reverter um comando é bem mais rápido do que reconstruir um site quebrado.
  • Se a VPS também usa chave SSH em vez de senha, o mesmo usuário e a mesma chave servem para rodar os comandos agendados sem precisar guardar senha em lugar nenhum.

O projeto documenta todos os comandos disponíveis na referência oficial de comandos do WP-CLI, então vale consultar sempre que precisar de um comando mais específico do que os listados aqui.

Num servidor com acesso root de verdade. Como uma VPS Linux. O WP-CLI vira parte natural da rotina de manutenção, junto com outras ferramentas de automação como o CRON.

Artigos relacionados