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.

Resposta curta: 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.
Neste artigo
- As sete funções de execução de comando e o que cada uma faz
- Como descobrir quem chama o quê antes de bloquear
- Como decidir, função por função, o que entra na lista
- Onde a diretiva pega de verdade: INI da versão ou pool de FPM
- A reversão que você vai precisar às 23h
- Como padronizar a carteira sem virar trabalho manual
- Checklist das sete funções, do grep ao teste final
- A frase pronta para explicar ao cliente
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) 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ó
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'))ouin_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
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:
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) 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 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_SYSTEMe só vem da configuração da instalação de PHP (INI do painel ou pool de FPM). - Diretiva escrita em
.htaccesscomphp_valuenã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:
; 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 comozz-check-7f3a.phpe 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 -rnnas sete funções emwp-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_functionsdo 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.ininã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:
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.
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.
Referências
- Documentação oficial (cpanel) — PHP Security Concepts. Consultado em 2026-10-20.