WP-CLI: Gerencie o WordPress Inteiro pelo Terminal (Gratis)

WP-CLI é uma ferramenta gratuita e de código aberto que permite administrar sites WordPress inteiramente pelo terminal de linha de comando, sem necessidade de acessar o painel wp-admin. Funciona em PHP 7.4+ e é compatível com Linux, macOS, Windows (WSL ou nativo) e containers Docker, oferecendo mais de 60 comandos nativos para tarefas como instalação do core, atualização de plugins, gerenciamento de usuários em massa, backup de banco de dados e busca-e-substituição segura. A ferramenta padrão entre desenvolvedores WordPress profissionais desde 2011, vem pré-instalada em hospedagens como Hostinger, WP Engine, Kinsta e SiteGround. WP-CLI resolve a limitação central do painel wp-admin: enquanto este é adequado para tarefas pontuais, torna-se ineficiente para operações em massa e automação. Permite executar operações complexas como atualização de plugins, migração de domínios, importação de usuários e auditoria de banco de dados através de comandos simples no terminal, aumentando significativamente a produtividade de profissionais WordPress.

Atualizado em 17/06/2026

Resposta rápida: WP-CLI é uma ferramenta gratuita e de código aberto (licença MIT) que permite administrar qualquer site WordPress inteiramente pelo terminal de linha de comando, sem precisar abrir o painel wp-admin. Executa em PHP 7.4+ e roda em Linux, macOS, Windows (WSL ou nativo) e dentro de containers Docker, oferecendo mais de 60 comandos nativos (instalar core, atualizar plugins, popular usuários em massa, fazer backup de banco, busca-e-substituição segura) e milhares de comandos via packages e plugins. É a ferramenta padrão de devs WordPress profissionais desde 2011 e está pré-instalada em hospedagens como Hostinger, WP Engine, Kinsta e SiteGround.

O WP-CLI resolve um problema central na operação WordPress: o painel wp-admin é confortável para tarefas pontuais, mas torna-se gargalo absurdo para operações em massa, automação ou diagnóstico avançado. Atualizar 30 plugins clicando um a um leva 20 minutos; com wp plugin update --all leva 30 segundos. Trocar URL de domínio em todo o banco (depois de migração) via SQL manual arrisca quebrar dados serializados; com wp search-replace é três segundos sem corromper. Importar 5.000 usuários de CSV via painel é inviável; com wp user import-csv é instantâneo. Auditar opções, transients, meta-keys, lixo na tabela wp_options, slots de cache vazios, links quebrados — tudo isso no painel pede plugin separado; no WP-CLI são one-liners. Não é exagero dizer que dominar WP-CLI multiplica por 10 a produtividade de qualquer profissional que trabalhe com mais de 3 sites WordPress.

O que o WP-CLI faz na prática

Você abre o terminal, entra na pasta do WordPress (cd /var/www/site) e digita wp core version — em uma fração de segundo aparece “6.6.2” ou a versão instalada. Esse é o exemplo mais simples; a partir dele as combinações se multiplicam. Para listar todos os usuários administradores: wp user list --role=administrator. Para resetar a senha de um usuário sem precisar acessar o painel: wp user update admin --user_pass=NovaSenhaForte!. Para procurar e substituir um domínio antigo pelo novo em todo o banco (incluindo arrays PHP serializados): wp search-replace 'oldsite.com' 'newsite.com' — vai cuidar de meta-keys, transients, options, postmeta e ajustar o tamanho dos arrays. Para gerar 50 posts de teste com texto lorem ipsum: wp post generate --count=50 --post_type=post. Para exportar o banco completo em um único arquivo gzipado pronto para enviar: wp db export - --add-drop-table | gzip > backup.sql.gz.

