Resposta direta: para atualizar o WHMCS, consulte as notas de cada versão, confirme requisitos e sequência de atualização, revise módulos e personalizações, teste uma réplica e faça backup do banco e dos arquivos. Execute a mudança em janela controlada e valide clientes, pedidos, pagamentos, tickets e tarefas cron antes de encerrar.
Revisão técnica: 08/09/2026.
Descubra origem, destino e caminho
Registre a versão instalada, licença e canal de distribuição. Escolha uma versão ainda suportada e verifique se versões intermediárias são exigidas. A documentação do WHMCS orienta conferir requisitos de cada etapa, notas de versão e permissões do banco.
Verifique ambiente e dependências
Compare PHP, ionCube, MySQL, extensões, memória, espaço e tarefas de linha de comando com a versão alvo. Confirme que o PHP do cron corresponde ao esperado. Avalie módulos de pagamento, registradores, provisionamento e marketplace, porque cada fornecedor pode impor requisitos ou não suportar a versão nova.
Inventarie personalizações
Liste hooks, módulos, templates, arquivos de idioma, rotas e alterações manuais. Compare com a distribuição original e atualize código incompatível. Use o guia de personalização de traduções no WHMCS para evitar sobrescrever arquivos centrais. Remova componentes abandonados antes de ampliar a mudança.
Teste uma réplica protegida
Restaure arquivos e banco em ambiente de desenvolvimento autorizado pela licença, bloqueado ao público e sem mensagens ou cobranças reais. Execute a mesma sequência planejada. Teste login administrativo e do cliente, produtos, pedidos, faturas, pagamentos, tickets, e-mail, domínio, provisionamento, API e cron.
Faça backup e execute a janela
Crie cópia consistente do diretório inteiro e do banco imediatamente antes. Confirme espaço, manutenção, responsáveis, comunicação e critério de reversão. Prefira o atualizador automático quando o ambiente cumpre os requisitos oficiais. Não misture atualização do WHMCS, PHP, tema e módulos na mesma janela sem necessidade.
Valide e monitore depois
Repita os testes críticos, confira logs, filas e integridade das automações. Acompanhe a área de System Health e alertas por pelo menos o período de operação necessário. Documente versão, data, falhas e correções. Preserve o backup até confirmar ciclos recorrentes como renovação, cobrança e suspensão.
