Como usar o WP-CLI pra gerenciar o WordPress via linha de comando

Como usar o WP-CLI pra gerenciar o WordPress via linha de comando

Oi! 🥋 Aqui é a Sensei da GeHost. Se você já ouviu falar em WP-CLI e ficou curioso(a) — ou se algum desenvolvedor te passou um comando e você não fazia ideia do que fazer com ele — relaxa. Vou te explicar com calma, passo a passo, sem juridiquês nem termo técnico jogado sem explicação.

O que é o WP-CLI?

WP-CLI é uma ferramenta de linha de comando (aquela telinha preta com texto, sem cliques nem botões) que permite gerenciar o WordPress digitando comandos, em vez de navegar pelo painel administrativo do site. Com ele dá pra atualizar plugins, temas e o próprio WordPress, criar usuários, fazer backup do banco de dados e muito mais — tudo bem mais rápido do que clicando tela por tela.

💡 Dica da Sensei: o WP-CLI é uma ferramenta pensada pra quem já tem alguma familiaridade com terminal/SSH — normalmente usada por desenvolvedores ou por quem administra o site no dia a dia. Se você nunca usou linha de comando antes, não tem problema nenhum continuar fazendo tudo pelo painel do WordPress ou pedindo apoio ao nosso suporte.

Pré-requisitos antes de começar

1. Acesso SSH à sua hospedagem — é por ele que você "entra" no servidor pra digitar os comandos. Se você não sabe se o seu plano tem esse acesso liberado, é só falar com o suporte GeHost pelo painel.gehost.com.br que a gente confirma pra você.
2. Um programa de terminal no seu computador (no Windows, ferramentas como PuTTY ou o Terminal do Windows; no Mac e Linux, o próprio Terminal já serve).
3. Saber em qual pasta o seu WordPress está instalado (normalmente dentro de public_html ou de uma subpasta, se o site estiver num subdomínio).

Passo 1: Conectando via SSH

Com os dados de acesso SSH em mãos (usuário, host e senha ou chave, que você encontra ou solicita no painel do cliente), conecte-se ao servidor pelo terminal. Depois de conectado, navegue até a pasta do seu WordPress com o comando:

cd public_html

(troque public_html pelo caminho certo, caso seu site esteja em outra pasta)

Passo 2: Verificando se o WP-CLI está disponível

Digite o comando abaixo e aperte Enter:

wp --info

Se aparecer um resumo com a versão do PHP, caminho do WordPress etc., é sinal de que o WP-CLI já está pronto pra uso no seu ambiente. Se aparecer alguma mensagem de "comando não encontrado", entre em contato com o nosso suporte — a gente te ajuda a verificar a disponibilidade da ferramenta no seu plano.

Passo 3: Comandos essenciais no dia a dia

Aqui vão alguns dos comandos mais usados. Você pode ir testando com calma, um de cada vez:

• Ver a versão do WordPress instalada:

  wp core version

• Atualizar o núcleo do WordPress:

  wp core update

• Listar os plugins instalados:

  wp plugin list

• Atualizar todos os plugins de uma vez:

  wp plugin update --all

• Listar os temas instalados:

  wp theme list

• Criar um novo usuário administrador:

  wp user create novousuario email@seudominio.com.br --role=administrator

• Exportar o banco de dados (backup rápido):

  wp db export backup.sql

• Limpar o cache (em sites com plugin de cache compatível):

  wp cache flush

💡 Dica da Sensei: sempre que for rodar um comando que muda algo estrutural — atualizar o núcleo, atualizar todos os plugins de uma vez, mexer no banco de dados — faça um backup completo antes. Assim, se algo não sair como esperado, dá pra voltar tranquilamente pro estado anterior.

Passo 4: Automatizando tarefas repetitivas

Uma das grandes vantagens do WP-CLI é poder combinar comandos em um único script, pra rodar várias tarefas de uma vez (por exemplo: atualizar plugins, temas e núcleo, e depois limpar o cache). Se você já tem alguma prática com terminal, isso economiza um bom tempo. Se preferir não se arriscar, siga fazendo essas atualizações uma de cada vez pelo painel do WordPress mesmo — não tem problema nenhum, o resultado final é o mesmo.

Quando pedir ajuda ao suporte

Se em algum momento um comando retornar um erro que você não entende, ou se algo no site parecer estranho depois de rodar um comando, pare por ali e chame o suporte GeHost pelo painel.gehost.com.br. É sempre melhor perguntar antes de continuar do que tentar "consertar" sozinho e piorar a situação.

💡 Dica da Sensei: o WP-CLI é poderoso justamente porque executa os comandos direto, sem as telas de confirmação do painel do WordPress. Use com carinho e sempre com um backup por perto — assim você aproveita a velocidade sem correr riscos desnecessários. 🥋

Espero que esse guia tenha deixado o WP-CLI menos assustador! Qualquer dúvida, a equipe da GeHost está por aqui.