# 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](https://full.services/glossario/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](https://full.services/glossario/wp-config/) bem configurado e ferramentas de [hooks](https://full.services/glossario/hooks-wordpress/) 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.

**Também conhecido como:** wordpress cli, linha de comando wordpress

## Termos relacionados

- [wp-config.php](https://full.services/glossario/wp-config/)
- [functions.php](https://full.services/glossario/functions-php/)
- [Backup WordPress](https://full.services/glossario/backup-wordpress/)
- [Hooks WordPress](https://full.services/glossario/hooks-wordpress/)

---

Glossário WordPress da FULL Services: [WP-CLI](https://full.services/glossario/wp-cli/)