Introdução

Ao alterar a versão do PHP pelo seletor PHP do cPanel, essa alteração normalmente passa a valer para o site, aplicações e arquivos executados dentro da conta de hospedagem.

Porém, ao acessar a conta via SSH e executar o comando:

php -v

pode acontecer de o terminal continuar exibindo uma versão diferente do PHP.

Isso ocorre porque o terminal SSH pode utilizar a versão padrão do PHP instalada no servidor, e não necessariamente a versão configurada no seletor PHP do cPanel.

Neste tutorial, vamos mostrar como configurar sua conta para utilizar no SSH a mesma versão do PHP desejada.

Quando essa configuração é necessária?

Essa configuração pode ser necessária quando você:

• Alterou a versão do PHP no cPanel, mas o SSH continua exibindo outra versão.
• Precisa executar comandos PHP diretamente pelo terminal.
• Utiliza Composer via SSH.
• Utiliza WP-CLI em uma instalação WordPress.
• Executa scripts PHP manualmente pela linha de comando.
• Precisa garantir compatibilidade entre o site e comandos executados no terminal.

Exemplo do problema

Após alterar a versão do PHP no cPanel, você acessa o SSH e executa:

php -v

O terminal pode retornar uma versão diferente da esperada, por exemplo:

PHP 7.4.33

Mesmo que no cPanel a conta esteja configurada para usar PHP 8.3 ou PHP 8.4.

Isso não significa necessariamente que o seletor PHP do cPanel não funcionou. Na maioria dos casos, apenas o terminal SSH está utilizando outro caminho para o PHP.

Requisitos

Antes de iniciar, você precisa ter:

• Acesso SSH à conta de hospedagem.
• Usuário e senha da conta cPanel.
• Saber qual versão do PHP deseja utilizar.
• A versão desejada do PHP precisa estar disponível no servidor.

Como configurar a versão do PHP no SSH

1º Passo: Acessar a conta via SSH

Acesse sua conta de hospedagem via SSH.

Exemplo:

ssh SEU_USUARIO@seudominio.com.br

Substitua:

• SEU_USUARIO pelo usuário da sua conta cPanel.
• seudominio.com.br pelo domínio da sua conta ou hostname do servidor.

2º Passo: Verificar a versão atual do PHP no SSH

Após acessar o SSH, execute:

php -v

O sistema exibirá a versão do PHP atualmente utilizada no terminal.

Exemplo:

PHP 7.4.33 (cli)

Caso essa versão seja diferente da versão desejada, siga os próximos passos.

3º Passo: Editar o arquivo .bashrc

Agora será necessário editar o arquivo .bashrc, que fica localizado na raiz da conta.

Execute:

nano ~/.bashrc

Esse arquivo é carregado quando o usuário inicia uma sessão no terminal. Nele, podemos definir atalhos e caminhos personalizados para comandos executados via SSH.

4º Passo: Adicionar o caminho da versão desejada do PHP

No final do arquivo .bashrc, adicione as linhas abaixo:

alias php='/opt/cpanel/ea-phpXX/root/usr/bin/php'
export PATH="/opt/cpanel/ea-phpXX/root/usr/bin/:$PATH"

Agora substitua XX pela versão desejada do PHP.

Exemplos:

Para utilizar PHP 7.4:

alias php='/opt/cpanel/ea-php74/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php74/root/usr/bin/:$PATH"

Para utilizar PHP 8.0:

alias php='/opt/cpanel/ea-php80/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php80/root/usr/bin/:$PATH"

Para utilizar PHP 8.1:

alias php='/opt/cpanel/ea-php81/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php81/root/usr/bin/:$PATH"

Para utilizar PHP 8.2:

alias php='/opt/cpanel/ea-php82/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php82/root/usr/bin/:$PATH"

Para utilizar PHP 8.3:

alias php='/opt/cpanel/ea-php83/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php83/root/usr/bin/:$PATH"

Para utilizar PHP 8.4:

alias php='/opt/cpanel/ea-php84/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php84/root/usr/bin/:$PATH"

5º Passo: Salvar o arquivo

Após inserir as linhas desejadas, salve o arquivo.

Se estiver utilizando o editor nano, pressione:

CTRL + X

Depois confirme com:

Y

E pressione Enter para concluir.

6º Passo: Recarregar o arquivo .bashrc

Para aplicar a alteração sem precisar sair e entrar novamente no SSH, execute:

source ~/.bashrc

Também é possível executar usando o caminho completo:

