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