Atualizou o PHP no servidor, mas localmente o projeto regride para uma versão de há cinco anos e metade do código dispara avisos de deprecated. Ou o oposto: um cliente envia-lhe um site em PHP 7.4, mas o seu Laragon só corre o mais recente 8.5.

O Laragon consegue manter várias versões de PHP em simultâneo e alternar entre elas com alguns cliques. Sem ginástica de PATH, sem conflitos e sem instalação separada de um segundo servidor web. A seguir cobrimos ambos os métodos: o manual, que funciona em qualquer versão do Laragon, e o Quick Add automático para a versão 8 e mais recentes.

💡 Resumo rápido:

• Descarregue o ZIP da versão de PHP necessária em windows.php.net, o arquivo marcado Win32-vs16-x64 para Apache
• Extraia o arquivo para C:\laragon\bin\php, o nome da pasta torna-se o nome da versão no menu
• Alterne versões na bandeja: clique com o botão direito no ícone, PHP, versão necessária, reiniciar
• Para o Laragon 8+ abra Ferramentas, Quick Add, PHP, e o programa descarrega e regista a versão necessária sozinho

Passo 1: Descarregar a versão de PHP necessária

As builds oficiais de PHP para Windows estão alojadas em windows.php.net. As versões atuais (8.2-8.5) estão na página principal. Se o projeto precisar de PHP 7.4, 8.0 ou 8.1, estão no arquivo.

Ao escolher um arquivo, preste atenção a dois parâmetros:

• Thread Safe (TS) ou Non-Thread Safe (NTS). Se o PHP correr como módulo do Apache, escolha TS. Para Nginx, o servidor PHP integrado ou execução a partir da linha de comandos, NTS. O Laragon usa o Apache por defeito, por isso na maioria dos casos Win32-vs16-x64 funcionará (ou vs17 para PHP 8.4+).

• Arquitetura. x64 para Windows de 64 bits, x86 para 32 bits. Em 2026, x64 está praticamente em todo o lado.

Exemplo de nome de ficheiro para PHP 8.3: php-8.3.31-Win32-vs16-x64.zip. Para PHP 8.4 e 8.5 o compilador mudou, procure vs17 em vez de vs16.

Passo 2: Extrair o arquivo para a pasta do Laragon

Extraia o ZIP para C:\laragon\bin\php\. Após a extração terá uma pasta com o número da versão, por exemplo, php-8.3.31-Win32-vs16-x64. O Laragon lê o nome da pasta e mostra-o no menu como uma versão disponível.

Não renomeie a pasta. Se já existir uma subpasta dentro do ZIP, use-a, não a raiz do arquivo. A estrutura após a extração deve ficar assim:

1
C:\laragon\bin\php\
2
  php-8.3.31-Win32-vs16-x64\
3
    php.exe
4
    php.ini-development
5
    ext\
6
    ...
7
  php-8.5.7-Win32-vs17-x64\
8
    ...

Passo 3: Alternar versões na bandeja

Clique com o botão direito no ícone do Laragon na bandeja do sistema, passe o rato sobre PHP e selecione a versão que acabou de adicionar. O Laragon reiniciará o Apache com a nova versão, o que demora 2 a 3 segundos.

Verifique se a troca funcionou: abra o Terminal no Laragon (ou qualquer terminal onde o caminho para php.exe de C:\laragon\bin\php\ esteja definido) e execute:

1
php -v

Na saída verá o número da versão, a data de compilação e o tipo (TS/NTS). Se o número não tiver mudado, verifique se selecionou a versão no menu e reiniciou o Laragon.

Passo 4: Método rápido via Quick Add (Laragon 8+)

A partir do Laragon 8, surgiu o Quick Add, um mecanismo integrado que descarrega, extrai e regista novas versões de PHP sozinho. Sem descarregamentos manuais do site nem cópia de pastas.

Abra o menu do Laragon na bandeja: Ferramentas → Quick Add → PHP. Aparece uma lista de versões disponíveis, desde a 7.4 até à 8.5. Selecione a que precisa e o Laragon trata do resto. Num minuto a versão aparecerá no menu PHP e estará pronta a usar.

Este método é preferível: exclui erros na escolha de TS/NTS e arquitetura. O Quick Add determina sozinho a variante adequada para o seu sistema.

Processo visual: vídeo

Um vídeo curto onde todo o processo é mostrado do início ao fim, desde o descarregamento do PHP até à troca de versões em tempo real:

⁉️🤔 Perguntas frequentes

Qual é a diferença entre NTS e TS, que versão devo descarregar?

Para o Laragon com Apache, escolha Thread Safe (TS, no nome do ficheiro sem nts). O Apache carrega o PHP como módulo e a build TS garante segurança de threads com pedidos paralelos. Non-Thread Safe (NTS) é necessário se usar Nginx ou executar PHP a partir da linha de comandos. Na prática com o Laragon, descarregue Win32-vs16-x64 para PHP 8.0-8.3 e Win32-vs17-x64 para PHP 8.4+.

Posso manter PHP 7.4, 8.2 e 8.5 no Laragon em simultâneo?

Sim, é exatamente para isso que serve o multi-versioning. Dezenas de versões podem estar na pasta C:\laragon\bin\php\, não há conflitos entre elas porque o Apache usa apenas uma de cada vez. Projetos em versões diferentes não interferem uns com os outros se não os executar simultaneamente sob o mesmo servidor web.

Adicionei uma versão mas ela não aparece no menu PHP. O que está errado?

Primeiro: verifique se o php.exe está dentro da pasta da versão (e não noutra subpasta). Segundo: reinicie completamente o Laragon, Pare e depois Iniciar Tudo. Terceiro: o nome da pasta deve ser diferente dos existentes, se já tem php-8.3.31, não crie uma segunda idêntica. E quarto: o Quick Add regista a versão sozinho, se descarregou manualmente e depois com o mesmo número via Quick Add, a pasta antiga será sobrescrita.

O que fazer se depois de mudar a versão do PHP o projeto ainda vê a antiga?

Abra o Terminal no Laragon (clique com o botão direito no ícone → Terminal) e execute php -v, ele mostrará a versão que a consola vê. Se estiver correta mas o site mostrar outra, limpe a cache do navegador e verifique se o php.ini está em cache com um valor diferente. Por vezes, uma paragem e reinício completos do Apache ajudam.

Preciso de reiniciar o computador depois de adicionar uma versão?

Não. O Laragon apenas reinicia o Apache, o que demora 2 a 3 segundos. O reboot do Windows pode ser necessário apenas num caso: se adicionou manualmente o caminho para php.exe ao PATH do sistema e o Windows guardou em cache o caminho antigo. Mas com o uso normal do Laragon isso não é necessário.

Vale a pena atualizar o Laragon para o multi-versioning?

Se ainda está no Laragon 6 ou 7, atualizar para a versão 8.6 oferece mais do que apenas o Quick Add. O pacote inclui PHP 8.1-8.5 de raiz, Apache 2.4.66, MySQL 9.6 e atualizações automáticas de componentes através do menu. Migrar do WAMP ou XAMPP também é simples: as instruções oficiais descrevem a migração em 5 minutos.

Para projetos vinculados a uma versão específica de PHP, o multi-versioning do Laragon é um dos principais argumentos a seu favor. Alternou, verificou, voltou atrás e nenhum site se partiu.

Comece com o Quick Add: abra Ferramentas → Quick Add → PHP e instale a versão em falta num minuto. E se tem um truque comprovado para trabalhar com versões de PHP no Laragon, partilhe nos comentários.