Como usar o WP-CLI para gerenciar o WordPress direto pelo terminal
Oi! Aqui é a Sensei da GeHost 🥋 e hoje eu vou te ensinar um truque que separa quem só "mexe no WordPress" de quem realmente manda nele: o WP-CLI. É a ferramenta de linha de comando oficial do WordPress — com ela você atualiza plugins, temas e o próprio WordPress, cria usuários, limpa cache e resolve várias coisas em segundos, sem precisar clicar em telinha por telinha.
Calma que eu vou te guiar passo a passo, sem economizar explicação. Bora?
1. Antes de tudo: você precisa do Terminal habilitado
O WP-CLI roda dentro de um Terminal (linha de comando) disponível no seu painel cPanel. Esse recurso pode variar conforme o plano e a configuração da sua conta. Se você não encontrar a opção "Terminal" no seu cPanel, não se preocupe — é só chamar o nosso suporte pelo painel.gehost.com.br e a gente confirma disponibilidade pra você. 😉
Dica da Sensei: se essa é sua primeira vez usando o terminal, não tem problema nenhum ser leigo nisso — vou te mostrar os comandos prontinhos, é só copiar e colar.
2. Acessando o cPanel
- Acesse o painel do seu cPanel com o usuário e a senha da sua hospedagem.
- Na tela inicial, procure o grupo de ferramentas "Avançado" e clique em "Terminal".
3. Indo até a pasta do seu site
Assim que o terminal abrir, você precisa "entrar" na pasta onde o seu WordPress está instalado (geralmente é a public_html, ou uma subpasta dela se o site estiver num domínio adicional). Digite:
cd public_html— e aperte Enter.- Se o seu site estiver numa subpasta (ex.: um addon domain), o caminho muda um pouco — se tiver dúvida de qual pasta é a certa, dá uma conferida no Gerenciador de Arquivos do cPanel antes.
4. Testando se o WP-CLI está funcionando
Com o terminal na pasta certa, digite:
wp core version
Se aparecer o número da versão do seu WordPress, prontinho — está tudo funcionando e você já pode sair usando os comandos abaixo. 🎉
5. Os comandos mais úteis no dia a dia
- Ver a versão do WordPress:
wp core version - Listar plugins instalados:
wp plugin list - Atualizar todos os plugins de uma vez:
wp plugin update --all - Atualizar um plugin específico:
wp plugin update nome-do-plugin - Listar temas instalados:
wp theme list - Listar usuários do site:
wp user list - Trocar a senha de um usuário:
wp user update nome_do_usuario --user_pass=NovaSenhaForte123 - Limpar o cache do WordPress:
wp cache flush - Verificar se há atualização pendente do WordPress:
wp core check-update
6. Cuidado redobrado com comandos que alteram o banco de dados
Um dos comandos mais poderosos do WP-CLI é o search-replace, usado por exemplo para trocar a URL do site no banco de dados inteiro:
wp search-replace 'https://seusiteantigo.com' 'https://seusitenovo.com'
Atenção, isso é sério: comandos que mexem direto no banco de dados (como o search-replace) ou que atualizam plugins/temas/core NÃO têm "desfazer". Antes de rodar qualquer um deles, faça um backup completo do seu site pelo cPanel. É rapidinho e evita dor de cabeça.
7. Não travou em nenhum comando? Ótimo sinal!
Se em algum momento aparecer uma mensagem de erro que você não entendeu, não force a barra. Copie a mensagem completa e manda pro nosso suporte pelo painel.gehost.com.br — a gente te ajuda a interpretar e resolver com segurança. Lembrando que todo serviço entregue pela GeHost já vem com 30 dias de suporte grátis após a entrega. 💙
Resumo da Sensei: WP-CLI é ótimo pra ganhar tempo, mas com grandes poderes vêm grandes responsabilidades — sempre backup antes, e sempre com calma. Qualquer dúvida, a equipe GeHost está aqui pra você. 🥋