Este guia explica como modificar a versão do PHP utilizada na linha de comando (PHP CLI) num serviço de alojamento web Infomaniak.

Introdução

• Esta configuração permite escolher a versão do PHP utilizada pelos scripts executados na linha de comando via SSH.
• Para modificar a versão do PHP utilizada pelos sites (FPM/Apache) a partir do painel de controlo, consulte este outro guia.
• Em 21 de outubro de 2026, a equipe PHP lançou novas versões corrigindo duas vulnerabilidades críticas (❓: ajuda):
  • As correções de segurança fornecidas pelas equipes PHP foram implementadas com sucesso em toda a infraestrutura compartilhada e Servidores Cloud, para as versões PHP 8.5, 8.4, 8.3, 8.2, 8.1, 8.0 e 7.4.
  • Os números das versões PHP permanecem inalterados, mas as correções de segurança foram aplicadas em todos os serviços afetados.

Verificar a versão do PHP utilizada na linha de comando

O comando php utiliza o primeiro executável PHP encontrado na variável de ambiente PATH. Para saber a versão utilizada e a sua localização, execute:

php -v
which php

O número exibido corresponde à versão do executável utilizado na linha de comandos. Não corresponde necessariamente à versão configurada para os sites.

Verificar a data de compilação e as correções de segurança

Para exibir a data de compilação do binário PHP utilizado, execute:

php -i | grep "Build Date"

Se estiver a utilizar um caminho explícito para uma versão do PHP, também pode verificar a data de compilação:

/opt/php8.3/bin/php -i | grep "Build Date"

Algumas correções de segurança podem ser integradas pela Infomaniak num binário PHP recompilado, sem modificação do número de versão exibido. Uma versão aparentemente mais antiga do que a última versão publicada oficialmente (❓: ajuda) não significa necessariamente que as correções estejam ausentes.

Alterar a versão do PHP na linha de comando

Pode escolher a versão do PHP que é carregada por defeito nas suas sessões SSH, alterando a variável de ambiente PATH.

1. Modificar o ficheiro .bashrc (recomendado)

O ficheiro ~/.bashrc contém a configuração das sessões Bash interativas.

1. Abra o arquivo ou crie-o, caso não exista:

   nano ~/.bashrc

2. Adicione a seguinte linha para usar o PHP 8.3, por exemplo:

   export PATH="/opt/php8.3/bin:$PATH"

3. Recarregue a configuração:

   source ~/.bashrc

4. Verifique a versão e o caminho utilizados:

   php -v
   which php

2. Carregar o arquivo .bashrc ao estabelecer uma conexão SSH (se necessário)

Se a sua sessão SSH não carregar automaticamente o arquivo ~/.bashrc, adicione o seguinte código ao arquivo de configuração usado pelo seu shell, por exemplo, ~/.bash_profile ou ~/.profile:

if [ -f ~/.bashrc ]; then
    . ~/.bashrc
fi

Executar uma versão específica pontualmente

Para executar um script com uma versão específica sem modificar a configuração padrão, indique diretamente o caminho do binário:

/opt/php8.2/bin/php my_script.php
/opt/php8.3/bin/php -v

A versão selecionada em PATH será utilizada por padrão nas sessões que carregarem esta configuração. Você sempre poderá executar outra versão, indicando seu caminho completo.