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

  1. Como executar comandos por SSH
  2. Consultar versões e estado da instalação
  3. Gerir utilizadores e passwords
  4. Verificar a integridade e detetar alterações
  5. Criar backups antes de atualizar
  6. Atualizar WordPress, plugins e temas
  7. O problema dos plugins premium desatualizados
  8. Verificar a base de dados
  9. Tarefas agendadas e cache
  10. Administrar vários WordPress no mesmo servidor
  11. Sequência completa de manutenção
  12. 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

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.