Como Alterar a Versão do PHP no Seu Ambiente de Hospedagem (Guia Completo)

Gerenciar sua versão de PHP é uma das tarefas administrativas mais críticas para qualquer proprietário de site ou desenvolvedor. Quer você esteja atualizando para aproveitar as últimas melhorias de desempenho, fazendo downgrade para compatibilidade com aplicações legadas ou corrigindo vulnerabilidades de segurança, saber exatamente como alternar versões de PHP em diferentes ambientes de hospedagem é uma habilidade essencial. Este guia abrangente o orienta em todos os métodos disponíveis — desde a interface gráfica do cPanel até ferramentas de linha de comando em VPS Hosting e servidores dedicados.

1. Por que a Gestão de Versão PHP é Importante

PHP alimenta mais de 77% de todos os sites com uma linguagem server-side conhecida, incluindo plataformas importantes como WordPress, Joomla, Drupal e Magento. Cada lançamento principal de PHP introduz mudanças significativas:

• Ganhos de desempenho: PHP 8.x é dramaticamente mais rápido que PHP 5.x ou 7.x, graças ao compilador JIT (Just-In-Time).
• Patches de segurança: Versões mais antigas de PHP eventualmente atingem End of Life (EOL) e não recebem mais atualizações de segurança, deixando seu site exposto.
• Compatibilidade de aplicações: Alguns plugins, temas ou aplicações personalizadas mais antigas foram escritos para versões específicas de PHP e podem quebrar em lançamentos mais novos.
• Conformidade de hospedagem: Muitos provedores de hospedagem impõem requisitos mínimos de versão PHP para manter padrões de segurança do servidor.

Falhar em gerenciar sua versão PHP proativamente pode resultar em funcionalidade quebrada, brechas de segurança ou tempo de inatividade total do site. Compreender como controlar essa configuração — independentemente do seu tipo de hospedagem — é inegociável para qualquer administrador web sério.

2. Compreender Versões PHP e Compatibilidade

Antes de fazer qualquer alteração, é importante compreender o ciclo de vida do lançamento PHP e como as versões são estruturadas.

Numeração de Versão PHP

PHP segue um esquema de versionamento MAJOR.MINOR.PATCH:

Ciclo de Vida de Suporte PHP

Cada versão menor do PHP recebe:

• Suporte ativo por aproximadamente 2 anos (correções de bugs + patches de segurança)
• Suporte apenas de segurança por 1 ano adicional
• Fim de Vida (EOL) após o qual nenhum patch é lançado

Versões PHP Atualmente Suportadas (a partir de 2024–2025)

> Regra de ouro: Sempre execute a versão PHP mais alta que sua aplicação suporta oficialmente. Se seu CMS ou framework suporta PHP 8.2, não há razão para executar PHP 7.4.

3. Método 1: Alterar a Versão PHP via cPanel (MultiPHP Manager)

cPanel é o painel de controlo de alojamento mais amplamente utilizado e fornece duas ferramentas integradas para gestão de versões PHP: MultiPHP Manager (em todo o servidor ou por domínio) e MultiPHP INI Editor (para ajuste fino das definições PHP). Se está a utilizar um VPS com cPanel, ambas as ferramentas estão disponíveis para si.

Passo 1: Iniciar Sessão no cPanel

1. Abra o seu navegador e navegue até ao seu URL de login do cPanel:

https://yourdomain.com:2083 (seguro, recomendado)
https://yourdomain.com/cpanel

1. Introduza o seu nome de utilizador do cPanel e palavra-passe.
2. Clique em Iniciar Sessão.

Passo 2: Abrir MultiPHP Manager

1. No painel de controlo do cPanel, desça até à secção Software.
2. Clique em MultiPHP Manager.

> Alternativa: Algumas configurações do cPanel designam isto como Seleccionar Versão PHP, Configuração PHP, ou Selector PHP (este último é comum em alojamento partilhado baseado em CloudLinux). A interface pode diferir ligeiramente, mas o processo é o mesmo.

Passo 3: Seleccionar o Seu Domínio e Versão PHP

Na interface do MultiPHP Manager:

