WP-CLI

WP-CLI WordPress é a interface de linha de comando oficial do WordPress, mantida pelo time do core, que permite executar via terminal praticamente tudo que você faz no painel admin: instalar plugins, criar usuários, atualizar opções, importar conteúdo, rodar buscas no banco, exportar dados. Para administradores de sistemas, devops e desenvolvedores, é ferramenta indispensável: o que leva minutos no painel costuma levar segundos via comando, e fluxos repetitivos viram scripts automatizáveis.

O que é o WP-CLI

É um executável escrito em PHP que carrega o WordPress como biblioteca e expõe centenas de comandos sob a estrutura wp [comando] [subcomando]. Você roda no diretório raiz do WordPress (ou aponta para ele com –path), e o WP-CLI usa o wp-config.php local para conectar ao banco e operar no site real.

Quem busca o que é wp-cli costuma ser desenvolvedor migrando de outro CMS, sysadmin gerenciando vários sites WordPress em VPS, ou usuário avançado tentando resolver algo que o painel não consegue. As três personas se beneficiam diretamente: WP-CLI elimina cliques repetitivos e torna automação possível.

O WP-CLI é desenvolvido em PHP por Daniel Bachhuber e mantido oficialmente pelo time do WordPress. Roda em qualquer ambiente onde PHP existe: servidores Linux, macOS e Windows com WSL ou Docker. A versão atual está estabilizada e cobre praticamente todas as áreas administrativas do WordPress.

Tecnicamente, é a alternativa moderna ao XML-RPC e à REST API para automação local. Diferente da REST API, que precisa autenticação HTTP e roda no contexto de uma requisição web, o WP-CLI roda direto no servidor com acesso completo. É a ferramenta certa para tarefas administrativas pesadas que precisam de privilégio elevado.

Como instalar WP-CLI

Em hospedagens gerenciadas (Kinsta, WP Engine, Pressable), o WP-CLI já vem instalado. Você acessa o servidor via SSH, navega até o site e os comandos funcionam. Hospedagens cPanel modernas (Hostinger, KingHost, SiteGround) também oferecem WP-CLI via SSH ou via terminal embutido no painel.

Em VPS próprio, a instalação é direta: baixe o phar (executável PHP) do site oficial, dê permissão de execução e mova para um diretório no PATH. Em duas linhas no terminal: curl para baixar o arquivo, mv para colocar em /usr/local/bin/wp. Daí em diante, o comando wp funciona globalmente para qualquer instalação WordPress no servidor.

Em Windows, a forma mais limpa é via WSL (Windows Subsystem for Linux) ou via Docker. Há binário oficial para Windows, mas a experiência é melhor em ambiente Unix-like. Para Mac, brew install wp-cli resolve em um comando.

Confirme a instalação com wp –info. O comando retorna versão do WP-CLI, versão do PHP, sistema operacional e algumas configurações. Se aparecer algum erro de carregamento do WordPress, use –path apontando para o diretório raiz do site, ou rode dentro do diretório correto.

Comandos essenciais

Para gerenciar plugins, os comandos mais usados são wp plugin list (lista todos), wp plugin install nome (instala do repositório), wp plugin activate nome (ativa), wp plugin update –all (atualiza todos), wp plugin delete nome (remove). Em sites com 30 plugins, atualizar todos via wp-cli é instantâneo, contra cliques manuais um a um no painel.

Para usuários, wp user create login email –role=editor cria conta nova com role específica, wp user list mostra todos, wp user update id –user_pass=novasenha reseta senha. Em incidentes onde admin foi comprometido, é o caminho rápido para criar conta limpa e revogar a comprometida.

Para banco de dados, wp db export gera dump SQL, wp db import carrega de arquivo SQL, wp db search-replace antiga.com nova.com troca todas as ocorrências (essencial em migrações), wp db optimize roda OTIMIZE TABLE em todas as tabelas. Combine com backup WordPress regular para fechar o ciclo de manutenção.

Para conteúdo, wp post create cria post programaticamente, wp post list lista, wp post delete remove. Útil para importação em massa, geração programática e limpeza de spam. wp media regenerate força regeneração de thumbnails após mudança de tema. wp transient delete –all limpa todos os transients de uma vez.

Casos de uso avançados

Migração de banco entre ambientes é um dos usos mais valiosos. Você exporta o banco de produção via wp db export, importa em staging via wp db import, e ajusta URLs com wp search-replace. O fluxo inteiro vira script de 5 linhas, contra meia hora de cliques no phpMyAdmin manual. Para times com vários ambientes, comandos wp-cli viram base do pipeline.

Manutenção em massa de sites é outro caso. Agências cuidando de 20 ou 30 sites usam wp-cli em scripts shell que iteram pela lista, atualizando plugin específico em todos, fazendo backup, rodando search-replace ou aplicando hardening. O que levaria dias manualmente fica em minutos com loop automatizado.

Resposta a incidentes ganha velocidade com wp-cli. Quando admin é comprometido e o painel está bloqueado, você acessa via SSH, lista usuários, deleta o malicioso, cria conta nova, reseta senhas, desativa plugin suspeito. Tudo via comandos. Em poucos minutos, o site volta ao controle.

Para devs, comandos wp-cli são parte do fluxo de testes. wp eval-file executa script PHP arbitrário no contexto do WordPress, útil para diagnosticar problemas que não aparecem no painel. wp shell abre REPL interativo para testar funções e queries. Combinado com wp-config.php bem configurado e ferramentas de hooks bem usadas, é o ferramental completo de profissional.

Para times que rodam vários sites WordPress e querem operação automatizada e padronizada, a FULL Services entrega a stack profissional já preparada para wp-cli na hospedagem parceira, com scripts pré-configurados de manutenção, backup e atualização. Em vez de configurar terminal, instalar plugin a plugin e debugar permissões SSH, você opera em uma camada onde wp-cli já é parte do fluxo padrão.