source /home/SEU_USUARIO/.bashrc

Substitua SEU_USUARIO pelo usuário da sua conta cPanel.

7º Passo: Confirmar a versão do PHP

Agora execute novamente:

php -v

O terminal deverá exibir a versão configurada no arquivo .bashrc.

Exemplo:

PHP 8.4.x (cli)

Pronto! A partir desse momento, ao executar o comando php no SSH, sua conta utilizará a versão definida manualmente.

Como verificar se o caminho do PHP existe

Caso queira confirmar se determinada versão do PHP está disponível no servidor, você pode executar o comando abaixo, alterando a versão desejada:

ls -l /opt/cpanel/ea-php84/root/usr/bin/php

Se o arquivo existir, o terminal exibirá informações sobre ele.

Caso a versão não esteja disponível, poderá aparecer uma mensagem semelhante a:

No such file or directory

Nesse caso, escolha uma versão disponível no servidor ou entre em contato com o suporte.

Tabela de referência das versões

Exemplo completo

Neste exemplo, vamos configurar o SSH para utilizar PHP 8.4.

Edite o arquivo:

nano ~/.bashrc

Adicione ao final:

alias php='/opt/cpanel/ea-php84/root/usr/bin/php'
export PATH="/opt/cpanel/ea-php84/root/usr/bin/:$PATH"

Salve o arquivo e recarregue:

source ~/.bashrc

Depois confira a versão:

php -v

Se tudo estiver correto, o terminal exibirá o PHP 8.4.

Observação sobre Composer, WP-CLI e scripts

Essa configuração é muito útil para comandos executados via terminal, como:

composer install

composer update

wp plugin update --all

php script.php

Ao ajustar o caminho do PHP no SSH, esses comandos passam a utilizar a versão configurada no .bashrc, reduzindo problemas de compatibilidade com aplicações que exigem versões específicas do PHP.

Informações importantes

• A alteração feita no .bashrc vale para o usuário da conta cPanel acessada via SSH.
• Essa alteração não muda a versão global do PHP do servidor.
• Essa alteração não altera diretamente a versão do PHP de outros usuários.
• A versão do PHP utilizada pelo site deve continuar sendo configurada pelo seletor PHP do cPanel.
• O terminal SSH pode continuar usando outra versão até que o arquivo .bashrc seja recarregado.
• Caso a versão escolhida não exista no servidor, o comando php poderá apresentar erro.
• Em alguns casos, pode ser necessário encerrar a sessão SSH e acessar novamente.

Dúvidas frequentes

Alterei o PHP no cPanel. Por que o SSH não mudou automaticamente?

Porque o seletor PHP do cPanel normalmente altera a versão utilizada pelo site e pela conta no ambiente web. Já o terminal SSH pode utilizar o PHP padrão do servidor, que fica em outro caminho.

Essa configuração altera o PHP de todos os sites da minha conta?

Não. Essa configuração afeta apenas o usuário no SSH onde o arquivo .bashrc foi alterado. Você pode ter alterado para usar PHP 8.4 e ainda assim ter sites executando PHP 7.1, por exemplo.

Posso configurar uma versão diferente da versão selecionada no cPanel?

Tecnicamente sim, desde que a versão esteja disponível no servidor. Porém, para evitar incompatibilidades, recomendamos utilizar no SSH a mesma versão configurada para o site no cPanel.

Preciso ter acesso root para fazer essa alteração?

Não. Essa alteração pode ser feita pelo próprio usuário da conta, desde que ele tenha acesso SSH habilitado.

Posso desfazer essa alteração?

Sim. Para desfazer, edite novamente o arquivo:

nano ~/.bashrc

Remova as linhas adicionadas:

alias php='/opt/cpanel/ea-phpXX/root/usr/bin/php'
export PATH="/opt/cpanel/ea-phpXX/root/usr/bin/:$PATH"

Depois salve o arquivo e execute:

source ~/.bashrc

Considerações finais

É comum que a versão do PHP exibida no SSH seja diferente da versão selecionada no cPanel, pois o terminal pode utilizar o PHP padrão do servidor.

Ao configurar o arquivo .bashrc, você define qual versão do PHP será utilizada nos comandos executados via SSH, garantindo mais compatibilidade com aplicações, Composer, WP-CLI e scripts PHP.

Ficou com alguma dúvida? Nossa equipe está à disposição nos canais de atendimento para lhe auxiliar.

Atualizado em: 27/05/2026