1. Verá uma lista de todos os domínios e subdomínios alojados na sua conta.
2. Marque a caixa de verificação junto ao domínio que deseja modificar.
3. No menu pendente Versão PHP no topo da página, seleccione a versão PHP desejada (por exemplo, PHP 8.2).
4. Clique em Aplicar.

> Importante: Se está numa conta de alojamento partilhado, as versões PHP disponíveis são determinadas pelo seu fornecedor de alojamento. Se precisar de uma versão que não está listada, contacte a equipa de suporte do seu alojador ou considere actualizar para um plano de Alojamento VPS onde tem controlo total sobre as versões PHP instaladas.

Passo 4: (Opcional) Personalizar Definições PHP via MultiPHP INI Editor

Após mudar de versão, poderá ser necessário ajustar valores de configuração PHP:

1. Regresse à secção Software no cPanel.
2. Clique em MultiPHP INI Editor.
3. Seleccione o seu domínio no menu pendente.
4. Modifique valores como:

memory_limit (por exemplo, 256M)
upload_max_filesize (por exemplo, 64M)
max_execution_time (por exemplo, 300)
post_max_size (por exemplo, 64M)


Clique em Aplicar para guardar as alterações.

Passo 5: Verificar a Alteração
Crie um ficheiro de teste para confirmar a versão PHP activa (consulte a Secção 7 para instruções completas).
4. Método 2: Alterando a Versão PHP via .htaccess (Apache)
Se o seu ambiente de hospedagem executa Apache mas não fornece um seletor PHP gráfico, você pode controlar a versão PHP diretamente através do seu .htaccess arquivo. Este método é particularmente útil em planos de Hospedagem Web Partilhada onde o acesso ao nível do servidor é restrito.
Como Funciona
Apache usa handlers para determinar como os arquivos .php são processados. Ao especificar um handler personalizado em .htaccess, você instrui o Apache a usar uma versão PHP específica para o seu site.
Passo 1: Aceder ao Seu Arquivo .htaccess
Você pode editar .htaccess via:

Gestor de Ficheiros cPanel: Navegue até public_html, encontre .htaccess, clique com o botão direito e selecione Editar.
Cliente FTP/SFTP: Conecte-se ao seu servidor e navegue até a raiz da web (geralmente public_html ou www).
Linha de comando SSH: nano /home/username/public_html/.htaccess

> Nota: .htaccess é um arquivo oculto. No seu cliente FTP, ative “Mostrar Ficheiros Ocultos.” No Gestor de Ficheiros cPanel, marque “Mostrar Ficheiros Ocultos (dotfiles)” nas configurações do canto superior direito.

Passo 2: Adicionar a Diretiva do Handler PHP

Adicione uma das seguintes linhas ao seu arquivo .htaccess, dependendo da convenção de nomenclatura do handler PHP do seu servidor:

Para PHP 8.2:

AddHandler application/x-httpd-php82 .php

Para PHP 8.1:

AddHandler application/x-httpd-php81 .php

Para PHP 7.4 (legado):

AddHandler application/x-httpd-php74 .php

Sintaxe alternativa (usada em alguns hosts):

# Using suPHP or FastCGI
Action php-cgi /cgi-bin/php82
AddHandler php-cgi .php

> Importante: O nome exato do handler (x-httpd-php82, x-httpd-php81, etc.) depende de como o seu fornecedor de hospedagem configurou PHP nos seus servidores. Se o acima não funcionar, verifique a documentação do seu host ou contacte o suporte para os nomes de handlers corretos.

Passo 3: Guardar e Testar

Guarde o arquivo .htaccess e teste o seu site. Se vir um Erro Interno do Servidor 500, o nome do handler é provavelmente incorreto — remova a linha e tente uma sintaxe alternativa.

5. Método 3: Alterar a Versão do PHP via Linha de Comando (VPS/Servidores Dedicados)

Se você gerencia seus próprios Servidores Dedicados ou um VPS com acesso root, você tem controle total sobre a instalação do PHP e a alternância de versão. Este é o método mais poderoso e flexível.

Pré-requisitos

• Acesso root ou sudo ao seu servidor
• Cliente SSH (Terminal no macOS/Linux, PuTTY ou Windows Terminal no Windows)
• Familiaridade básica com operações de linha de comando Linux

