WP-CLI Avançado: Manutenção e Otimização em VPS LEMP

O gerenciamento eficiente de ambientes WordPress em servidores VPS requer mais do que acesso básico ao painel de controle. Para administradores de sistemas e desenvolvedores que operam em infraestruturas LEMP (Linux, Nginx, MySQL, PHP) ou OpenLiteSpeed, o WP-CLI se torna a ferramenta indispensável para automação, manutenção e resolução de problemas complexos. Este tutorial detalha como utilizar o WP-CLI avançado para otimizar cache Redis, executar backups robustos, gerenciar sites Multisite e realizar migrações seguras, garantindo alta performance e segurança sem depender exclusivamente de interfaces gráficas.

1. Configuração do Ambiente LEMP/OpenLiteSpeed

Antes de iniciar as operações avançadas, é crucial garantir que o seu ambiente esteja preparado. Em uma configuração típica de VPS, você deve ter o PHP-FPM configurado corretamente e o banco de dados acessível via linha de comando. Se estiver utilizando OpenLiteSpeed, certifique-se de que o módulo PHP está habilitado e a variável de contexto web está correta.

O WP-CLI precisa ser executado como o usuário proprietário dos arquivos do WordPress (geralmente www-data ou um usuário dedicado) para evitar permissões incorretas nos arquivos gerados. Verifique as permissões antes de prosseguir:

chown -R www-data:www-data /var/www/seu-dominio
chmod -R 755 /var/www/seu-dominio

Se você estiver usando uma stack LEMP tradicional com Nginx, o processo é similar. A diferença chave no OpenLiteSpeed reside na forma como o cache de objeto é gerenciado, o que abordaremos na seção de otimização.

2. Otimização de Cache com Redis e WP-CLI

A otimização WP depende criticamente da configuração correta do backend de cache. Enquanto plugins como WP Rocket ou W3 Total Cache oferecem interfaces visuais, o WP-CLI permite verificar e depurar o estado do cache Redis de forma programática, essencial para troubleshooting em produção.

Primeiro, verifique se o objeto de cache está carregado e conectado ao Redis:

wp cache get test_key

Se a resposta for false, o WordPress não está comunicando com o Redis. Para forçar a limpeza do cache via CLI (útil após atualizações de tema ou plugin), utilize:

wp cache flush

Em ambientes OpenLiteSpeed, é comum utilizar o LiteSpeed Cache Plugin. Você pode verificar o status do cache através do comando:

wp lscache status

Para otimizar agressivamente, você pode purgar o cache de página e o cache de objeto simultaneamente via script automatizado:

wp lscache purge all
wp cache flush

Esses comandos devem ser integrados em seus scripts de CI/CD ou deploy para garantir que novas versões do código sejam refletidas instantaneamente no front-end.

3. Backup e Restauração Robusta com WP-CLI

O backup WP-CLI é superior às ferramentas gráficas em ambientes de produção porque evita timeouts de memória e permite compressão eficiente. O comando wp db export cria um dump SQL otimizado, mas para backups completos (banco + arquivos), recomendamos scripts personalizados.

3.1 Exportação do Banco de Dados

Utilize o flag --path se estiver executando o comando fora da raiz do WordPress:

wp db export /backups/wordpress_$(date +%F).sql --path=/var/www/seu-dominio

Para compactar imediatamente e economizar espaço no disco da VPS, pipe o resultado para gzip:

wp db export - --path=/var/www/seu-dominio | gzip > /backups/wordpress_$(date +%F).sql.gz

3.2 Restauração de Emergência

Em caso de falha crítica, a restauração deve ser rápida. Importe o banco de dados compactado:

gunzip < /backups/wordpress_$(date +%F).sql.gz | wp db import - --path=/var/www/seu-dominio

Após a restauração do banco, é necessário limpar caches e redefinir permissões se os arquivos de upload foram substituídos:

wp cache flush
wp option update siteurl 'https://seu-dominio.com'
wp option update home 'https://seu-dominio.com'

4. Gerenciamento Avançado de Multisite

A arquitetura WordPress Multisite introduz complexidades específicas que o WP-CLI resolve com elegância. Administradores podem gerenciar centenas de sub-sites sem sobrecarregar o painel administrativo, reduzindo a carga no PHP-FPM.

4.1 Identificação e Navegação

Em um ambiente Multisite, você deve especificar o ID do site ou o domínio antes de executar comandos específicos:

wp --url=subdominio.seu-dominio.com plugin list

