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.

Resposta curta: 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.
Neste artigo
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, 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.
; 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.inina 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_functionsou das diretivas deopcacheque 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
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(). EmApache 2.0 Handler, nenhum.user.initem 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_freqcontrola 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 comoopcache.enableeopcache.memory_consumptionsó 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. Ophpinfo()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, 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.
Referências
- Documentação oficial (cpanel) — Create Custom PHP Directives. Consultado em 2026-09-25.