A tela PHP reúne tudo sobre as versões de PHP do servidor: instalação, atualização, módulos, php.ini e diretivas de segurança. Acesse em Runtime & Performance → PHP.
Cada versão instalada aparece em um cartão, com a situação do FPM, os módulos, os domínios que usam a versão e os pools FPM existentes.
Instalar uma nova versão
- Clique em Instalar Nova Versao.
- Escolha a Versao. A lista mostra só as versões disponíveis no repositório e ainda não instaladas.
- Marque os Modulos Adicionais. Já vêm marcados: curl, mbstring, mysql, gd, xml, zip, intl, opcache e bcmath.
- Clique em Instalar.
FPM, CLI e common são instalados sempre. A instalação pode levar alguns minutos.
A versão nova já entra no ar com os valores padrão de OPcache definidos pelo painel e com as diretivas de segurança (veja abaixo).
Dica: se a lista de versões estiver vazia, ou todas já estão instaladas, ou o repositório de pacotes PHP (Sury) não está configurado. O Setup inicial configura esse repositório.
Atualizar o PHP
O painel atualiza o PHP dentro da mesma série. Por exemplo, de 8.3.30 para 8.3.33. Ele não troca de série (8.3 para 8.4) e não instala módulos novos.
- Clique em Verificar atualizacoes para consultar o repositório.
- Para uma versão, clique em Atualizar no cartão dela. Para todas, clique em Atualizar todas.
- Revise a lista de pacotes e clique em Atualizar agora.
O que acontece na atualização:
- O
php.inie os pools que você editou são mantidos. - Ao final, o painel testa a configuração do FPM e reinicia o serviço. As requisições em andamento podem cair por cerca de 1 segundo.
- Se o teste falhar, o FPM não é reiniciado.
Trocar a versão de um site
A versão de PHP de cada site é escolhida no domínio, no menu Dominios. O cartão da versão em PHP mostra quantos domínios a usam.
Módulos (extensões)
Em cada cartão:
- Instalar Modulos: marque os módulos que faltam e clique em Instalar Selecionados.
- Remover Modulos: marque os módulos e clique em Remover Selecionados. Os módulos fpm, cli e common não podem ser removidos por aqui.
Módulos disponíveis para instalar pelo painel:
bcmath, bz2, curl, gd, gmp, igbinary, imagick, imap, intl, mbstring, mysql, opcache, pgsql, pspell, readline, redis, soap, sqlite3, xml, xmlrpc, zip, ldap, tidy, xdebug, memcached, apcu, mcrypt.
Atenção: nem todo módulo existe para todas as versões do PHP. Se a instalação falhar, confira se o pacote existe para a versão escolhida.
Editar o php.ini
Cada versão tem dois arquivos: o do FPM (usado pelos sites) e o do CLI (usado por cron, Composer e comandos de terminal).
- Clique em php.ini (FPM) ou php.ini (CLI).
- Use os Atalhos para pular direto a diretivas comuns:
memory_limit,upload_max_filesize,post_max_size,max_execution_time,max_input_time,display_errors,error_reporting,date.timezone. Ou use a busca. - Edite e clique em Salvar & Reiniciar FPM.
Proteções ao salvar o php.ini do FPM:
- O painel guarda uma cópia do arquivo anterior com final
.bakna mesma pasta. - Testa a configuração antes de reiniciar. Se o teste falhar, o arquivo volta ao anterior e o erro aparece na tela.
- Se o FPM não subir depois do reinício, o arquivo também é revertido.
Dica: limites de upload (
upload_max_filesizeepost_max_size) para todas as versões ficam mais fáceis de manter em Configuracoes → Tuning. Limites por site ficam no pool do usuário, em Tuning.
Botões do cartão
| Botão | Ação |
|---|---|
| Atualizar | Atualiza a versão dentro da mesma série. |
| Restart FPM | Reinicia o PHP-FPM da versão. |
| php.ini (FPM) / php.ini (CLI) | Abre o editor do arquivo. |
| Desinstalar | Remove todos os pacotes da versão. |
Atenção: Desinstalar remove todos os pacotes
phpX.Y-*. Antes, mude para outra versão os domínios que usam a versão a ser removida.
Segurança do PHP
O bloco Seguranca do PHP aplica um conjunto de diretivas de proteção em todas as versões, no FPM e no CLI. O cabeçalho mostra se está tudo aplicado ou quantas pendências existem.
- Clique em Detalhes para ver a tabela.
- Marque ou desmarque cada diretiva na coluna Ativa.
- Clique em Salvar e aplicar.
| Diretiva | Valor | Motivo |
|---|---|---|
session.upload_progress.enabled |
Off | Evita gravar na sessão dados controlados pelo visitante. |
expose_php |
Off | Esconde a versão do PHP nos cabeçalhos. |
allow_url_include |
Off | Impede incluir arquivos de URLs remotas. |
session.use_strict_mode |
1 | Recusa IDs de sessão não gerados pelo servidor. |
session.use_only_cookies |
1 | ID de sessão só por cookie, nunca pela URL. |
session.cookie_httponly |
1 | Cookie de sessão fora do alcance de JavaScript. |
mail.add_x_header |
Off | Não expõe o caminho do script nos e-mails. |
display_errors (só FPM) |
Off | Erros não aparecem no navegador. |
display_startup_errors (só FPM) |
Off | Idem para erros de inicialização. |
log_errors (só FPM) |
On | Erros continuam indo para o log. |
A coluna Efetivo agora mostra o valor real em cada versão. Se um pool sobrescreve uma diretiva, a tela avisa em quais pools.
Ficam fora da lista de propósito, porque quebram lojas e sistemas comuns: disable_functions, allow_url_fopen e session.cookie_samesite. Para liberar algo em um único site, use php_admin_value no pool desse site.
As diretivas são reaplicadas ao iniciar o painel e ao instalar uma nova versão.