blog
Painéis

Antes de bloquear exec e shell_exec: o inventário em 3 passos

O levantamento que vem antes de marcar a caixa no PHP Options, e a linha de reversão que você salva antes de testar.

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

Resposta curta: antes de bloquear qualquer função, faça o inventário: procure as seis chamadas (`exec`, `shell_exec`, `system`, `proc_open`, `passthru`, `popen`) nos arquivos de plugins e temas, anote qual recurso depende de cada uma, aplique uma por vez em PHP Options e confirme o valor real em um phpinfo() temporário.

Neste artigo
  1. O que essas seis funções fazem, na prática
  2. Faça o inventário antes de mexer no painel
  3. Os quatro recursos que mais dependem dessas chamadas
  4. Aplique em PHP Options com a linha de reversão já copiada
  5. Confirme o que realmente ficou valendo
  6. Quando algo quebrar, o roteiro de volta
  7. O que o bloqueio resolve e o que ele não resolve

Você entrou em PHP Options no cPanel, marcou exec, shell_exec, system e proc_open em disable_functions, salvou, e algumas horas depois percebeu: as miniaturas pararam de ser geradas, ou o backup não fecha o arquivo, ou a importação de produtos trava na metade. O erro quase nunca aparece na tela. Ele vai para o log, com a frase Call to undefined function ou has been disabled for security reasons.

A ordem certa é a inversa: primeiro você descobre quem usa essas funções na sua conta, depois decide o que bloquear. Este guia faz esse inventário usando só o Gerenciador de Arquivos e o PHP Options do cPanel, confirma o valor que realmente ficou valendo com um phpinfo() e deixa a reversão escrita antes de qualquer mudança.

O que essas seis funções fazem, na prática

Todas executam um comando do sistema operacional a partir do PHP. A diferença está em como devolvem o resultado.

Função O que devolve Uso típico em WordPress
exec última linha da saída, ou array com todas chamar convert do ImageMagick, mysqldump
shell_exec toda a saída como string ler versão de binário, du -sh em backup
system imprime a saída e devolve a última linha scripts antigos de importação
proc_open abre processo com controle de entrada e saída sendmail, compressão em streaming
passthru envia a saída bruta ao navegador geração de arquivo binário
popen abre processo em modo de leitura ou escrita gravar tar/zip aos poucos

A documentação do cPanel sobre segurança em PHP trata disable_functions como uma das camadas de endurecimento da conta, justamente porque uma dessas chamadas combinada com um upload mal validado vira execução de comando no servidor (PHP Security Concepts, cPanel).

Repare que a lista tem seis nomes, não quatro. passthru e popen costumam ficar de fora da checagem e são o motivo mais comum de alguém achar que bloqueou tudo e não bloqueou nada.

Faça o inventário antes de mexer no painel

Por que a busca do Gerenciador de Arquivos pode não achar nada

No cPanel, vá em Arquivos > Gerenciador de Arquivos. Navegue até public_html/wp-content/plugins. No topo da tela há um campo de busca com um seletor ao lado (All Your Files / public_html / pasta atual). Escolha a pasta atual e procure por shell_exec.

O buscador do Gerenciador de Arquivos procura por nome de arquivo, não por conteúdo, em boa parte das versões. Se a sua busca não encontra nada com shell_exec mesmo em um plugin que você sabe que usa, é esse o motivo. Nesse caso, use o Terminal (se a conta tiver) ou baixe wp-content e procure no editor de texto do seu computador, com Ctrl+Shift+F no VS Code ou equivalente.

Procure por conteúdo com grep no Terminal

Se o cPanel tiver Avançado > Terminal liberado, esta é a forma mais direta. Copie, cole e rode:

grep -rn --include="*.php" -E "exec|shell_exec|system|proc_open|passthru|popen" ~/public_html/wp-content/plugins ~/public_html/wp-content/themes

Linha a linha: grep procura texto; -r entra nas subpastas; -n mostra o número da linha; --include="*.php" ignora JS, CSS e imagens; -E ativa a lista separada por |. O resultado esperado é uma lista no formato caminho/arquivo.php:123: $out = shell_exec(...). Se não sair nada, nenhum arquivo PHP de plugin ou tema cita essas funções.

Dois cuidados com o resultado. O padrão exec também casa com execute, wp_exec_something e comentários, então leia a linha antes de concluir. E muitos plugins trazem a função dentro de um if (function_exists('exec')), ou seja, já preveem o bloqueio e caem para um plano B sozinhos.

Anote qual recurso quebra em cada ocorrência

Abra o arquivo (clique com o botão direito no Gerenciador de Arquivos e escolha Edit ou View) e veja o comando chamado dentro. Monte uma tabela sua, no bloco de notas, mais ou menos assim:

Plugin/tema Arquivo:linha Função Comando chamado Recurso que quebra
(exemplo) plugin de imagem class-image.php:88 exec convert miniatura via ImageMagick
(exemplo) plugin de backup dump.php:40 proc_open mysqldump exportação do banco

Os nomes acima são exemplos para ilustrar o formato, não um levantamento de instalações reais.

Inventário em 3 passos antes do bloqueioBuscar por conteúdogrep nos plugins e temasLer cada ocorrênciaConfira o comando chamadoAnotar o recursoTabela de plugin e função
O inventário vem antes da edição no painel. Sem ele, você descobre o que quebrou só pelo log.

Os quatro recursos que mais dependem dessas chamadas

Miniaturas por ImageMagick. O WordPress usa a extensão imagick quando ela existe, e a extensão não precisa de exec. O que precisa é o plugin que chama o binário convert pela linha de comando. Se, depois do bloqueio, as imagens novas saem sem recorte ou sem WebP, a origem costuma ser essa. Alternativa: habilitar a extensão imagick em Select PHP Version > Extensions e manter o bloqueio.

