DEV Community

Cover image for [PT-br] Administrando WordPress com WP-CLI: Um Guia Prático
Marcos Vilela
Marcos Vilela

Posted on

[PT-br] Administrando WordPress com WP-CLI: Um Guia Prático

Administrar um site WordPress pode ser uma tarefa desafiadora, especialmente quando lidamos com múltiplos projetos ou ambientes de produção. Para facilitar a minha rotina como DevOps/SRE, descobri no WP-CLI uma ferramenta poderosa para automação e gerenciamento eficiente do WordPress direto do terminal.

Neste artigo, vou compartilhar como utilizo o WP-CLI para simplificar tarefas administrativas, desde atualizações até criação de usuários e troubleshooting.

O que é WP-CLI?

O WP-CLI é uma interface de linha de comando para gerenciar instalações WordPress. Com ela, podemos realizar tarefas como:

  • Atualização de plugins, temas e o próprio WordPress;
  • Gerenciamento de posts, páginas e usuários;
  • Exportação/importação de banco de dados;
  • Verificação e depuração de configurações.

Se você trabalha com WordPress e infraestrutura em nuvem ou pipelines de CI/CD, como eu, vai perceber o quanto ele é útil para automações.

Pré-requisitos

Antes de começar, é importante garantir que seu ambiente atenda aos seguintes requisitos:

  • PHP instalado na máquina (recomendo versão >= 8.4).
  • WordPress já instalado no ambiente que você deseja gerenciar.
  • Acesso SSH ou local ao servidor onde o WordPress está hospedado.

Para instalar o WP-CLI, basta rodar o comando abaixo no terminal:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Enter fullscreen mode Exit fullscreen mode

Verifique a instalação:

wp --info
Enter fullscreen mode Exit fullscreen mode

Principais comandos do WP-CLI

1. Atualizações

Manter o ambiente atualizado é essencial para a segurança. Com o WP-CLI, atualizo temas, plugins e o core em segundos:

Atualizar tudo de uma vez:

wp core update && wp plugin update --all && wp theme update --all
Enter fullscreen mode Exit fullscreen mode

Atualizar apenas o core:

wp core update
Enter fullscreen mode Exit fullscreen mode

2. Gerenciar plugins e temas

Quando preciso habilitar ou desabilitar um plugin rapidamente, uso os comandos abaixo:

Listar plugins instalados:

wp plugin list
Enter fullscreen mode Exit fullscreen mode

Ativar/desativar um plugin específico:

wp plugin activate plugin-name
wp plugin deactivate plugin-name
Enter fullscreen mode Exit fullscreen mode
Para temas, o processo é semelhante:
wp theme activate theme-name
Enter fullscreen mode Exit fullscreen mode

3. Gerenciar usuários

Criar usuários com permissões específicas também é simples. Um exemplo prático é criar um usuário administrador para acesso temporário:

wp user create novo-admin email@example.com --role=administrator
Enter fullscreen mode Exit fullscreen mode

Se precisar redefinir a senha de um usuário existente:

wp user update username --user_pass=NovaSenha123!
Enter fullscreen mode Exit fullscreen mode

Automação com WP-CLI

Como trabalho com Infraestrutura como Código (IaC), costumo integrar o WP-CLI em scripts bash para automatizar tarefas comuns. Integrar WP CLI a automações reduz erros humanos e agiliza a entrega de novos ambientes.

Debugging com WP-CLI

Em casos de problemas no site, o WP-CLI oferece ferramentas úteis para debugging. Uma que utilizo com frequência é a verificação do status de saúde do site:

Para depurar configurações de plugins, uso:

wp plugin status
Enter fullscreen mode Exit fullscreen mode

Outra dica: sempre garanta que os logs de erro do PHP estão habilitados no ambiente para complementar o diagnóstico.

Conclusão

O WP-CLI é uma ferramenta indispensável para quem administra WordPress, seja em produção ou desenvolvimento. Desde que comecei a utilizá-lo, minha produtividade aumentou significativamente, e tarefas antes repetitivas se tornaram automáticas.

Se você ainda não utiliza o WP-CLI, recomendo instalar e explorar os comandos básicos. Quanto mais você se familiariza, mais verá o potencial dessa ferramenta em simplificar a gestão de sites WordPress.

E você, já utilizou o WP-CLI? Tem alguma dica ou caso de uso interessante? Compartilhe nos comentários! 🚀

Top comments (0)