# Diretiva PHP que o painel não mostra: onde escrever e como testar

session.save_path, open_basedir, disable_functions e opcache não aparecem no seletor do cPanel. Veja onde escrever cada um, qual arquivo vence o outro e como provar com phpinfo() no caminho certo.

> três lugares aceitam diretiva que o painel não lista: o MultiPHP INI Editor em modo Editor (por domínio), o .user.ini na pasta do site e o INI global do WHM. O .user.ini é lido por último e vence, exceto em diretivas de nível de sistema como disable_functions.

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

---

O seletor de PHP do painel mostra meia dúzia de diretivas: `upload_max_filesize`, `memory_limit`, `max_execution_time`, `post_max_size`. Quando o plugin pede `session.save_path`, quando o scanner de segurança manda preencher `disable_functions`, ou quando você precisa isolar o site com `open_basedir`, a tela não tem onde digitar. A diretiva existe no PHP, só não está listada.

A documentação do cPanel chama isso de **custom PHP directive**, e descreve três lugares onde ela pode ser escrita. O que nenhum tutorial junta é: qual dos três lugares usar, qual vence quando dois definem a mesma coisa, e como provar que pegou. É isso aqui.

## Os três lugares onde a diretiva pode ser escrita

Segundo a [documentação oficial do cPanel sobre diretivas PHP personalizadas](https://docs.cpanel.net/knowledge-base/web-services/create-custom-php-directives/), você tem três caminhos. Eles não são equivalentes.

| Onde | Alcance | Quem consegue editar | Quando usar |
|---|---|---|---||
| MultiPHP INI Editor, modo **Editor** | Um domínio ou subdomínio da conta | Dono da conta, pelo cPanel | Diretiva que vale para um site só |
| `.user.ini` na pasta do site | A pasta onde o arquivo está e as subpastas | Qualquer um com Gerenciador de Arquivos ou FTP | Ajuste rápido, ou quando o INI Editor não aceitou a diretiva |
| Arquivo INI global, pelo WHM | Todas as contas que usam aquela versão de PHP | Só quem tem acesso root ao servidor | Política do servidor inteiro |

O **modo Editor** do MultiPHP INI Editor é a parte que quase ninguém abre. No cPanel, em *Software > MultiPHP INI Editor*, existem duas abas: **Basic Mode**, que é a lista pronta de diretivas, e **Editor Mode**, que é um campo de texto livre. É no Editor Mode que você escreve diretiva que a lista não oferece. Você escolhe o domínio no seletor do topo, digita as linhas, salva.

O `.user.ini` é um arquivo de texto que você cria na pasta do site (normalmente `public_html`). Ele funciona com PHP rodando como FastCGI, que é o caso mais comum em hospedagem compartilhada. Uma linha por diretiva, sem `<?php`, sem aspas em volta do arquivo inteiro.

```ini
; exemplo de .user.ini em public_html
; os valores abaixo são exemplo, não recomendação
session.save_path = "/home/usuario/tmp"
open_basedir = "/home/usuario/public_html:/tmp:/home/usuario/tmp"
```

O arquivo global pelo WHM fica em *WHM > Software > MultiPHP INI Editor*, mesma tela, mas com a opção de escolher a **versão do PHP** em vez do domínio. O que você escrever ali vale para todas as contas que rodam aquela versão. Se você é dono do servidor ou revendedor com WHM, pense duas vezes antes de usar: uma diretiva global errada derruba todos os sites de uma vez, não um.

## Qual dos três vence

A doc do cPanel diz onde a diretiva pode ser escrita, não em que ordem os arquivos são lidos. A ordem abaixo é comportamento do próprio PHP, e você confere no `phpinfo()` olhando as colunas Local Value e Master Value. Vale para instalação típica de cPanel com PHP em FastCGI:

- O arquivo **global** (WHM) estabelece a base.
- O **INI do domínio** (MultiPHP INI Editor, Editor Mode) sobrescreve a base para aquele domínio.
- O **`.user.ini`** na pasta é lido por último e sobrescreve o que veio antes, para aquela pasta e subpastas.

O detalhe que explica a confusão mais comum: existem diretivas que o `.user.ini` **não consegue** alterar. O PHP classifica cada diretiva por nível (`PHP_INI_USER`, `PHP_INI_PERDIR`, `PHP_INI_SYSTEM`), e as marcadas como de nível de sistema só aceitam mudança no INI principal, não em `.user.ini`. Isso é regra do interpretador PHP, não do painel. `disable_functions` é o caso clássico: tentar definir em `.user.ini` costuma simplesmente não surtir efeito, sem mensagem de erro nenhuma. Você salva, recarrega, e o `phpinfo()` mostra o valor antigo. Não é bug, é o nível da diretiva.

Por isso a ordem de tentativa que recomendo:

- Precisa de `session.save_path`, `open_basedir`, limites de memória ou upload: tente primeiro no `.user.ini`, que é reversível em dois cliques.
- Precisa de `disable_functions` ou das diretivas de `opcache` que o PHP só lê na inicialização: vá direto ao MultiPHP INI Editor em modo Editor, ou ao WHM se você tiver acesso.

## Como provar que pegou, do jeito certo

Quase todo tutorial manda criar um `phpinfo.php` na raiz do site. Isso prova pouco, porque `.user.ini` tem escopo de pasta. Se o arquivo que você quer afetar está em `/public_html/loja/`, e o `phpinfo()` está em `/public_html/`, você pode estar lendo uma configuração diferente da que o site usa.

### Crie o arquivo dentro do caminho exato

No Gerenciador de Arquivos do cPanel, entre **na mesma pasta** onde está o script que você quer afetar. Clique em *+ Arquivo*, nomeie com algo que não seja adivinhável, por exemplo `zz-check-9f3a.php`, e coloque dentro:

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

Acesse `https://seudominio.com.br/loja/zz-check-9f3a.php` (ajustando o caminho). Antes de procurar a diretiva, olhe a linha **Server API**, no topo da página. Se mostrar algo como `CGI/FastCGI`, `FPM/FastCGI` ou `LiteSpeed`, o `.user.ini` é lido. Se mostrar `Apache 2.0 Handler`, o PHP está rodando como mod_php e o `.user.ini` é simplesmente ignorado: nesse caso a diretiva tem que ir para o MultiPHP INI Editor em modo Editor.

Depois disso, use Ctrl+F e procure o nome da diretiva. Olhe as duas colunas: **Local Value** é o valor em vigor naquele caminho, **Master Value** é o valor herdado do INI principal. Se Local Value mostra o que você escreveu e Master Value mostra outra coisa, o `.user.ini` funcionou.

### Apague o arquivo depois

Um `phpinfo()` público expõe caminhos absolutos, extensões carregadas e versão exata do PHP. Deixar no ar é presente para quem procura alvo. Apague assim que terminar o teste. Nome difícil de adivinhar ajuda, mas não substitui apagar.

### Se o valor não mudou

Quatro causas, nessa ordem de probabilidade:

- **O PHP não roda como FastCGI.** Confira a linha Server API no `phpinfo()`. Em `Apache 2.0 Handler`, nenhum `.user.ini` tem efeito, não importa onde esteja.

- **Cache do `.user.ini`.** O PHP relê esse arquivo em intervalo, não a cada requisição. Espere alguns minutos e recarregue. Em muitos painéis, o botão de reiniciar o PHP (ou trocar a versão do PHP e voltar) força a releitura.
- **A diretiva não é editável nesse nível.** Leve para o MultiPHP INI Editor.
- **Erro de sintaxe na linha anterior.** O PHP pode ignorar o restante do arquivo. Deixe uma diretiva por linha, sem ponto e vírgula no fim (o `;` ali vira comentário), sem espaço estranho no nome.

## Nota de escopo: opcache mostra um estado que já mudou

O OPcache é diferente das outras três diretivas e merece aviso separado. Ele guarda o bytecode dos seus arquivos PHP em memória. Mudanças em `opcache.enable`, `opcache.memory_consumption` e companhia só valem depois que o processo PHP reinicia. Enquanto isso, o `phpinfo()` pode mostrar um valor e o site se comportar como outro, porque o código servido ainda é o que está em cache.

Duas consequências práticas:

- Depois de mexer em opcache, reinicie o processo PHP antes de concluir que não funcionou. Não adianta esperar: `opcache.revalidate_freq` controla de quanto em quanto tempo o PHP checa se os arquivos de código mudaram, não tem relação com mudança de configuração do próprio opcache. Diretivas como `opcache.enable` e `opcache.memory_consumption` só passam a valer quando o processo reinicia.
- Se você subiu arquivo novo por FTP e o site ainda mostra o antigo, o suspeito é o OPcache, não o navegador. Limpar o cache do WordPress não resolve isso.

Teste de opcache só vale depois do reinício. Antes disso, o `phpinfo()` é retrato de um estado que já mudou.

## Os três erros que derrubam o site na hora

Antes de qualquer um dos três: **baixe uma cópia do arquivo que vai editar**. No Gerenciador de Arquivos, clique com o botão direito no `.user.ini` e escolha *Download*. Se não existe ainda, você já sabe que desfazer é apagar. Se for mexer no Editor Mode do MultiPHP INI Editor, selecione todo o conteúdo do campo e cole em um bloco de notas antes de alterar. Desfazer sem cópia é reconstruir de memória sob pressão.

### open_basedir sem /tmp e sem a pasta de uploads

`open_basedir` restringe os caminhos que o PHP pode abrir. Se você listar só `/home/usuario/public_html`, o PHP perde acesso ao diretório temporário, e tudo que grava arquivo temporário quebra: upload de imagem, geração de PDF, importação de CSV, às vezes a própria sessão.

**Sintoma na tela:** mensagens com `open_basedir restriction in effect. File(...) is not within the allowed path(s)`, upload que falha sem explicação na Biblioteca de Mídia, tela branca em telas específicas do admin.

**Como desfazer:** apague a linha `open_basedir` do `.user.ini` e salve. O site volta ao comportamento padrão. Depois, se quiser mesmo usar a diretiva, monte a lista com os separadores de caminho corretos (dois-pontos em Linux) incluindo a pasta do site, a pasta temporária e qualquer caminho fora da raiz que o site use (uploads em disco separado, biblioteca compartilhada).

### session.save_path apontando para pasta sem permissão de escrita

Esta é a que mais assusta porque tira você de dentro do painel. O PHP grava as sessões em arquivos nesse caminho. Se a pasta não existe, ou existe mas o usuário do PHP não pode escrever nela, a sessão não persiste.

**Sintoma na tela:** você digita usuário e senha no `/wp-admin`, a página recarrega e volta para o formulário de login, sem mensagem de erro. Ou aparece aviso de cookie. Carrinho de loja que esvazia a cada clique é a versão e-commerce do mesmo problema.

**Como desfazer:** entre pelo Gerenciador de Arquivos do cPanel, que não depende da sessão PHP do site, abra o `.user.ini` e remova a linha `session.save_path`. Se você precisa mesmo de uma pasta própria, crie antes a pasta pelo Gerenciador de Arquivos, confira que ela não está dentro de `public_html` (sessão em pasta pública é risco) e que as permissões permitem escrita ao usuário da conta. Só depois aponte a diretiva para ela.

### disable_functions cortando função que um plugin usa

`disable_functions` desativa funções do PHP pelo nome. É boa prática de segurança desligar o que o site não usa. O problema é que a lista pronta que circula na internet costuma incluir funções que algum plugin usa de verdade.

**Sintoma na tela:** `Fatal error: Uncaught Error: Call to undefined function nome_da_funcao()`, tela branca no front-end, ou um recurso específico do plugin que para (envio de e-mail, geração de miniatura, backup). O nome da função no erro é a pista exata.

**Como desfazer:** essa diretiva normalmente está no MultiPHP INI Editor em modo Editor, não no `.user.ini`. Entre em *Software > MultiPHP INI Editor*, aba **Editor Mode**, selecione o domínio, e remova do valor de `disable_functions` exatamente a função citada no erro. Salve e recarregue. Se o painel estiver inacessível e você tiver WHM, o mesmo caminho existe lá por versão de PHP.

**Procedimento que evita o susto:** ative uma função por vez, ou melhor, remova uma por vez da lista de permitidas, e navegue pelo site e pelo admin entre cada alteração. Lista de 30 nomes colada de uma vez transforma diagnóstico de dois minutos em caçada.

## Roteiro de aplicação sem derrubar nada

- **Anote o estado atual.** Crie o `phpinfo()` no caminho exato, procure a diretiva, anote Local Value e Master Value. Você vai querer esse valor na hora de voltar.
- **Decida o escopo.** Um site: INI Editor em modo Editor ou `.user.ini`. Todos os sites do servidor: WHM, e só se você for responsável por ele.
- **Faça a cópia de segurança** do arquivo ou do conteúdo do campo.
- **Altere uma diretiva por vez** e salve.
- **Espere a releitura** ou reinicie o PHP, especialmente se a diretiva for de opcache.
- **Recarregue o `phpinfo()`** e confirme o Local Value.
- **Teste o site de verdade:** faça login no `/wp-admin`, suba uma imagem na Biblioteca de Mídia, abra uma página do front-end. O `phpinfo()` prova que a configuração mudou, não que o site continua funcionando.
- **Apague o `phpinfo()`.**

Se em qualquer passo o site parar, volte um passo: remova a linha que acabou de adicionar e salve. Como você alterou uma coisa por vez, a causa é sempre a última linha.

## Quando a diretiva não é a resposta

Vale dizer contra o próprio interesse de quem vende hospedagem: boa parte dos pedidos de `memory_limit` maior ou `max_execution_time` maior é sintoma, não causa. Um plugin que precisa de 1024M para carregar a lista de pedidos normalmente está fazendo consulta sem índice. Subir o limite faz a tela abrir e esconde o problema até a próxima vez, com o site mais lento no caminho.

Antes de aumentar limite, desative os plugins em lote para achar o culpado, olhe o log de erro do PHP (no cPanel, em *Métricas > Erros*, ou o `error_log` na pasta do site) e veja se a mensagem repete o mesmo arquivo. O ajuste de INI é a ferramenta certa quando a necessidade é estrutural: isolar o site com `open_basedir`, mover sessões para fora da pasta pública, desligar função que você sabe que ninguém usa. Para o resto, geralmente há causa a corrigir.

**Fonte consultada:** [cPanel, Create Custom PHP Directives](https://docs.cpanel.net/knowledge-base/web-services/create-custom-php-directives/), consultada em 25 de setembro de 2026. Todos os valores de diretiva mostrados acima são exemplos ilustrativos, não recomendações de configuração para o seu site.

