> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.fabweb.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como usar no SSH a mesma versão do PHP selecionada no cPanel

# 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
| Versão desejada | Código usado no caminho |
| ---- |
| PHP 7.4 | `ea-php74` |
| PHP 8.0 | `ea-php80` |
| PHP 8.1 | `ea-php81` |
| PHP 8.2 | `ea-php82` |
| PHP 8.3 | `ea-php83` |
| PHP 8.4 | `ea-php84` |

# 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.