A força do WP-CLI multiplica ao combinar com loops de shell. Atualizar todos os 47 sites WordPress de um diretório em paralelo: for d in /var/www/*/; do (cd "$d" && wp core update && wp plugin update --all && wp theme update --all); done. Limpar todos os transients expirados de uma vez: wp transient delete --all. Habilitar manutenção temporária antes de operação delicada: wp maintenance-mode activate seguido de tarefas e wp maintenance-mode deactivate. Migrar conteúdo entre sites: exportar com wp export, importar no destino com wp import. O escopo de automação é virtualmente ilimitado para quem dedicou uma tarde a explorar os comandos.

Como instalar WP-CLI em cada sistema

No Linux ou macOS, o caminho recomendado é baixar a Phar (PHP Archive) oficial e torná-la executável global. Comandos no terminal: curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar, depois chmod +x wp-cli.phar, depois sudo mv wp-cli.phar /usr/local/bin/wp. Verifique com wp --info — deve mostrar versão e diretório base. Distribuições com gerenciador de pacotes podem ter pacote: Homebrew (brew install wp-cli), Snap (sudo snap install wp-cli --classic), AUR no Arch (yay -S wp-cli).

No Windows nativo sem WSL, baixe a phar manualmente, crie um wp.bat que invoca php "C:wp-cliwp-cli.phar" %*, e adicione a pasta ao PATH. Mas a melhor experiência no Windows é via WSL2 Ubuntu: instale WSL, dentro do Ubuntu siga o caminho Linux acima, e use o terminal Ubuntu para todas as operações. Hospedagens compartilhadas como Hostinger já vêm com o wp instalado no SSH — basta conectar via SSH e ele já responde. WP Engine, Kinsta, SiteGround, GoDaddy Managed e Cloudways oferecem WP-CLI pré-instalado no console SSH ou web shell. Para Docker, há imagem oficial wordpress:cli que você executa como sidecar do container WordPress.

Casos de uso reais que economizam horas

Migração de site: empacote o site origem com wp db export + tar do wp-content, suba no destino, descompacte, importe o SQL, e ajuste URLs com wp search-replace antigo.com novo.com --skip-columns=guid. Em 5 minutos, site idêntico no novo servidor — sem plugin de migração que cobra mensalidade. Limpeza de spam acumulado em wp_comments: wp comment delete $(wp comment list --status=spam --format=ids) --force apaga 30.000 spams em segundos; tentar pelo painel quebra timeout. Auditoria de plugins inativos: wp plugin list --status=inactive mostra a lista; combinado com --field=name | xargs wp plugin delete remove em bloco. Gerar checksums e verificar integridade: wp core verify-checksums compara cada arquivo PHP do core com o oficial WordPress.org e relata divergências — primeira coisa a rodar quando suspeita de invasão. Mudar prefixo de tabelas: wp config set table_prefix wp_seguro_ seguido de renomear tabelas no banco — útil para endurecimento de segurança.

Cron real em vez do wp-cron padrão (que executa só quando há tráfego, atrasando agendamentos): wp cron event list mostra agendamentos; desabilite o wp-cron HTTP com wp config set DISABLE_WP_CRON true e configure cron de sistema chamando wp cron event run --due-now a cada 5 minutos. Resultado: agendamentos pontuais, sem o atraso típico do wp-cron tradicional. Para sites com cron crítico (e-commerce, newsletter, backup), isso é diferença entre amador e profissional.

Comparativo: WP-CLI vs. Adminer vs. phpMyAdmin vs. Plugins UI

A leitura honesta: WP-CLI ganha quando o trabalho é repetitivo, em larga escala, sob pressão de tempo, ou quando o wp-admin está fora do ar (hack, atualização malsucedida, plugin quebrando o site). Adminer e phpMyAdmin continuam relevantes para inspeção SQL ad-hoc, mas são perigosos para edição direta de campos serializados (vai corromper). Plugins UI servem para usuários sem terminal; programador profissional WordPress sem WP-CLI em 2026 está deixando dinheiro na mesa.

Packages e extensões da comunidade

O WP-CLI tem sistema de packages — você instala extensões via wp package install. Os mais úteis: wp-cli/profile-command (analisa performance de páginas e queries: wp profile stage); aaemnnosttv/wp-cli-dotenv-command (carrega variáveis de .env em wp-config.php); wp-cli/admin-command (abre wp-admin no browser direto do terminal); nlemoine/wp-cli-clean-command (limpa lixo de banco). Plugins WordPress instalados também podem expor comandos via WP_CLI::add_command — WooCommerce, Yoast, RankMath, AIOSEO, Elementor, Polylang, MultilingualPress, Stream e WP Migrate todos têm comandos próprios. Por exemplo, wp wc tool run regenerate_thumbnails_for_all_products (WooCommerce) ou wp yoast index (Yoast) automatizam o que o painel demoraria horas.

Boas práticas e segurança

Antes de qualquer operação destrutiva (search-replace, db reset, plugin delete, bulk delete de posts), SEMPRE faça backup do banco: wp db export backup-$(date +%Y%m%d-%H%M%S).sql guarda um SQL nomeado por timestamp. Use --dry-run quando disponível para ver o que vai ser feito sem executar — wp search-replace antigo.com novo.com --dry-run mostra quantas linhas seriam alteradas. Use --skip-themes e --skip-plugins para diagnosticar quando algum plugin está atrapalhando — wp eval "echo home_url();" --skip-themes --skip-plugins retorna a URL pura, sem hooks interferindo. Para operar como usuário específico (testar permissões), --user=admin ou --user=42. Para sites em multisite, use --url=https://subsite.com para apontar ao site correto.

Quando NÃO usar WP-CLI

• Em hospedagem compartilhada que bloqueia SSH — sem terminal, sem WP-CLI; nesses casos, plugins UI como WP-DBManager ou Better Search Replace substituem parcialmente.
• Para usuário final não-técnico — exige terminal e atenção a comandos; o painel WordPress continua sendo a interface natural para quem só publica conteúdo.
• Para tarefas que só existem em GUI — arrastar-soltar imagens no editor Gutenberg, configurar Customizer ao vivo, posicionar widgets visuais — WP-CLI manipula dados, não interface.
• Em ambientes onde PHP CLI está desabilitado — algumas hospedagens muito limitadas bloqueiam php via shell por questão de segurança; WP-CLI depende disso.
• Sob restrição corporativa que proíbe ferramentas não-aprovadas — apesar de FOSS e seguro, regulamentos como SOX/PCI-DSS em ambiente regulamentado podem exigir auditoria prévia da ferramenta.

Comandos essenciais que todo profissional deveria saber

wp core check-update avisa se há atualização do WordPress disponível. wp core update atualiza para a última versão. wp core update-db roda as migrations de banco que acompanham atualizações. wp plugin install woocommerce --activate baixa e ativa em um único comando. wp plugin update --all atualiza tudo. wp theme install astra --activate tema novo em um comando. wp option get siteurl lê uma opção; wp option update siteurl https://novo.com atualiza. wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_status='publish'" roda SQL bruto. wp post list --post_type=post --posts_per_page=10 --orderby=date --order=DESC --fields=ID,post_title lista os 10 posts mais recentes em tabela formatada. wp cache flush limpa o object cache (Redis/Memcached). wp rewrite flush regenera permalinks. Domine esses dez comandos e você cobre 80% das operações cotidianas.

Perguntas frequentes

Veredicto: vale instalar?

Para qualquer desenvolvedor, administrador de sistemas, agência ou profissional que opere WordPress, a resposta é uma única palavra: essencial. WP-CLI é provavelmente a ferramenta de maior retorno por hora investida no ecossistema WordPress — duas tardes aprendendo equivalem a dezenas de horas economizadas ao longo do ano. Para usuário final sem terminal, não faz diferença; para qualquer um que gerencie mais de um site, deixa de ser opcional. Custo zero, suporte oficial, comunidade ativa, integração com toda hospedagem séria. Comece hoje conectando ao SSH da sua hospedagem, rodando wp --info para confirmar disponibilidade, e tente seu primeiro comando útil: wp plugin list. Em uma semana você não consegue mais administrar WordPress sem ele.

Para complementar o fluxo profissional, veja também o Tabby como emulador moderno onde rodar WP-CLI confortável, o WinMerge para diff de arquivos de configuração WordPress e o Linux Mint como sistema operacional ideal para servidor de staging WordPress.

Você também vai gostar

Melhores Temas WordPress Gratuitos para Sites Profissionais

Slider Revolution: Alternativas Gratuitas Open Source para WordPress (2026)

Gravity Forms: Alternativas Gratuitas para Formularios WordPress (2026)

Rank Math Grátis vs Yoast SEO: Qual o Melhor Plugin SEO