# Desabilitar exec e shell_exec no PHP sem quebrar o site

Um processo de levantamento por grep, decisão função a função e conferência no phpinfo, com a reversão escrita antes de aplicar.

> faça o levantamento antes. Rode um grep nas 7 funções de execução de comando (exec, shell_exec, system, passthru, popen, proc_open, pcntl_exec) dentro do wp-content e do código legado, monte a lista de disable_functions a partir do que achou e confirme o Local Value no phpinfo.

João Rizzon · 2026-10-21 · Painéis

---

## As sete funções de execução de comando e o que cada uma faz

A família de execução de comandos do PHP tem sete funções que importam no dia a dia de quem mantém sites de clientes. A documentação do cPanel sobre segurança em PHP ([PHP Security Concepts](https://docs.cpanel.net/knowledge-base/security/php-security-concepts/)) trata `disable_functions` como a diretiva usada para bloquear funções perigosas por instalação de PHP.

| Função | O que faz | Exemplo conhecido de uso legítimo |
|---|---|---||
| `exec` | Roda comando e devolve a última linha | Plugins que chamam `convert` ou `cwebp` |
| `shell_exec` | Roda comando e devolve a saída inteira | Scripts de backup chamando `mysqldump` |
| `system` | Roda comando e imprime a saída | Ferramentas antigas de importação |
| `passthru` | Igual ao system, mas com saída binária crua | Geração de PDF/imagem por binário externo |
| `popen` | Abre um processo como stream | Leitura progressiva de saída de comando |
| `proc_open` | Abre processo com controle de stdin/stdout/stderr | Bibliotecas que encapsulam binários (Symfony Process) |
| `pcntl_exec` | Substitui o processo atual por outro | Workers de fila em sistemas legados |

São sete do título ao checklist. Não existe lista canônica: cada ambiente é um conjunto diferente de plugins e de código legado, e é exatamente por isso que copiar a lista de um fórum é a forma mais rápida de derrubar o site de um cliente numa sexta à noite.

## Como descobrir quem chama o quê antes de bloquear

Antes de escrever qualquer diretiva, descubra quem chama o quê. O levantamento leva minutos por site e vale por todo o resto do processo.

### Varra o código do site com um grep só

```bash
cd ~/public_html
grep -rn -E '\b(exec|shell_exec|system|passthru|popen|proc_open|pcntl_exec)\s*\(' \
  --include='*.php' wp-content/ 2>/dev/null
```

Se o site não for WordPress, troque `wp-content/` por `.` e aceite um resultado mais sujo.

### Como separar ruído de chamada direta no resultado do grep

O grep vai trazer três tipos de linha, e só um deles é problema:

- **Definição ou checagem**: `if (function_exists('exec'))` ou `in_array('shell_exec', explode(',', ini_get('disable_functions')))`. Isso é código defensivo. Se a função some, ele cai no caminho alternativo sozinho.
- **Comentário ou string**: aparece em arquivo de tradução, em README, em painel de diagnóstico. Ignorável.
- **Chamada direta**: `exec($cmd, $out, $ret);` sem guarda nenhuma. É aqui que mora a quebra.

### O que anotar na planilha quando são dez ou mais sites

Uma linha por site, colunas: domínio, função encontrada, arquivo, plugin, se tem `function_exists` em volta. Com dez ou quinze sites o padrão aparece sozinho: quase sempre é o mesmo punhado de plugins de imagem, de backup e de PDF repetido em todo lugar.

### Por que o CLI mente sobre o que vale no site

```bash
php -r "foreach(['exec','shell_exec','system','passthru','popen','proc_open','pcntl_exec'] as \$f) echo \$f.': '.(function_exists(\$f)?'ativa':'bloqueada').PHP_EOL;"
```

O CLI pode ter configuração diferente do PHP que serve o site. Use esse comando para ter noção, e o `phpinfo()` (adiante) para o valor que realmente vale no servidor web.

## Como decidir, função por função, o que entra na lista

Com a planilha na mão, a decisão fica mecânica. Para cada uma das sete funções:

- **Nenhuma chamada direta encontrada** em nenhum site da carteira: entra na lista de bloqueio, sem conversa.
- **Chamada só dentro de `function_exists`**: entra na lista. O código já prevê a ausência. Teste a funcionalidade correspondente depois de aplicar.
- **Chamada direta em plugin ativo e necessário**: fica de fora, ou você troca o plugin. Decisão de projeto, não de servidor.
- **Chamada direta em sistema legado que ninguém mantém**: candidato a isolar em outro domínio/conta com PHP próprio, e bloquear tudo no resto.

Na prática, a maior parte das carteiras de WordPress fecha o pacote inteiro das sete. As exceções costumam ser `proc_open` e `exec`, puxadas por processamento de imagem e por plugins de backup que chamam `mysqldump`.

O formato da diretiva é uma lista separada por vírgula, sem espaço, em uma linha:

```ini
disable_functions = exec,shell_exec,system,passthru,popen,proc_open,pcntl_exec
```

## Onde a diretiva pega de verdade: INI da versão ou pool de FPM

O problema recorrente não é escrever a diretiva, é descobrir onde ela realmente pega. A documentação do cPanel ([PHP Security Concepts](https://docs.cpanel.net/knowledge-base/security/php-security-concepts/)) trata `disable_functions` como diretiva definida por instalação de PHP: o lugar dela é o editor de INI do painel (MultiPHP INI Editor) ou a configuração do pool de PHP-FPM. Isso tem uma consequência prática que resolve metade dos casos de "apliquei e não mudou nada": `disable_functions` é `PHP_INI_SYSTEM`, não é alterável por `ini_set()` nem por `.user.ini`. Escrever a diretiva no `.user.ini` do diretório do site não surte efeito nenhum.

O que segue é prática de campo, não está na documentação citada: num ambiente com MultiPHP, confira em qual versão de PHP o domínio está antes de editar, porque o INI é por versão. Editar a INI da 8.1 e servir o site na 8.2 dá exatamente o mesmo resultado de não editar nada. E `php_value` em `.htaccess` só funciona com mod_php, não com FPM nem CGI.

### Confirme com phpinfo, não com a tela do painel

Crie um arquivo temporário na raiz do site:

```php
<?php phpinfo();
```

Abra pelo navegador e procure a linha `disable_functions`. Olhe as duas colunas: **Local Value** e **Master Value**. Master é o que veio da configuração global do PHP. Local é o que a configuração daquele domínio (INI da versão de PHP selecionada, pool de FPM) aplicou por cima. O que vale para o site é o Local.

Confira também, no topo do phpinfo, a linha `Loaded Configuration File` e a `Additional .ini files parsed`. É ali que você descobre qual arquivo foi realmente lido, em vez de supor.

Apague o `phpinfo.php` depois. Um arquivo desse exposto entrega versão de PHP, caminhos absolutos e extensões carregadas para qualquer scanner automatizado.

### Três motivos para o valor não mudar depois de aplicar

- Você escreveu em `.user.ini`. Não adianta, e o arquivo nem sequer é lido para esta diretiva: `disable_functions` é `PHP_INI_SYSTEM` e só vem da configuração da instalação de PHP (INI do painel ou pool de FPM).
- Diretiva escrita em `.htaccess` com `php_value` não funciona em PHP rodando como FPM ou CGI. Só em mod_php.
- O pool de PHP-FPM não foi recarregado. Reinicie o serviço pelo painel e reabra o phpinfo: enquanto o processo antigo continuar vivo, o Local Value continua o anterior.

## A reversão que você vai precisar às 23h

A reversão é a parte que ninguém documenta e todo mundo precisa às 23h. Deixe pronta, por escrito, no mesmo chamado em que você aplicou:

```ini
; ROLLBACK disable_functions - site exemplo.com.br
; valor anterior (copiado do phpinfo em DD/MM, Local Value):
; disable_functions =
; arquivo alterado: MultiPHP INI Editor do dominio (ou pool PHP-FPM da conta), PHP 8.x
; depois de reverter: reiniciar o PHP-FPM da conta pelo painel e reconferir no phpinfo
```

Copie o valor anterior **do phpinfo**, não da memória. Se o campo estava vazio, escreva que estava vazio.

### Que sintoma aponta para qual família de função

São exemplos conhecidos do que cada família costuma quebrar, não medição nossa. Use como mapa de suspeita:

| Sintoma relatado pelo cliente | Família provável | Onde olhar |
|---|---|---||
| Parou de gerar miniatura/thumbnail | `exec`, `proc_open` (ImageMagick via binário) | Trocar para a extensão Imagick ou GD |
| E-mail parou de sair nos plugins que chamam binário externo | `exec`, `shell_exec`, `proc_open` (plugin invocando `sendmail` ou `msmtp`) | Mudar o envio para SMTP autenticado; se nem assim sair, checar bloqueio de porta |
| Backup agendado falha sem erro claro | `shell_exec`, `exec` (`mysqldump`, `tar`) | Plugin de backup com modo PHP nativo |
| Geração de PDF retorna página em branco | `passthru`, `proc_open` (wkhtmltopdf) | Biblioteca PHP pura |
| Fila/worker travado em loja | `pcntl_exec` | Cron real no painel no lugar do worker |

Repare que a solução quase nunca é reabrir a função: é trocar o método. O envio por SMTP, por exemplo, resolve o e-mail e ainda melhora entregabilidade. Vale a pena fazer esse caminho antes de liberar `proc_open` de volta. O `mail()` nativo do PHP não entra nessa conta: ele invoca o sendmail internamente, sem passar pelas sete funções, e continua funcionando com todas bloqueadas.

## Como padronizar a carteira sem virar trabalho manual

Três decisões que economizam tempo quando são dez, vinte ou cinquenta sites:

- **Um perfil só, com exceções nomeadas.** Defina as sete como padrão da carteira e mantenha uma lista curta de domínios que ficam fora, com o motivo escrito ao lado. Exceção sem motivo documentado volta a ser regra em seis meses.
- **Grep na entrada, não só na auditoria.** Rode o grep de levantamento toda vez que um cliente pedir um plugin novo, antes de instalar. Cinco segundos agora, zero chamado depois.
- **Phpinfo temporário com nome aleatório.** Em vez de `phpinfo.php`, use algo como `zz-check-7f3a.php` e apague no mesmo acesso. Reduz chance de ficar esquecido e indexado.
- **Registre a data da conferência.** A diretiva pode ser sobrescrita numa migração de servidor ou numa mudança de versão de PHP. Reconferir pelo phpinfo depois de qualquer troca de versão é item de checklist, não zelo exagerado.

## Checklist das sete funções, do grep ao teste final

- `grep -rn` nas sete funções em `wp-content/` e no código legado de cada site.
- Classificar cada ocorrência: chamada direta, dentro de `function_exists`, ou comentário.
- Montar a lista de bloqueio a partir dessa classificação, não de lista pronta.
- Copiar o valor atual de `disable_functions` do phpinfo e guardar como rollback escrito.
- Aplicar a diretiva no local que vale para o ambiente: editor de INI do painel na versão de PHP correta, ou pool de PHP-FPM. `.user.ini` não serve para esta diretiva.
- Reabrir o phpinfo e conferir **Local Value** e **Master Value**.
- Apagar o arquivo de phpinfo.
- Testar, no mínimo: upload de imagem com geração de miniatura, envio de e-mail pelo formulário e execução do backup.
- Se algo quebrar, consultar a tabela de sintomas, trocar o método antes de reabrir a função.

## A frase pronta para explicar ao cliente

Quando o cliente perguntar por que você mexeu no PHP dele, essa versão costuma encerrar o assunto sem gerar medo:

> **** "Desliguei no servidor sete funções do PHP que permitem rodar comandos do sistema operacional. O site não usa nenhuma delas. Elas são o caminho mais direto que um invasor usa depois de explorar um plugin desatualizado: sem elas, mesmo que ele consiga enviar um arquivo, fica limitado ao que o PHP faz sozinho (ler e gravar arquivos, acessar o banco) e perde o acesso a comandos do sistema operacional. Não substitui manter plugin atualizado e limpar o que já entrou, reduz o alcance do estrago. Conferi o funcionamento de imagens, e-mail e backup depois da mudança, e a reversão está documentada caso apareça algum efeito colateral."

Se o cliente for mais técnico, acrescente que a diretiva é `disable_functions`, que o valor em vigor é verificável por `phpinfo()` e que a referência de configuração é a documentação de [PHP Security Concepts do cPanel](https://docs.cpanel.net/knowledge-base/security/php-security-concepts/).

E a recomendação honesta: se o levantamento mostrar que um plugin crítico do cliente depende de `exec` de verdade, não force o bloqueio para cumprir checklist. Troque o plugin quando der, isole o site enquanto não dá, e deixe anotado. Segurança que derruba o faturamento do cliente na terça-feira não é segurança, é chamado.