Envio de e-mail. A função mail() do PHP não entra em disable_functions por essa lista, mas bibliotecas configuradas para falar direto com o sendmail usam popen ou proc_open. Se o formulário de contato parar depois da mudança, troque o envio para SMTP autenticado em um plugin de SMTP. Isso melhora a entregabilidade de qualquer jeito.

Backup e migração. Plugins que chamam mysqldump, tar ou zip pelo sistema falham com o bloqueio. Quase todos têm uma opção de modo PHP puro nas configurações, mais lento e com mais consumo de memória.

Importação de produtos e feeds. Rotinas antigas chamam wget ou curl pelo shell. A saída é usar a extensão cURL do próprio PHP.

Aplique em PHP Options com a linha de reversão já copiada

Antes de salvar qualquer coisa, você precisa ter em mãos a linha atual de disable_functions, exatamente como está. Essa é a sua reversão. Pule agora para a seção "Confirme o que realmente ficou valendo", crie o info-temporario.php, copie o valor que aparece em Local Value para o bloco de notas e só então volte a esta seção para editar o PHP Options. Se você editar primeiro, o valor original se perde.

Faça também um backup completo em Arquivos > Backup ou pelo seu plugin. Mudança em disable_functions não altera arquivos, mas a sequência de testes que vem depois pode envolver desativar plugin, e aí backup salva tempo.

O caminho no painel: Software > Select PHP Version > Options (em algumas versões aparece como MultiPHP INI Editor > Editor Mode). Procure a linha disable_functions, clique no valor, edite e salve. Em interfaces que só oferecem caixas de seleção, marque uma por vez.

Recomendação honesta: aplique uma função por vez, começando por system e passthru, que são as menos usadas por código legítimo. Teste o site entre cada uma. Bloquear as seis de uma vez e descobrir no dia seguinte que algo quebrou faz você perder a informação de qual foi a causa.

Confirme o que realmente ficou valendo

O painel mostra o que você pediu. O phpinfo() mostra o que o PHP está aplicando. Esses dois valores divergem quando a edição foi feita em uma versão de PHP diferente da que atende o domínio, quando o site roda em outro pool PHP-FPM (comum em subdomínio ou domínio adicional com versão própria) ou quando o servidor já impõe uma lista por configuração global. disable_functions é uma diretiva de nível PHP_INI_SYSTEM: ela só vem do php.ini da versão em uso ou da configuração do pool, nunca de um .user.ini ou de um php.ini que você coloque dentro de uma pasta.

Crie o arquivo phpinfo() temporário em public_html

No Gerenciador de Arquivos, dentro de public_html, clique em + File e crie info-temporario.php com este conteúdo:

<?php phpinfo();

Acesse https://seudominio.com.br/info-temporario.php. Use Ctrl+F na página e procure disable_functions. A tabela traz duas colunas: Local Value (o que vale para este site) e Master Value (o padrão do servidor).

Local Value e Master Value: como ler cada resultado

Apague o info-temporario.php assim que terminar. Ele expõe caminhos, extensões e versões para qualquer visitante. Use um nome aleatório se precisar deixar por alguns minutos.

Mudança nessa diretiva passa a valer quando o processo PHP recicla. Se você salvou e o phpinfo() ainda mostra o valor antigo, recarregue com Ctrl+F5, espere um ou dois minutos e confira de novo antes de concluir que não funcionou. O cache de .user.ini controlado por user_ini.cache_ttl não tem efeito aqui, porque disable_functions não é lida desse arquivo.

Quando algo quebrar, o roteiro de volta

  1. Abra Métricas > Erros no cPanel, ou o arquivo error_log na raiz do site pelo Gerenciador de Arquivos. Procure pela frase has been disabled for security reasons. A mensagem nomeia a função e o arquivo que a chamou.
  2. Com o nome do arquivo em mãos, confira na sua tabela de inventário qual recurso depende dele.
  3. Decida: liberar a função só para esse caso, ou trocar o método (extensão imagick no lugar do binário, SMTP no lugar do sendmail, modo PHP puro no backup).
  4. Se precisar liberar agora e pensar depois, volte ao PHP Options, cole a linha de reversão que você salvou e confirme no phpinfo().

Se o log não mostrar nada, ative a gravação de erros temporariamente. Em wp-config.php, acima da linha /* That's all, stop editing! */:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Isso grava em wp-content/debug.log sem mostrar nada ao visitante. Desative depois do diagnóstico e apague o arquivo: ele cresce e pode conter caminhos internos.

Do erro no log até a reversão confirmadaErro no site após bloqueioAbra Métricas > Erros ou error_logProcure a frase do PHPhas been disabled for security reasonsIdentifique o arquivo citadoCruze com sua tabela de inventárioTroque o métodoimagick, SMTP ou modo PHP puroSe urgente, revertaCole a linha salva em PHP OptionsConfirme no phpinfo()Compare Local Value e Master Value
Roteiro de volta quando algum recurso para depois da mudança em disable_functions.

O que o bloqueio resolve e o que ele não resolve

Desabilitar essas funções reduz o estrago de uma invasão: o invasor que consegue gravar um arquivo PHP na sua conta fica sem o atalho para rodar comandos do sistema. É uma camada, e a documentação do cPanel a apresenta assim, ao lado de open_basedir e do isolamento de usuário (PHP Security Concepts).

O que ela não faz: não impede que um plugin desatualizado seja explorado, não impede leitura e gravação de arquivos pelo próprio PHP, não protege senha fraca no wp-admin e não substitui atualização. Se você só puder fazer uma coisa esta semana, atualize plugins e troque as senhas. O disable_functions vem depois, com o inventário na mão e a linha de reversão salva no bloco de notas.

Referências

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