WP-CLI: o controle remoto do seu WordPress
Oi! Aqui é a Sensei da GeHost 🧡 Hoje eu quero te apresentar uma ferramenta que muita gente nem sabe que existe, mas que pode economizar um tempo enorme no seu dia a dia: o WP-CLI — a interface de linha de comando do WordPress.
Calma, o nome assusta mais do que a prática! Pensa assim: em vez de clicar em botões dentro do painel do WordPress (aquele wp-admin cheio de menus), você digita um comandinho curto no terminal e o WordPress obedece na hora. É rápido, é preciso e, depois que você pega o jeito, vira praticamente um superpoder.
Dica da Sensei: o WP-CLI não substitui o painel — ele é um atalho. Você pode usar os dois no dia a dia, cada um na hora que fizer mais sentido.
Para quem é este guia?
Este conteúdo é para quem já tem um pouco de intimidade com o terminal (aquela telinha preta de comandos) e quer aprender a usar o WP-CLI para tarefas como atualizar plugins, trocar senhas, limpar cache e outras manutenções do WordPress. Se você nunca usou terminal antes, sem problema: vá com calma, siga o passo a passo e, qualquer dúvida, nosso suporte está aqui pra te ajudar.
Importante: o acesso via terminal (SSH) pode variar de acordo com o seu plano de hospedagem. Se você não sabe se tem esse acesso liberado, dá uma olhada no painel.gehost.com.br ou fale com o nosso suporte para confirmar a disponibilidade no seu contrato.
Passo 1 — Conectando ao seu site pelo terminal
O primeiro passo é acessar o seu site via SSH (o "corredor seguro" que liga o seu computador ao servidor onde o WordPress está hospedado). Normalmente você vai usar um programa de terminal do seu computador (no Windows, algo como PowerShell ou PuTTY; no Mac e Linux, o próprio Terminal) e um comando parecido com este:
- Abra o programa de terminal do seu computador.
- Digite o comando de conexão SSH com o usuário e o domínio do seu site (essas informações você encontra no seu painel de hospedagem).
- Informe a senha quando for solicitado (ela não aparece na tela enquanto você digita — é normal, é assim mesmo!).
Dica da Sensei: guarde seus dados de acesso (usuário, senha, domínio) em um lugar seguro. Se tiver dúvida sobre qual é o seu, consulte o painel do cliente ou peça ajuda ao suporte.
Passo 2 — Confirmando que o WP-CLI está pronto pra uso
Depois de conectado, entre na pasta do seu WordPress (geralmente chamada public_html ou o nome do seu domínio) e digite:
- wp --info — esse comando mostra a versão do WP-CLI instalada e alguns detalhes técnicos. Se aparecer uma resposta, é sinal de que está tudo certo e você já pode seguir em frente!
Se aparecer uma mensagem de "comando não encontrado", pode ser que o WP-CLI ainda não esteja disponível no seu ambiente — nesse caso, chame o nosso suporte que a gente te orienta.
Passo 3 — Comandos do dia a dia que todo cliente deveria conhecer
Agora vem a parte boa! Aqui estão alguns comandos simples e muito úteis para o seu dia a dia:
Ver a versão do WordPress instalada
- wp core version — mostra rapidinho qual versão do WordPress está rodando no seu site.
Atualizar o WordPress
- wp core update — atualiza o núcleo do WordPress para a versão mais recente, sem precisar entrar no painel.
Listar plugins instalados
- wp plugin list — mostra todos os plugins, se estão ativos ou não, e se há atualização disponível.
Atualizar todos os plugins de uma vez
- wp plugin update --all — atualiza todos os plugins do site em um único comando. Uma mão na roda quando você tem muitos plugins instalados!
Ativar ou desativar um plugin
- wp plugin activate nome-do-plugin
- wp plugin deactivate nome-do-plugin
Redefinir a senha de um usuário
- wp user update nome-do-usuario --user_pass=novaSenhaForte — perfeito para quando alguém esquece a senha e você precisa resolver rápido.
Fazer backup do banco de dados
- wp db export — exporta uma cópia do banco de dados do seu WordPress. Ótimo para ter uma segurança extra antes de fazer qualquer alteração importante.
Dica da Sensei: sempre que for mexer em algo mais delicado (atualizar plugin, trocar tema, alterar banco), faça um backup antes. É como aquele cinto de segurança: você espera nunca precisar, mas fica muito mais tranquilo sabendo que está lá.
Passo 4 — Colocando o site em manutenção (com segurança)
Se você for fazer uma alteração maior e quiser avisar os visitantes que o site está em manutenção por alguns instantes, use:
- wp maintenance-mode activate — liga o modo manutenção.
- wp maintenance-mode deactivate — desliga o modo manutenção assim que terminar.
Passo 5 — Limpando o cache do site
Se o seu WordPress usa algum plugin de cache, muitos deles também têm comandos próprios de WP-CLI para limpeza. Um comando bem comum é:
- wp cache flush — limpa o cache de objetos do WordPress.
Se você usa um plugin de cache específico (como os mais populares do mercado), vale a pena consultar a documentação dele, pois muitos adicionam seus próprios comandos ao WP-CLI.
Boas práticas para usar o WP-CLI com tranquilidade
- Sempre faça backup antes de mudanças importantes. O comando wp db export é seu amigo.
- Teste um comando por vez. Evite empilhar várias alterações antes de verificar se o site continua funcionando bem.
- Confira o site depois de cada atualização. Dê uma olhada rápida no site pelo navegador para confirmar que está tudo normal.
- Anote os comandos que você mais usa. Com o tempo, você vai perceber que sempre repete os mesmos — vale ter um "chuleta" pessoal.
Dica da Sensei: não sabe se um comando é seguro para o seu caso? Pare, respire e pergunte para o nosso suporte antes de rodar. É sempre melhor perguntar antes do que se preocupar depois. 💛
Precisa de ajuda?
Se em algum momento você se sentir perdido, sem acesso ao SSH, ou só quiser confirmar se um comando é indicado para o seu caso, fale com o nosso time de suporte. Estamos aqui para tornar a gestão do seu WordPress mais simples — com ou sem terminal!