> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interpretadores PHP

> Mostra quais versões do PHP existem no servidor, escolhe a que os domínios novos usam, e permite instalar e remover outras versões.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Configurações de
Recursos** > **Interpretadores PHP**

![Versão do PHP do sistema, versão padrão para domínios novos e a tabela de interpretadores instalados](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-php.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=0d88390fa3602761b5740cb240afc0fc)

## As duas versões que a tela mostra no alto

| Campo | O que é |
| - | - |
| **Versão padrão do PHP do sistema operacional** | a versão que veio com o sistema. Nesta instalação, **8.4.26**. É informação, não tem escolha |
| **Versão PHP padrão para novos domínios** | qual versão um **domínio principal novo** recebe ao ser criado |

A lista da segunda traz **Padrão**, que segue a versão do sistema, e cada versão
extra instalada, com a etiqueta **Desatualizado** quando for o caso.

**Conferido:** escolher uma versão extra grava essa versão, e voltar para **Padrão**
limpa a escolha. **Vale só para domínio criado depois**: os que já existem ficam
como estão, e cada um se muda na aba **Interpretador** do domínio.

## Intérpretes instalados

A tabela lista as versões extras que o painel instalou, e nesta instalação há uma,
a **8.1.34**, marcada **Desatualizado**, com **1x** nos dois contadores de **USADO**.

| Coluna | O que faz |
| - | - |
| **S** | o estado da versão |
| **VERSÃO** | o número, com a etiqueta **Desatualizado** quando ela saiu de suporte |
| **USADO** | dois contadores: o primeiro, *"Usado pelos arquivos de configuração do PHP-FPM"*, e o segundo, com o globo, *"Usado pelos domínios"*. É o aviso de quem quebra se ela sair |
| **SELECIONAR** | se os clientes podem escolher essa versão nos domínios deles |
| **ATUALIZAÇÃO AUTOMÁTICA** | se o painel atualiza a versão sozinho |
| **REMOVER** | tira a versão do servidor |

A tela recomenda desligar a atualização automática de uma versão que você
personalizou, por exemplo com módulos instalados à mão, porque a atualização
desfaria a personalização.

> [!WARNING]
>
> **Remover uma versão em uso derruba os sites que dependem dela**
>
> A coluna **USADO** existe para isso. Antes de remover, troque a versão dos
> domínios que aparecem ali, na aba **Interpretador** de cada um.

## Chamar cada versão pela linha de comando

![Uso de linha de comando, com os nomes dos comandos e o recurso marcado Pro](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-php-cli.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=c6e3dca58e4d46677abc85c6e7242700)

A tela mostra o padrão dos nomes: `keyhelp-php74`, `keyhelp-php80`, `keyhelp-php81`,
e os serviços correspondentes como `keyhelp-php81-fpm`. Cada comando roda com a
versão do nome, no lugar do `php` do sistema.

**O comando `keyhelp-php-domain`, que escolhe a versão sozinho conforme a pasta
onde o script está, é marcado como recurso da edição profissional.**

## Intérpretes disponíveis

No fim da tela fica a lista das versões que ainda dá para instalar neste servidor.

> [!NOTE]
>
> **A lista pode aparecer vazia, e o botão Atualizar a busca**
>
> Ao abrir a tela, esta parte começa sem tabela. Numa medida, ela ficou assim até
> um clique em **Atualizar**, que trouxe as versões em cerca de um segundo; numa
> medida posterior, a tabela apareceu sozinha em menos de quatro segundos. Quem
> abre a tela e não vê lista não está diante de um erro: clique em **Atualizar**.

![Intérpretes disponíveis: seis versões, duas marcadas Desatualizado, a coluna Instalar e o botão Atualizar](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/recursos-php-disponiveis.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=d6a06115be619385cc30335905095398)

| Coluna | O que traz |
| - | - |
| **S** | o estado da versão na lista |
| **VERSÃO** | o número, com a etiqueta **Desatualizado** nas que saíram do suporte oficial do PHP |
| **INSTALAR** | a caixa que marca a versão para ser instalada |

Marque as versões desejadas e clique em **Salvar** para instalar.

**A lista traz o que ainda não está instalado.** Conferido: a 8.1.34, que aparece em
**Intérpretes instalados**, não se repete aqui.

**Nesta instalação apareceram seis versões**, e duas delas já vêm marcadas
**Desatualizado**:

| Versão | Etiqueta |
| - | - |
| 8.5.11, 8.4.26, 8.3.35 e 8.2.34 | sem etiqueta |
| 8.0.30 e 7.4.33 | **Desatualizado** |

> [!WARNING]
>
> **O painel oferece versões que já saíram de suporte**
>
> Estar na lista não quer dizer que a versão seja segura. As marcadas
> **Desatualizado** não recebem mais correção de segurança do PHP, e existem ali
> para quem tem um site antigo que ainda não roda em versão nova. Instalar uma
> delas é dívida, e a coluna **USADO**, mais acima, é o que mostra depois quantos
> domínios ficaram presos a ela.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Um site quebrou depois de uma atualização de versão** | a atualização automática trocou a versão personalizada | desligar a **ATUALIZAÇÃO AUTOMÁTICA** daquela versão e refazer a personalização |
| O cliente não acha a versão que precisa na aba do domínio | a coluna **SELECIONAR** está desmarcada para ela, ou a versão não está instalada | marcar **SELECIONAR**, ou instalar a versão |
| Criei um domínio e ele veio com a versão errada | é a **Versão PHP padrão para novos domínios** | trocar aqui, e ajustar o domínio já criado na aba **Interpretador** dele |
| A versão aparece como **Desatualizado** | ela saiu do suporte oficial do PHP | planejar a troca dos domínios que a usam, que estão contados em **USADO** |
| **Abri a tela e não aparece nenhuma versão disponível para instalar** | a lista ainda não foi buscada | clicar em **Atualizar**, e a tabela carrega |

## Ver também

* [Editar um domínio](/keyhelp-admin/editar-dominio), a aba **Interpretador**, que define a versão de cada domínio
* [PHP e PHP-FPM da conta](/keyhelp-admin/php-do-cliente), os limites e diretivas por conta de cliente


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.