Como Alterar a Versão do PHP do Seu Site no cPanel

alterar versão php no cpanel

Manter a versão do PHP atualizada é uma das tarefas mais importantes para quem gerencia um site. O PHP é a linguagem de programação que dá vida à maioria dos sites dinâmicos, e suas atualizações frequentes trazem não apenas novos recursos e melhor desempenho, mas também correções de segurança críticas. Alterar a versão do PHP no cPanel é um processo relativamente simples, mas que requer atenção para evitar quebras de compatibilidade no seu site. Este guia completo irá conduzi-lo através de todos os métodos disponíveis, desde o mais comum até configurações avançadas, permitindo que você gerencie seu ambiente PHP com confiança e segurança.

hostoo

Por que você deve se importar com a versão do PHP?

Antes de mergulharmos no “como”, é crucial entender o “porquê”. Utilizar uma versão desatualizada do PHP pode expor seu site a vulnerabilidades de segurança exploráveis por hackers. Além disso, versões mais recentes oferecem significantes ganhos de velocidade – o PHP 8.0, por exemplo, é em média 1,5x mais rápido que a versão 7.4. Muitos plugins e temas modernos também exigem versões recentes para funcionarem corretamente. No entanto, é importante testar seu site após a alteração, pois código legado pode não ser compatível com as versões mais novas.

Método 1: Alteração via Gerenciador de MultiPHP (Recomendado)

Esta é a forma mais direta e amplamente recomendada para a maioria dos usuários. O Gerenciador de MultiPHP permite alterar a versão com alguns cliques.

Passo a Passo Detalhado:

  1. Acesse o cPanel: Faça login no seu painel de controle cPanel. Geralmente, o acesso é feito através de https://seudominio.com:2083 ou via área de cliente da sua hospedagem.
  2. Localize a Ferramenta Correta: Na área “Software”, clique em “Gerenciador de MultiPHP“. Em algumas versões do cPanel, você pode encontrar esta opção buscando por “Alterar versão de PHP” na barra de pesquisa.
  3. Selecione o Domínio: Você verá uma lista de todos os seus domínios e subdomínios. Clique naquele para o qual deseja alterar a versão do PHP.
  4. Escolha a Nova Versão: No bloco “Versão do PHP” à direita, um menu suspenso mostrará as versões disponíveis. Selecione a versão desejada (por exemplo, PHP 8.3).
  5. Aplique a Alteração: Clique no botão “Aplicar” para confirmar. A mudança é instantânea e não requer reinicialização do servidor.

Ponto de Atenção Importante: Em contas cPanel, a versão selecionada será aplicada ao domínio principal e herdada por todos os subdomínios e domínios adicionais associados à conta. Não é possível definir versões diferentes para cada subdomínio usando esta ferramenta.

Método 2: Alteração Manual pelo Arquivo .htaccess

Este método é mais técnico e oferece granularidade, permitindo definir uma versão específica de PHP para um diretório ou domínio específico, algo não possível pelo Gerenciador de MultiPHP.

hospeda meu site

Quando usar este método?

  • Quando você precisa de uma versão de PHP diferente para um domínio adicional específico.
  • Para forçar uma versão particular em uma pasta específica (por exemplo, para uma aplicação legada).
  • Se, por algum motivo, a alteração pelo Gerenciador de MultiPHP não estiver funcionando.

Instruções Passo a Passo:

  1. Abra o Gerenciador de Arquivos: No cPanel, navegue até “Arquivos” → “Gerenciador de Arquivos”.
  2. Mostre Arquivos Ocultos: Na tela de “Configurações”, marque a opção “Mostrar arquivos ocultos (dotfiles)“. Isso é essencial para que o arquivo .htaccess seja visível.
  3. Navegue até o Diretório: Se for para o domínio principal, vá para a pasta public_html. Para um domínio adicional, acesse a pasta correspondente (ex: public_html/meudominio.com.br).
  4. Edite o Arquivo .htaccess: Clique com o botão direito no arquivo .htaccess e selecione “Editar”. Confirme a edição no pop-up que aparecer.
  5. Adicione o Código: No início do arquivo, insira o seguinte código, adaptando para a versão desejada: <IfModule mime_module> AddHandler application/x-httpd-ea-php83 .php .php8 .phtml </IfModule>
  6. Salve as Alterações: Clique em “Salvar Alterações” e feche o editor.

Tabela de Referência para Versões no .htaccess

Versão PHPCódigo a ser usado no .htaccess
PHP 8.3application/x-httpd-ea-php83
PHP 8.2application/x-httpd-ea-php82
PHP 8.1application/x-httpd-ea-php81
PHP 8.0application/x-httpd-ea-php80
PHP 7.4application/x-httpd-ea-php74

Atenção: Este método requer cuidado. Um erro de digitação no arquivo .htaccess pode resultar em um Erro 500 no seu site. Sempre faça um backup do arquivo antes de editá-lo.

Método 3: Personalizando Configurações com o MultiPHP INI Editor

Alterar a versão é apenas parte do trabalho. Às vezes, é necessário ajustar configurações específicas do PHP, como memory_limit, max_execution_time ou upload_max_filesize.

Como Acessar e Usar o Editor:

  1. No cPanel, em “Software”, clique em “MultiPHP INI Editor.
  2. Selecione o domínio que deseja configurar.
  3. Você terá duas opções:
    • Modo Básico: Ideal para a maioria dos usuários. Apresenta um menu interativo com as configurações mais comuns que podem ser alteradas com cliques.
    • Modo Editor: Destina-se a usuários avançados. Permite editar diretamente o conteúdo do arquivo php.ini como texto plano, oferecendo controle total.
mastersite

Verificações e Solução de Problemas

Antes de Alterar a Versão:

  • Faça um Backup Completo: Assegure-se de ter um backup recente de todos os arquivos e do banco de dados do seu site.
  • Verifique a Compatibilidade: Consulte a documentação do seu CMS (WordPress, Joomla, etc.), temas e plugins para saber quais versões de PHP são suportadas.

E se Algo Der Errado?

Se após a mudança seu site apresentar uma “tela branca da morte” ou erros de incompatibilidade:

  1. Reverta Imediatamente: Volte ao Gerenciador de MultiPHP e selecione a versão anterior do PHP.
  2. Restaure o Backup: Se a reversão não resolver, use o backup criado para restaurar o site.
  3. Habilite os Logs: Através do MultiPHP INI Editor, certifique-se de que display_errors está On e verifique os logs de erro do PHP (no cPanel) para identificar a causa raiz do problema.
  4. Busque Ajuda: Se não conseguir resolver, entre em contato com o suporte técnico da sua hospedagem e informe os erros que encontrou.

Conclusão

Alterar a versão do PHP no cPanel é um procedimento fundamental para a segurança, velocidade e estabilidade do seu site. O método via Gerenciador de MultiPHP é o mais simples e recomendado para a maioria dos casos. Para necessidades mais específicas, como configurações por diretório, o arquivo .htaccess oferece a flexibilidade necessária.

Lembre-se: a chave para uma transição suave é o preparo. Backup, verificação de compatibilidade e testes são passos que não devem ser negligenciados. Manter seu PHP atualizado não é apenas uma boa prática – é uma necessidade para administrar um site moderno, seguro e de alto desempenho.