Ubuntu / Debian — Usando update-alternatives

Sistemas baseados em Ubuntu e Debian usam o sistema update-alternatives para gerenciar múltiplas versões do PHP simultaneamente.

Passo 1: Adicionar o Repositório PHP do Ondřej Surý

Este PPA fornece múltiplas versões do PHP para Ubuntu/Debian:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

Passo 2: Instalar a Versão Desejada do PHP

# Install PHP 8.2 and common extensions
sudo apt install -y php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-curl 
    php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath

# Install PHP 8.1 if needed
sudo apt install -y php8.1 php8.1-cli php8.1-fpm php8.1-mysql

Passo 3: Alternar a Versão Padrão do PHP (CLI)

# View all registered PHP alternatives
sudo update-alternatives --list php

# Switch to PHP 8.2
sudo update-alternatives --set php /usr/bin/php8.2

# Or use the interactive selector
sudo update-alternatives --config php

O seletor interativo exibirá algo como:

There are 3 choices for the alternative php (providing /usr/bin/php).

  Selection    Path             Priority   Status
------------------------------------------------------------
* 0            /usr/bin/php8.2   82        auto mode
  1            /usr/bin/php7.4   74        manual mode
  2            /usr/bin/php8.1   81        manual mode
  3            /usr/bin/php8.2   82        manual mode

Press <enter> to keep the current choice[*], or type selection number:

Digite o número correspondente à sua versão desejada e pressione Enter.

Passo 4: Alternar a Versão do PHP para Apache (mod_php)

# Disable current PHP module (e.g., PHP 8.1)
sudo a2dismod php8.1

# Enable new PHP module (e.g., PHP 8.2)
sudo a2enmod php8.2

# Restart Apache
sudo systemctl restart apache2

Passo 5: Alternar a Versão do PHP para Nginx (PHP-FPM)

Para Nginx, o PHP é tratado via PHP-FPM. Atualize seu bloco de servidor Nginx para apontar para o socket FPM correto:

# In your Nginx server block configuration
location ~ .php$ {
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

Depois reinicie o PHP-FPM e o Nginx:

sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

CentOS / RHEL / AlmaLinux / Rocky Linux — Usando SCL ou Repositório Remi

Opção A: Usando Software Collections (SCL) — CentOS 7

# Install the SCL repository
sudo yum install -y centos-release-scl

# Install PHP 7.4 via SCL
sudo yum install -y rh-php74 rh-php74-php-fpm rh-php74-php-mysqlnd

# Enable PHP 7.4 for the current session
sudo scl enable rh-php74 bash

# Verify
php --version

> Nota: As alterações do SCL são específicas da sessão. Para torná-las permanentes para um usuário, adicione source /opt/rh/rh-php74/enable a ~/.bashrc.

Opção B: Usando Repositório Remi — CentOS 7/8, AlmaLinux, Rocky Linux

# Install EPEL and Remi repositories
sudo dnf install -y epel-release
sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm  # For RHEL 8/AlmaLinux 8

# List available PHP streams
sudo dnf module list php

# Reset current PHP module
sudo dnf module reset php

# Enable PHP 8.2 stream
sudo dnf module enable php:remi-8.2

# Install PHP 8.2
sudo dnf install -y php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml php-zip

# Verify
php --version

Alternando PHP para Sites Individuais (Versão PHP por Site)

Em servidores que executam múltiplos sites, você frequentemente precisa de diferentes versões do PHP por site. A abordagem mais limpa é executar múltiplos pools PHP-FPM:

# Start PHP-FPM for multiple versions
sudo systemctl start php7.4-fpm
sudo systemctl start php8.1-fpm
sudo systemctl start php8.2-fpm

Depois configure cada host virtual Nginx para usar um socket FPM diferente:

# Site A — PHP 8.2
server {
    server_name site-a.com;
    root /var/www/site-a;
    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    }
}

# Site B — PHP 7.4 (legacy application)
server {
    server_name site-b.com;
    root /var/www/site-b;
    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    }
}

6. Método 4: Alterando a Versão PHP via php.ini

Em alguns ambientes de hospedagem, particularmente aqueles que usam manipuladores PHP CGI ou FastCGI, você pode influenciar o comportamento do PHP — e às vezes até a versão — através de um arquivo php.ini personalizado colocado no diretório raiz do seu site.

