Como Usar a Linha de Comando WP-CLI no WordPress
Oi! Sou o Sensei da GeHost 😊 Vou te ensinar um "superpoder" pro seu WordPress: o WP-CLI, que é basicamente uma forma de **controlar seu site inteiro sem precisar clicar em nada** — só digitando comandos. Parece complicado, mas é muito prático e te economiza MUUITO tempo. Vem comigo!
O que é WP-CLI? (A resposta fácil)
Imagina que você está numa loja e o dono te dá um controle remoto gigante pra gerenciar tudo: mudar preço, remover produto, fazer backup, atualizar… Pois bem, WP-CLI é exatamente esse controle remoto pro seu WordPress. Você não clica em nenhum botão — só digita comandos no terminal (a "tela preta" que parece de filme de hacker 😄) e o WordPress faz.
Por que usar? Porque é muito mais rápido que navegar pelo painel, você consegue fazer várias coisas de uma vez, e em caso de problema, consegue recuperar dados sem desespero.
Pré-requisito: Acessar o Terminal (SSH)
Pra usar WP-CLI, você precisa acessar seu site via SSH (Secure Shell) — é tipo um "telefone seguro" entre o seu computador e o servidor da GeHost. Aqui está como fazer:
- Pega suas credenciais SSH. Entra no painel da GeHost (painel.gehost.com.br) → Hospedagem → Gerenciar → Acesso SSH. Lá você vê:
- Hostname (ex: server.gehost.com.br)
- Usuário (seu cpanel_user)
- Senha (a mesma da hospedagem)
- No Windows: Baixa e abre o PuTTY (é grátis). Coloca o Hostname em "Host Name", deixa a porta 22, clica "Open". Vai pedir usuário e senha — digita os dados do SSH.
- No Mac ou Linux: Abre o Terminal (vem no sistema mesmo) e digita:
ssh seu_usuario@servidor.gehost.com.br
Depois digita sua senha e pronto — você está dentro!
Achando Seu WordPress (Primeiro Passo)
Quando você entra no SSH, aparece uma "pasta" chamada sua conta. Seu WordPress está dentro de uma pasta chamada public_html (é aí que o site "mora"). Pra entrar lá:
cd public_html
Pronto! Agora você está na raiz do seu site. Se você digitar ls (listagem), aparece o wp-config.php, wp-content, wp-admin e tudo que é típico do WordPress.
Os Comandos Básicos (Comece Aqui!)
Aqui vêm os comandos que você vai usar 90% do tempo. É só copiar, colar no terminal e apertar Enter:
- Ver a versão do WordPress
wp core version
Útil quando você não lembra se atualizou ou não.
- Atualizar o WordPress
wp core update
Faz a atualização toda no automático. Muito mais rápido que entrar no painel.
- Listar todos os plugins instalados
wp plugin list
Vê todos, com a versão e se estão ativos ou não.
- Ativar/Desativar um plugin
wp plugin activate nome-do-plugin
wp plugin deactivate nome-do-pluginSubstitui "nome-do-plugin" pelo nome real (ex: wp plugin activate jetpack). Útil quando um plugin trava o site.
- Atualizar todos os plugins de uma vez
wp plugin update --all
Não precisa entrar no painel, um por um. Tudo junto!
- Listar usuários do WordPress
wp user list
Mostra quem tem acesso ao painel.
- Resetar senha de um usuário
wp user update user_id --prompt=user_pass
Troca a senha direto — nenhum e-mail de "esqueci a senha", nada. Bem prático se você é o admin.
- Fazer backup da base de dados
wp db export backup.sql
Cria um arquivo "backup.sql" com TUDO do seu banco de dados. Salva na raiz do seu site.
- Limpar o cache de uma loja WooCommerce
wp cache flush
Às vezes a loja fica "presa" no cache. Esse comando limpa tudo e deixa fresco.
- Desativar o modo de manutenção
wp maintenance-mode deactivate
Se seu site ficou com "Site em Manutenção" travado, esse comando tira.
Casos de Uso — Quando (e Por Que) Usar WP-CLI
Cenário 1: Seu site "congelou" depois de uma atualização. Um plugin está travando tudo.
- Via WP-CLI: wp plugin list → acha o suspeito → wp plugin deactivate nome → site voltou! 3 linhas de comando.
- Via painel: Entra no painel (se conseguir), vai em Plugins, desativa um por um, testa… 10 minutos no mínimo.
Cenário 2: Você tem 50 posts e quer trocar uma palavra em todos eles (ex: "loja" → "e-commerce").
- Via WP-CLI: Um comando e pronto.
- Via painel: Edita cada post na mão… Boa sorte com as 50! 😅
Cenário 3: Precisa fazer backup urgente e não quer esperar o painel.
- Via WP-CLI: wp db export → 2 segundos, seu banco está salvo.
- Via painel: Clica em Ferramentas → Exportar → Escolhe opções → Espera… 5 minutos.
Dicas de Ouro (Pra Não Dar Ruim)
⚠️ Sempre faça backup ANTES de qualquer comando maior. WP-CLI é poderoso — se você digitar um comando errado, pode deletar coisas. Sempre, SEMPRE faça um backup da base antes de experimenta.
💡 Comece com comandos "read-only". Primeiro aprenda a ver (list, export) antes de mexer (activate, delete). Tipo: testa wp plugin list antes de desativar um.
📖 Use wp help. Se tiver dúvida num comando, digita wp help comando (ex: wp help plugin) e aparece a explicação completa.
🔐 Sua conexão SSH é segura. Você pode digitar tudo que precisa sem medo — tudo fica entre você e nosso servidor. Ninguém vê.
E Se Eu Errar um Comando?
Respira! 😊 Erros de digitação normalmente não fazem nada — o comando simplesmente não funciona e aparece uma mensagem de erro tipo "comando não encontrado" ou "parâmetro inválido". Nem danifica o site.
O risco real é só se você rodar um comando sem backup prévio que DELETA dados (tipo wp post delete com --force). Mas aí é bem óbvio que está deletando algo.
Se der ruim mesmo: Você tem backups automáticos aqui no servidor (Painel → Backup) — é só chamar a gente que restaura em minutos. Relaxa, tem rede de segurança! 🛡️
Próximos Passos
Agora que você conhece o básico, explore! Alguns comandos que valem a pena aprender:
- wp theme list / wp theme update — Gerencia temas
- wp transient delete --all — Limpa dados temporários (quando o site fica lento)
- wp search-replace "texto_antigo" "texto_novo" --dry-run — Substitui em massa (com --dry-run pra conferir antes de aplicar)
- wp db optimize — Otimiza o banco de dados (deixa mais rápido)
E se bater uma dúvida, é só chamar a gente no chat ou abrir um ticket no painel. Estamos aqui pra ajudar! 💪
Bora dominar esse WP-CLI e fazer seu site voar? 🚀
