blog
Painéis

PHP-FPM, CGI, suPHP ou DSO: qual handler usar em cada site

Como escolher o handler de PHP por conta sabendo o efeito em memória, em dono de arquivo e no lugar certo de escrever cada diretiva.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: CGI cria um processo novo a cada requisição e PHP-FPM mantém um pool persistente por conta; CGI roda como o usuário da conta quando suEXEC está ativo, o que é o comportamento usual em EA4 (confirme no painel), e FPM roda como o usuário do site, enquanto o mod_php (DSO) roda como o usuário do Apache.

Neste artigo
  1. O que o handler decide antes de qualquer tuning
  2. Os cinco handlers comparados por processo, dono do arquivo e diretiva
  3. Por que o 777 aparece e por que ele não é a correção
  4. Onde escrever php_value, .user.ini e php.ini em cada handler
  5. Qual handler escolher para cada tipo de site
  6. Como medir o TTFB antes e depois da troca com curl
  7. Checklist para padronizar o parque
  8. O que checar quando aparecer 500 depois da troca

O que o handler decide antes de qualquer tuning

O handler do PHP é o mecanismo que o Apache usa para executar um script. A documentação do cPanel sobre PHP Handlers no EasyApache 4 lista as opções disponíveis por versão de PHP: cgi, suphp, dso, fpm e lsapi. Trocar de uma para outra não é detalhe de servidor, muda três coisas que quem mantém parque de sites sente direto:

  1. Quanto de memória cada requisição custa, porque o processo pode ser reaproveitado (FPM, LSAPI) ou criado e destruído a cada hit (CGI, suPHP).
  2. Qual usuário do sistema vira dono do arquivo que o site cria: upload da biblioteca de mídia, cache de plugin, arquivo de log, plugin baixado pelo painel do WordPress.
  3. Onde as diretivas de PHP passam a ser escritas: .htaccess, .user.ini, php.ini da conta ou o campo do painel.

O item 3 é a fonte da maior parte das horas perdidas. php_value upload_max_filesize 64M dentro do .htaccess é uma diretiva do mod_php, ou seja, do handler dso. Fora dele, o Apache não sabe o que fazer com php_value: ou a linha é ignorada, ou o servidor devolve 500 Internal Server Error porque a diretiva é desconhecida naquele contexto. Quem não sabe disso edita o .htaccess, vê que nada muda, repete em outro site, e conclui que "o servidor não deixa".

Os cinco handlers comparados por processo, dono do arquivo e diretiva

Handler Processo Dono do arquivo criado pelo PHP Onde escrever diretiva
dso (mod_php) Dentro do processo do Apache Usuário do Apache, não o da conta php_value/php_flag no .htaccess ou vhost
cgi Novo processo por requisição Usuário da conta quando suEXEC está ativo (confirme no painel) .user.ini e php.ini da conta
suphp Novo processo por requisição, sob o dono Usuário da conta php.ini por diretório
fpm (PHP-FPM) Pool persistente por conta Usuário da conta .user.ini, php.ini, pool/painel
lsapi Processo persistente por conta Usuário da conta .user.ini, php.ini, painel

A coluna que resolve o chamado de "o FTP não apaga esse arquivo" é a do meio. Sob dso, o PHP roda com a identidade do servidor web, então todo arquivo gravado pelo site nasce pertencendo a esse usuário, e não ao login de FTP/SSH do cliente. Sob cgi com suEXEC ativo, suphp, fpm e lsapi, o script roda como o usuário da conta e o arquivo nasce com o dono certo. Se o suEXEC estiver desativado na configuração do EasyApache, o cgi volta a gravar com a identidade do servidor web: confira o estado dele no painel antes de contar com esse comportamento.

Por que o 777 aparece e por que ele não é a correção

O roteiro é sempre igual. Site em dso. O plugin de cache grava em wp-content/cache. Os arquivos ficam com dono do Apache. O cliente entra por FTP, tenta apagar, recebe "permission denied". O freelancer coloca chmod 777 na pasta para destravar, e o problema volta na semana seguinte porque o arquivo novo continua nascendo do dono errado.

777 não muda dono, muda permissão. E permissão ampla em diretório gravável por web é exatamente o que transforma um upload malicioso em execução. A correção estrutural é o handler rodar como o usuário da conta. Quando o site já está em fpm ou lsapi e ainda assim existe arquivo com dono estranho, quase sempre é resíduo de um período anterior em dso: um chown recursivo para o usuário da conta, feito uma vez, encerra o assunto.

Como explicar ao cliente a troca de handler sem jargão

"O site estava rodando num modo em que o PHP grava arquivos com a identidade do servidor, e não com a do seu usuário de FTP. Por isso o seu acesso vê o arquivo mas não consegue apagá-lo. Mudamos o modo de execução para que tudo que o site criar passe a pertencer à sua conta, e ajustamos a propriedade dos arquivos antigos. Não foi necessário liberar permissão total em nenhuma pasta."

Onde escrever php_value, .user.ini e php.ini em cada handler

Três caminhos cobrem o parque inteiro:

No .htaccess, mantenha apenas o que é do Apache: regras de reescrita, cabeçalhos, cache de estáticos, bloqueio de diretório. Se você herdou um projeto, procure resíduo antes de trocar o handler:

grep -rn "php_value\|php_flag" /home/*/public_html/.htaccess

Cada linha encontrada é uma candidata a 500 assim que o site sair de dso. A ordem importa: crie o .user.ini com o valor equivalente, troque o handler e só então comente a linha do .htaccess. Comentar antes deixa o site sem a diretiva, porque em dso o .user.ini ainda não é lido.

Ordem segura para migrar diretiva de PHPMapear diretivasgrep php_value nos .htaccessCriar .user.iniMesmos valores, .htaccess ainda ativoTrocar o handlerPiloto primeiro, site seuComentar o .htaccessSó depois da trocaValidar valorini_get e apagar o script
Comentar a linha antes da troca deixa o site sem a diretiva: em dso o .user.ini não é lido.

Qual handler escolher para cada tipo de site

Perfil Escolha Motivo
WordPress institucional, tráfego baixo, muitos sites no mesmo servidor lsapi ou fpm com pool enxuto Processo persistente sem manter um pool grande ocioso por conta
Loja WooCommerce ou site com pico previsível fpm com pool dimensionado Controle explícito de pm.max_children e tempo de vida
Legado que depende de php_value no .htaccess e ninguém pode tocar no código Migrar diretivas para .user.ini e ir para fpm/lsapi Manter dso por isso traz o problema de dono de arquivo junto
Site raramente acessado, script pontual, cron web cgi Sem processo residente consumindo memória entre acessos
Qualquer conta nova fpm ou lsapi, padrão único do parque Previsibilidade: um só lugar para escrever diretiva

suphp aparece aqui por completude histórica. Ele resolve o dono do arquivo, mas paga um processo novo por requisição, o que o torna a pior escolha em site com volume. Verifique na documentação do cPanel quais handlers a versão de PHP em uso ainda oferece antes de planejar a migração: a lista varia por versão.

Como medir o TTFB antes e depois da troca com curl

Antes de padronizar dezenas de sites, meça um. O método abaixo é um exemplo de procedimento, não uma medição nossa: os números que você vai obter são do seu servidor.

Crie um arquivo de formato para o curl:

# curl-format.txt
    time_namelookup:  %{time_namelookup}\n
       time_connect:  %{time_connect}\n
    time_appconnect:  %{time_appconnect}\n
   time_starttransfer:  %{time_starttransfer}\n
          time_total:  %{time_total}\n

Rode contra a mesma URL dinâmica, dez vezes, antes e depois da troca:

for i in $(seq 1 10); do
  curl -w "@curl-format.txt" -o /dev/null -s "https://exemplo.com.br/?nocache=$i"
done

O ?nocache=$i evita cache de página. O campo que interessa é time_starttransfer, o tempo até o primeiro byte, porque é nele que o custo de criar ou reaproveitar o processo PHP aparece. Compare a mediana das dez, não a melhor nem a pior. Se a diferença entre os dois handlers for menor que a variação entre as dez execuções do mesmo handler, o gargalo não está no modo de execução, está em consulta de banco, plugin ou integração externa, e trocar o handler não vai resolver.

Checklist para padronizar o parque

Levantar conta, versão de PHP e handler atual

Liste conta, versão de PHP e handler atual. Marque quais contas têm php_value ou php_flag em .htaccess.

Criar o .user.ini antes de mexer no .htaccess

Para cada site da lista anterior, crie .user.ini na raiz com os mesmos valores e deixe a linha do .htaccess ativa por enquanto. A validação com um script temporário que imprima ini_get('upload_max_filesize') só faz sentido depois da troca do handler: antes dela o retorno é o valor do php_value ou o global, e não diz nada sobre o .user.ini. Comente a linha do .htaccess logo após a troca, confirme o valor com o script e apague o script.

Trocar em um site piloto e testar upload, plugin e cache

De preferência um site seu, não de cliente. Rode o curl -w antes e depois. Teste upload de mídia, instalação de plugin e geração de cache.

Corrigir dono e permissão residuais do período em DSO

Se o site vinha de dso, ajuste o dono dos arquivos para o usuário da conta e deixe diretórios em 755 e arquivos em 644. Nenhum 777.

Migrar em lotes pequenos com passo de volta escrito

Troque em grupos pequenos, com janela de observação entre eles. Tenha o passo de volta escrito: qual handler era, qual .htaccess foi alterado, onde está o backup.

Deixar o padrão escrito no runbook

Uma linha no runbook da agência: "handler padrão X; diretiva de PHP vai em .user.ini; .htaccess só com regra de Apache". Isso evita que o próximo freelancer que entrar no projeto reabra o ciclo do php_value que não funciona.

O que checar quando aparecer 500 depois da troca

Três causas cobrem quase todos os casos:

Olhe o error log do domínio antes de mexer em qualquer coisa. A mensagem costuma nomear a diretiva ou a função exata, e isso economiza a rodada de tentativa e erro que normalmente termina em chmod 777.

500 depois da troca: por onde olharLer o error log do domínioA mensagem nomeia diretiva ou funçãophp_value em subdiretóriogrep recursivo nos .htaccessExtensão ausente na nova configComparar com a versão anteriormemory_limit insuficienteDiretiva antiga deixou de valerNada disso: voltar ao handler antigoPasso de volta escrito antes
Sequência de checagem para 500 após a troca. Nenhum passo envolve chmod 777.

Referências

  1. Documentação oficial (cpanel) — PHP Handlers (EasyApache 4). Consultado em 2026-10-08.
Leia também