Criando um php.ini Personalizado

1. Crie um arquivo chamado php.ini no diretório raiz do seu site (public_html).
2. Adicione suas diretivas de configuração:

; Custom PHP configuration
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_vars = 3000
date.timezone = "UTC"

> Nota: Este método controla as *configurações* do PHP, não necessariamente a *versão* do PHP em si. A seleção de versão via php.ini é apenas possível em configurações de hospedagem específicas. Para controle total de versão, use cPanel, .htaccess, ou os métodos de linha de comando descritos acima.

7. Como Verificar a Sua Versão PHP Ativa

Após fazer qualquer alteração, sempre verifique se a versão PHP correta está ativa. Existem várias formas de fazer isto:

Método A: Criar uma Página de Teste phpinfo()

1. Crie um novo ficheiro denominado phpinfo.php no seu diretório raiz da web (public_html).
2. Adicione o seguinte conteúdo:

<?php
phpinfo();
?>

1. Navegue para https://yourdomain.com/phpinfo.php no seu navegador.
2. A página apresentará informações abrangentes de configuração PHP. A Versão PHP é mostrada no topo.

> Aviso de Segurança: Elimine este ficheiro imediatamente após o teste. A saída phpinfo() revela detalhes sensíveis de configuração do servidor que poderiam ajudar atacantes.

Método B: Verificar via Linha de Comando (SSH)

php --version
# or
php -v

Saída esperada:

PHP 8.2.10 (cli) (built: Sep  5 2023 08:12:49) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.10, Copyright (c), by Zend Technologies

Método C: Verificar via um Script PHP Simples

Para uma verificação menos detalhada, utilize este script mínimo em vez do completo phpinfo():

<?php
echo 'PHP Version: ' . PHP_VERSION;
echo '<br>PHP Major Version: ' . PHP_MAJOR_VERSION;
echo '<br>PHP Minor Version: ' . PHP_MINOR_VERSION;
?>

Método D: Verificar via WordPress Admin (para Sites WordPress)

No seu painel WordPress:

1. Vá para Ferramentas → Saúde do Site.
2. Clique no separador Informações.
3. Expanda a secção Servidor.
4. Procure por Versão PHP.

8. Erros Comuns Após Mudar de Versão PHP

Mudar de versão PHP pode às vezes causar problemas. Aqui estão os problemas mais comuns e como resolvê-los:

Erro 1: White Screen of Death (WSOD) ou Página em Branco

Causa: Um plugin, tema ou código personalizado usa sintaxe ou funções incompatíveis com a nova versão PHP.

Solução:

• Ative o modo de depuração do WordPress adicionando a wp-config.php:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);

• Verifique /wp-content/debug.log para mensagens de erro específicas.
• Desative todos os plugins e mude para um tema padrão para isolar o problema.

Erro 2: Erro 500 Internal Server Error

Causa: Frequentemente causado por um manipulador PHP incorreto em .htaccess, ou uma extensão PHP que não está instalada para a nova versão.

Solução:

• Remova ou corrija a diretiva AddHandler em .htaccess.
• Verifique o registo de erros do seu servidor: tail -f /var/log/apache2/error.log ou tail -f /var/log/nginx/error.log.
• Certifique-se de que as extensões PHP necessárias estão instaladas para a nova versão.

Erro 3: “Call to undefined function” ou “Class not found”

Causa: Uma extensão PHP necessária pela sua aplicação (por exemplo, php-gd, php-mbstring, php-xml) não está instalada para a nova versão PHP.

Solução:

# Ubuntu/Debian — install missing extensions for PHP 8.2
sudo apt install php8.2-gd php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip

# Restart web server
sudo systemctl restart apache2  # or nginx

Erro 4: Avisos de Função Descontinuada

Causa: O seu código usa funções que foram descontinuadas em versões PHP mais antigas e removidas em versões mais recentes (por exemplo, funções mysql_* removidas em PHP 7.0).

Solução:

• Atualize o seu código ou plugins para usar equivalentes modernos (por exemplo, mysqli_* ou PDO).
• Se as alterações de código imediatas não forem possíveis, considere manter-se numa versão PHP compatível temporariamente enquanto planeia a atualização.

