Pular para o conteúdo
Documentação

PHP: versões, módulos e php.ini

Como instalar e atualizar versões do PHP, gerenciar módulos, editar o php.ini e aplicar a segurança padrão do PHP.

R Regis Manze 20/11/2026 5 min de leitura

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

  1. Clique em Instalar Nova Versao.
  2. Escolha a Versao. A lista mostra só as versões disponíveis no repositório e ainda não instaladas.
  3. Marque os Modulos Adicionais. Já vêm marcados: curl, mbstring, mysql, gd, xml, zip, intl, opcache e bcmath.
  4. 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.

  1. Clique em Verificar atualizacoes para consultar o repositório.
  2. Para uma versão, clique em Atualizar no cartão dela. Para todas, clique em Atualizar todas.
  3. Revise a lista de pacotes e clique em Atualizar agora.

O que acontece na atualização:

  • O php.ini e 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).

  1. Clique em php.ini (FPM) ou php.ini (CLI).
  2. 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.
  3. 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 .bak na 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_filesize e post_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.

  1. Clique em Detalhes para ver a tabela.
  2. Marque ou desmarque cada diretiva na coluna Ativa.
  3. 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.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!