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.

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
- O que o handler decide antes de qualquer tuning
- Os cinco handlers comparados por processo, dono do arquivo e diretiva
- Por que o 777 aparece e por que ele não é a correção
- Onde escrever php_value, .user.ini e php.ini em cada handler
- Qual handler escolher para cada tipo de site
- Como medir o TTFB antes e depois da troca com curl
- Checklist para padronizar o parque
- 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:
- 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).
- 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.
- Onde as diretivas de PHP passam a ser escritas:
.htaccess,.user.ini,php.inida 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:
.user.ini: arquivo de texto no diretório do site, lido pelo PHP em qualquer modo em que ele roda como CGI/FastCGI, o que incluicgi,fpmelsapi. Emdsoele não é lido. Só aceita diretivas de nívelPHP_INI_USERePHP_INI_PERDIR(upload_max_filesize,post_max_size,memory_limitem muitas builds). O PHP guarda o conteúdo em cache por alguns minutos, então a mudança não aparece no mesmo segundo.php.inida conta: o lugar de ajuste amplo quando o painel expõe um por conta.- Campo do painel (MultiPHP INI Editor ou equivalente): o mais seguro para padronizar, porque grava no arquivo certo para o handler em uso sem você precisar lembrar qual é.
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.
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:
php_value/php_flagesquecido no.htaccessde um subdiretório. Ogreprecursivo da seção anterior pega.- Extensão de PHP presente na versão antiga e ausente na nova configuração do handler.
memory_limitmenor do que o site exigia, agora que a diretiva do.htaccessdeixou de valer.
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.
Referências
- Documentação oficial (cpanel) — PHP Handlers (EasyApache 4). Consultado em 2026-10-08.