Erro 5: Versão PHP Não Muda Apesar de Seguir os Passos

Causa: Múltiplas configurações PHP podem estar em vigor (por exemplo, CLI vs. servidor web), ou a cache está a servir respostas antigas.

Solução:

• Limpe a cache do seu navegador e qualquer cache do lado do servidor (OPcache, Redis, Varnish).
• Reinicie o seu servidor web: sudo systemctl restart apache2 ou sudo systemctl restart nginx.
• Confirme que está a editar o ficheiro .htaccess ou ficheiro de configuração correto para o domínio correto.

9. Melhores Práticas para Gestão de Versões PHP

Siga estas diretrizes para manter um ambiente PHP saudável, seguro e performante:

1. Sempre Teste em um Ambiente de Staging Primeiro

Nunca mude versões PHP diretamente em um site de produção ao vivo. Configure um ambiente de staging — seja um subdomínio ou um servidor separado — e teste sua aplicação completamente antes de aplicar alterações à produção.

2. Mantenha PHP Atualizado

Subscreva os anúncios de segurança oficiais do PHP e planeie atualizações antes que sua versão atual atinja o Fim de Vida. Executar versões PHP EOL é uma das causas mais comuns de comprometimento de websites.

3. Audite Seus Plugins e Dependências Antes de Atualizar

Antes de atualizar PHP, verifique a compatibilidade de:

• Todos os plugins e temas CMS instalados
• Dependências do Composer (composer.json)
• Código de aplicação personalizado

Use ferramentas como PHPCompatibility (um conjunto de regras PHP_CodeSniffer) para verificar seu código-fonte em busca de problemas de compatibilidade.

4. Mantenha Extensões PHP Sincronizadas

Ao mudar versões PHP, sempre reinstale todas as extensões necessárias para a nova versão. Uma extensão ausente é a causa mais comum de erros pós-atualização.

5. Use Controle de Versão para Ficheiros de Configuração

Armazene seus .htaccess, php.ini e ficheiros de configuração do servidor num repositório Git. Isto torna fácil reverter alterações se algo correr mal.

6. Monitorize Após Mudar

Após mudar versões PHP, monitorize:

• Registos de erro da aplicação
• Registos de erro do servidor (/var/log/apache2/error.log, /var/log/nginx/error.log)
• Métricas de desempenho da aplicação
• Alertas de monitorização de disponibilidade

7. Escolha o Alojamento Certo para Flexibilidade PHP

Se se encontra constantemente limitado pelas opções PHP do seu ambiente de alojamento, pode ser altura de atualizar. Os planos de Alojamento Web Partilhado oferecem um conjunto curado de versões PHP geridas pelo fornecedor, enquanto o Alojamento VPS lhe dá liberdade total para instalar, configurar e mudar qualquer versão PHP a qualquer momento. Para controlo e desempenho de nível empresarial, os Servidores Dedicados proporcionam a flexibilidade máxima.

10. Conclusão

Alterar sua versão PHP é uma tarefa fundamental de gerenciamento de hospedagem que impacta diretamente a segurança, desempenho e compatibilidade do seu site. Quer você esteja usando o MultiPHP Manager do cPanel, editando diretivas .htaccess, ou gerenciando instalações PHP via linha de comando em um VPS ou servidor dedicado, os princípios-chave permanecem os mesmos: teste antes de implantar, verifique após alterar e sempre mantenha sua versão PHP dentro do ciclo de vida suportado ativamente.

Aqui está um resumo rápido dos métodos abordados:

Se você está procurando um ambiente de hospedagem que torne o gerenciamento de versão PHP direto e lhe dê o controle que você precisa, explore os planos de Hospedagem VPS da AlexHost — com acesso root completo, múltiplas distribuições Linux e a flexibilidade para executar qualquer versão PHP que suas aplicações exijam. Você também pode explorar nossa gama de Painéis de Controle VPS para encontrar a interface de gerenciamento que melhor se adequa ao seu fluxo de trabalho.

Mantenha-se proativo com suas atualizações PHP, e seus sites permanecerão rápidos, seguros e compatíveis por muitos anos.