WP-CLI: 20 comandos essenciais para gerir, atualizar e proteger o WordPress
O WP-CLI permite gerir o WordPress inteiramente pela linha de comandos: atualizações, utilizadores, backups, verificação de ficheiros e manutenção de vários sites no mesmo servidor. Este guia reúne cerca de 20 comandos úteis, organizados como uma rotina de manutenção e diagnóstico.
O WP-CLI é a interface de linha de comandos do WordPress. Em vez de entrar no painel de administração, dá as ordens diretamente no terminal — e é muito mais rápido quando tem de gerir vários sites.
É especialmente útil para quem administra WordPress em alojamento próprio ou VPS, onde muitas tarefas de manutenção e diagnóstico são mais rápidas — e mais fiáveis — por SSH do que pelo painel.
Neste artigo
- Como executar comandos por SSH
- Consultar versões e estado da instalação
- Gerir utilizadores e passwords
- Verificar a integridade e detetar alterações
- Criar backups antes de atualizar
- Atualizar WordPress, plugins e temas
- O problema dos plugins premium desatualizados
- Verificar a base de dados
- Tarefas agendadas e cache
- Administrar vários WordPress no mesmo servidor
- Sequência completa de manutenção
- Quando o WP-CLI não chega: infeções e segurança
Como executar comandos por SSH
- Entre no servidor por SSH.
- Use o utilizador do site e não o root. Assim os ficheiros criados ou alterados ficam com as permissões corretas.
- Posicione-se na pasta onde está o WordPress (a que contém o
wp-config.php), ou indique-a com--path=/caminho/do/site.
Consultar versões e estado da instalação
Antes de mexer no que quer que seja, confirme as versões em uso:
wp core version
wp cli version
Para saber o que está instalado e o que tem atualizações pendentes:
wp core check-update
wp plugin list
wp plugin list --update=available
wp theme list --update=available
O --update=available é especialmente útil para identificar plugins premium que não estão a ser atualizados automaticamente.
Gerir utilizadores e passwords
Listar todos os administradores é uma das verificações mais importantes numa auditoria de segurança:
wp user list --role=administrator --fields=ID,user_login,user_email,user_registered
Numa intervenção de segurança recente encontrámos 13 contas de administrador fraudulentas num só site — com nomes de aparência técnica que passavam despercebidas no painel. Este comando torna essas contas evidentes em segundos.
Para redefinir a password de um utilizador sem enviar email:
wp user reset-password admin --skip-email --porcelain
Substitua admin pelo nome de utilizador ou ID. A password gerada aparece no terminal — o que pode ser inconveniente se a sessão estiver a ser gravada ou partilhada. Nesse caso, prefira introduzir a nova password interativamente, sem a expor nos argumentos do comando:
wp user update admin --prompt=user_pass
Verificar a integridade e detetar alterações
Compara os ficheiros do WordPress instalado com os originais. É a forma mais rápida de detetar ficheiros alterados ou injetados após um ataque:
wp core verify-checksums
O mesmo princípio aplica-se aos plugins que disponibilizam checksums oficiais:
wp plugin verify-checksums --all
A verificação de checksums não abrange necessariamente plugins comerciais, personalizados ou que não disponibilizem checksums oficiais. Um aviso de checksum indisponível não é, por si só, evidência de malware.
Se a verificação reportar ficheiros do core diferentes ou em falta, pode repor os ficheiros base:
wp core download --skip-content --force
Este comando descarrega novamente os ficheiros oficiais do WordPress e substitui os existentes. Não elimina ficheiros adicionais, plugins maliciosos ou alterações à base de dados — um ficheiro wp-admin/backdoor.php poderá continuar no servidor após a operação. Em caso de infeção, deve ser acompanhado de uma auditoria ao sistema de ficheiros.
Criar backups antes de atualizar
Nenhuma rotina de manutenção deve começar sem uma cópia de segurança. Para a base de dados:
wp db export ~/wordpress-backup.sql
Guarde o ficheiro fora do diretório público do site e restrinja o acesso — o dump pode conter dados pessoais e credenciais. Para os ficheiros, garanta que existe um backup recente e recuperável a nível do servidor ou do painel de alojamento.
Atualizar WordPress, plugins e temas
wp core update
wp plugin update --all
wp theme update --all
Após uma atualização de versão principal, atualize também a base de dados, se necessário:
wp core update-db
O problema dos plugins premium desatualizados
O wp plugin update --all não garante que todos os plugins sejam atualizados.
Alguns plugins comerciais exigem licenças válidas ou mecanismos de atualização próprios. Outros são distribuídos juntamente com temas e podem ficar desatualizados durante anos, mesmo aparecendo como instalados e ativos.
Atenção: o WP-CLI só consegue instalar atualizações disponibilizadas pelos mecanismos de atualização configurados. Se a licença expirou ou o fornecedor não disponibilizar a atualização, o plugin poderá continuar desatualizado, mesmo depois de executar wp plugin update --all. É o que acontece frequentemente com plugins como Slider Revolution ou Fluent Forms Pro distribuídos com temas comerciais.
Verificar a base de dados
Para verificar a integridade das tabelas do WordPress:
wp db check
E para a cópia de segurança, como vimos na secção de backups:
wp db export ~/wordpress-backup.sql
Tarefas agendadas e cache
As tarefas agendadas do WordPress podem revelar problemas — e, em sites comprometidos, mecanismos de persistência:
wp cron event list
Permite identificar tarefas pendentes, eventos desconhecidos e problemas com o WP-Cron.
Para limpar a cache de objetos:
wp cache flush
Este comando limpa a cache de objetos do WordPress, mas não necessariamente as caches de página do NGINX, LiteSpeed, CDN ou plugins específicos.
Administrar vários WordPress no mesmo servidor
É aqui que o WP-CLI mostra todo o seu valor. Num servidor RunCloud, por exemplo, é possível percorrer todas as instalações e listar versões e atualizações pendentes:
for site in /home/runcloud/webapps/*; do
if [ -f "$site/wp-config.php" ]; then
echo "===== $site ====="
wp core version --path="$site"
wp plugin list --update=available --path="$site"
fi
done
O ciclo percorre as instalações WordPress diretamente localizadas em /home/runcloud/webapps/ e apresenta a versão instalada e os plugins com atualizações pendentes.
É apenas uma operação de leitura — não altera os sites e não cobre instalações em subdiretórios. E uma ressalva importante: se os sites pertencerem a diferentes utilizadores Linux, os comandos devem ser executados com as permissões adequadas a cada aplicação.
Sequência completa de manutenção
Juntando tudo, uma rotina de manutenção mais completa fica assim:
# Verificar a instalação
wp core verify-checksums
wp plugin verify-checksums --all
# Identificar atualizações pendentes
wp core check-update
wp plugin list --update=available
wp theme list --update=available
# Criar backup da base de dados
wp db export ~/wordpress-pre-update.sql
# Atualizar componentes
wp core update
wp plugin update --all
wp theme update --all
# Atualizar a base de dados, se necessário
wp core update-db
# Confirmar o estado final
wp core verify-checksums
wp plugin list --update=available
wp theme list --update=available
Esta sequência pressupõe que existe também um backup recente e recuperável dos ficheiros do site. Em produção, convém validar a compatibilidade dos plugins, especialmente em atualizações de versões principais.
Quando o WP-CLI não chega: infeções e segurança
O WP-CLI é excelente para manutenção e diagnóstico, mas uma infeção WordPress raramente se resolve com meia dúzia de comandos. Contas fraudulentas podem ser recriadas por backdoors, redirecionamentos podem estar no .htaccess ou em ficheiros HTML estáticos, e a base de dados pode guardar código malicioso.
Se os checksums apontarem alterações, se aparecerem administradores que não reconhece, ou se o site redirecionar visitantes, trate o caso como um incidente de segurança — não como uma atualização de rotina.
Leia As várias camadas de uma infeção WordPress para perceber porque eliminar um ficheiro malicioso não chega, e Site hackeado — o que fazer? para o procedimento de contenção e limpeza.
Artigos relacionados
- As várias camadas de uma infeção WordPress: porque eliminar um ficheiro malicioso não chega
- Site hackeado — o que fazer?
- Como instalar o Maldet (Linux Malware Detect)
- Como corrigir conteúdo misto no WordPress
Mantenha os sites atualizados: sites abandonados sem atualizações são alvos fáceis de ataques.
Precisa de ajuda na manutenção ou recuperação dos seus sites WordPress? Fale connosco.
Precisa de ajuda com wordpress?
Oferecemos soluções profissionais para WordPress. Fale connosco!
Suporte WordPress