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

Introdução

• Útil para configurar um script específico ou uma sessão PHP na linha de comando (CLI).
• Para alterar a versão PHP do servidor web (FPM/Apache) através do painel de controle, consulte este outro guia.

Versão padrão do PHP CLI

O comando php utiliza a versão padrão do servidor. Verifique a versão ativa com este comando:

# Check current PHP version
php -v

Para garantir a estabilidade dos seus scripts, utilize um caminho explícito (ex: php8.2) ou modifique a sua variável PATH.

Modificar a versão do PHP na linha de comandos

É possível configurar a versão do PHP que será carregada automaticamente na sua sessão SSH através de dois ficheiros principais.

1. Utilização do .bashrc (Recomendado)

O arquivo ~/.bashrc é lido quando um shell interativo é aberto.

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

   touch ~/.bashrc
   nano ~/.bashrc

2. Adicione esta linha para definir a versão desejada (exemplo com PHP 8.3):

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

3. Atualize a configuração:

   source ~/.bashrc

4. Verifique a alteração:

   php -v
   which php

2. Utilização do arquivo .profile (Alternativa)

O ficheiro ~/.profile é lido durante uma ligação SSH (modo de início de sessão).

1. Edite o ficheiro:

   nano ~/.profile

2. Adicione a linha de exportação:

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

3. Carregar o arquivo .bashrc automaticamente

Para aplicar a configuração a todos os tipos de sessão, adicione este código nos seus ficheiros ~/.bash_profile ou ~/.profile:

# Load .bashrc if it exists
if [ -f ~/.bashrc ]; then . ~/.bashrc; fi

Executar uma versão específica pontualmente

Para executar um script com uma versão específica sem alterar o seu ambiente global, chame diretamente o executável:

# Execute with a specific version
/opt/php8.2/bin/php my_script.php
/opt/php8.3/bin/php -v

Após concluir estas etapas, as suas sessões SSH e os seus scripts de linha de comando usarão a versão de PHP selecionada por padrão.