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

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

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

---

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](https://docs.cpanel.net/knowledge-base/security/php-security-concepts/)).

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.

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

- Local Value igual ao que você marcou: a configuração pegou.
- Local Value sem as funções que você marcou: a alteração não chegou ao PHP que atende o site. Confira em **Select PHP Version** se o domínio está mesmo na versão que você editou, veja se o `phpinfo()` reporta essa mesma versão no topo da página e repita a edição se o site for subdomínio ou domínio adicional com versão própria.
- Local Value com mais funções do que você marcou: a conta ou o servidor já bloqueava parte delas antes.

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

- 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.
- Com o nome do arquivo em mãos, confira na sua tabela de inventário qual recurso depende dele.
- 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).
- 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! */`:

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

## 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](https://docs.cpanel.net/knowledge-base/security/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.