Alternativamente, use o parâmetro --network para executar ações em todos os sites da rede simultaneamente:

wp plugin update --all --network

4.2 Criação e Configuração de Sites Filhos

Para adicionar um novo site à rede via CLI, utilize:

wp site create --slug=novo-servico --title="Novo Serviço" --network_id=1

Para configurar variáveis de ambiente ou constantes específicas para aquele sub-site (como limites de memória PHP), você pode injetar configurações diretamente no banco de dados usando wp option add, mas tome cuidado com a serialização de objetos:

wp --url=novo-servico.seu-dominio.com option add custom_setting value_aqui

5. Migração WordPress entre Servidores

A migração WordPress é uma das tarefas mais comuns para profissionais de TI. O WP-CLI oferece o comando wp search-replace, que é infinitamente superior ao "Buscar e Substituir" manual do banco de dados, pois lida corretamente com serialização de arrays no WordPress (evitando a corrupção de dados).

5.1 Preparação do Destino

No servidor de destino, importe o dump do banco de dados e descompacte os arquivos. Certifique-se de que as permissões estão corretas antes de iniciar.

5.2 Execução da Troca de Domínio

Execute o comando de busca e substituição com o flag --dry-run primeiro para visualizar quantas alterações serão feitas:

wp search-replace 'http://antigo-dominio.com' 'https://novo-dominio.com' --dry-run --precise --all-tables --path=/var/www/novo-dominio

Se os resultados estiverem corretos, remova o --dry-run para aplicar as alterações:

wp search-replace 'http://antigo-dominio.com' 'https://novo-dominio.com' --precise --all-tables --path=/var/www/novo-dominio

O flag --precise é crucial aqui. Ele garante que o WP-CLI utilize consultas SQL precisas em vez de substituições simples de string, preservando a integridade dos dados serializados (como configurações de plugins e widgets).

5.3 Limpeza Pós-Migração

Após a migração, execute uma verificação de saúde do site e limpe os caches:

wp core verify-checksums
wp transient delete --all
wp cache flush

6. Automação com Scripts Shell

A verdadeira eficiência em VPS vem da automação. Combine os comandos acima em scripts shell para criar rotinas de manutenção diárias ou semanais.

Crie um arquivo maintenance.sh:

#!/bin/bash
DOMAIN="seu-dominio.com"
PATH_WP="/var/www/$DOMAIN"
DATE=$(date +%F)

echo "Iniciando backup do banco de dados..."
wp db export /backups/db_$DATE.sql --path=$PATH_WP

echo "Compactando backup..."
gzip /backups/db_$DATE.sql

echo "Atualizando plugins (somente patch/minor)..."
wp plugin update --all --path=$PATH_WP

echo "Limpando caches..."
wp cache flush --path=$PATH_WP

echo "Verificando integridade do core..."
wp core verify-checksums --path=$PATH_WP

echo "Manutenção concluída para $DOMAIN em $(date)"

Torne o script executável e agende-o via crontab:

chmod +x maintenance.sh
crontab -e
# Adicionar: 0 3 * * 0 /caminho/para/maintenance.sh >> /var/log/wp-maintenance.log 2>&1

7. Troubleshooting Comum em LEMP/OpenLiteSpeed

Durante o uso avançado do WP-CLI, erros de permissão e timeout são frequentes. Se você receber erros de Permission denied, verifique se está executando o comando como o usuário correto (ex: sudo -u www-data wp ...).

Se o comando falhar por timeout em sites grandes, aumente o limite de tempo no seu script PHP ou utilize a flag --skip-plugins para identificar conflitos:

wp plugin list --skip-plugins=woocommerce,elementor

Em configurações OpenLiteSpeed, problemas de cache persistente podem ser resolvidos reiniciando o serviço do LiteSpeed via CLI se o plugin não responder:

/usr/local/lsws/bin/lswsctrl restart

Conclusão

O domínio do WP-CLI transforma a administração de WordPress de uma tarefa manual e propensa a erros em um processo técnico, replicável e seguro. Ao integrar esses comandos à sua stack LEMP ou OpenLiteSpeed, você garante que backups, migrações e otimizações de cache Redis sejam executados com precisão cirúrgica. Para profissionais de TI no Brasil, essa competência é essencial para manter a performance do WooCommerce e a estabilidade de sites corporativos em ambientes de VPS escaláveis.

Lembre-se: sempre teste comandos de produção em um ambiente de staging antes de aplicá-los ao vivo. A eficiência remota depende da confiança nos seus scripts e na integridade dos seus backups automatizados.