# 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.

> 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.

João Rizzon · 2026-11-05 · Painéis

---

## 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](https://docs.cpanel.net/ea4/php/php-handlers/) 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.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:

- **`.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 inclui `cgi`, `fpm` e `lsapi`. Em `dso` ele não é lido. Só aceita diretivas de nível `PHP_INI_USER` e `PHP_INI_PERDIR` (`upload_max_filesize`, `post_max_size`, `memory_limit` em 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.ini` da 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:

```bash
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](https://docs.cpanel.net/ea4/php/php-handlers/) 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:

```bash
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_flag` esquecido no `.htaccess` de um subdiretório. O `grep` recursivo da seção anterior pega.
- Extensão de PHP presente na versão antiga e ausente na nova configuração do handler.
- `memory_limit` menor do que o site exigia, agora que a diretiva do `.htaccess` deixou 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`.

