blog
Painéis

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.

JR · · 8 min de leitura · 2 tabelas · 5 blocos de código

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
  1. As sete funções de execução de comando e o que cada uma faz
  2. Como descobrir quem chama o quê antes de bloquear
  3. Como decidir, função por função, o que entra na lista
  4. Onde a diretiva pega de verdade: INI da versão ou pool de FPM
  5. A reversão que você vai precisar às 23h
  6. Como padronizar a carteira sem virar trabalho manual
  7. Checklist das sete funções, do grep ao teste final
  8. 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:

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.

Do grep ao teste: caminho por siteLevantargrep nas sete funcoesClassificarChamada direta, guarda ou comentarioAplicarINI da versao ou pool FPMConferirLocal Value no phpinfoTestarImagem, e-mail e backup
Processo reutilizavel por site da carteira, do levantamento ao teste final.

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:

  1. Nenhuma chamada direta encontrada em nenhum site da carteira: entra na lista de bloqueio, sem conversa.
  2. Chamada só dentro de function_exists: entra na lista. O código já prevê a ausência. Teste a funcionalidade correspondente depois de aplicar.
  3. Chamada direta em plugin ativo e necessário: fica de fora, ou você troca o plugin. Decisão de projeto, não de servidor.
  4. 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
Como decidir o que entra na listaNenhuma chamada diretaEntra na lista de bloqueioSo dentro de function_existsEntra na lista, teste depoisChamada direta em plugin ativoFica de fora ou troca o pluginDireta em legado sem donoIsolar em conta com PHP proprio
Decisao funcao por funcao a partir da classificacao do grep.

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

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:

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

  1. grep -rn nas sete funções em wp-content/ e no código legado de cada site.
  2. Classificar cada ocorrência: chamada direta, dentro de function_exists, ou comentário.
  3. Montar a lista de bloqueio a partir dessa classificação, não de lista pronta.
  4. Copiar o valor atual de disable_functions do phpinfo e guardar como rollback escrito.
  5. 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.
  6. Reabrir o phpinfo e conferir Local Value e Master Value.
  7. Apagar o arquivo de phpinfo.
  8. Testar, no mínimo: upload de imagem com geração de miniatura, envio de e-mail pelo formulário e execução do backup.
  9. 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

  1. Documentação oficial (cpanel) — PHP Security Concepts. Consultado em 2026-10-20.
Leia também