O Editor INI MultiPHP é a ferramenta do cPanel que permite configurar e personalizar diretivas do PHP para seus domínios, subdomínios ou até para toda a sua conta.
Com ele, você pode ajustar limites de memória, tamanhos de upload, tempo de execução e diversas regras importantes para o funcionamento dos seus sites.
Essa ferramenta possui dois modos:
- Modo Básico — simples, visual e seguro
- Modo Editor — avançado, indicado apenas para usuários experientes
A seguir, você encontra um passo a passo completo para usar cada um deles.
⭐ Modo Básico (Recomendado para a maioria dos usuários):
O Modo Básico exibe as diretivas PHP disponíveis para o local selecionado (domínio ou diretório inicial).
Aqui, você pode ajustar valores apenas clicando no campo desejado — é simples e seguro.
1° Passo
Faça login na sua conta UOL HOST:
2° Passo
Clique em ‘’Configurar’’ no car do produto Hospedagem cPanel ou em ‘’Hospedagem cPanel’’ no menu lateral:
3° Passo
Clique em ‘’Painel cPanel’’:
4° Passo
Já no seu painel Hospedagem cPanel, na seção ‘’Software’’, clique em ‘’Editor INI MultiPHP’’:
5° Passo
Selecione a opção ‘’Modo Básico’’:
6° Passo
Selecione o local que deseja configurar no menu. Se quiser aplicar alterações a qualquer site sob este usuário do cPanel, edite o diretório inicial (Home Directory). Se for aplicar alterações somente a um domínio específico, selecione o domínio em “Selecione um local”. As diretivas PHP aparecerão após a seleção:
7° Passo
A seção “Modo Básico” desta interface carrega valores de diretiva do arquivo php.ini para seu domínio ou diretório home selecionado:
8° Passo
Faça suas alterações nas diretivas desejadas e clique em “Aplicar”. O sistema salva as alterações no arquivo php.ini / user.ini e no seu arquivo .htaccess:
⚠️ IMPORTANTE:
- Se você usar o manipulador DSO PHP e alterar sua versão do PHP para uma versão principal diferente, o sistema não lerá suas alterações de configuração. O cPanel e o WHM não oferecem suporte ao manipulador DSO PHP com PHP 8.0 e superior.
- Por exemplo: se você alterar sua versão do PHP de PHP 5 para PHP 7, o sistema não lerá suas alterações de configuração. Para corrigir esse problema, você deve editar e salvar sua configuração do PHP novamente na interface. O sistema então carregará as diretivas do .htaccess corretamente.
🚨 OBSERVAÇÕES:
- Por motivos de segurança, recomendamos fortemente que você use os valores padrão fornecidos pelo cPanel.
- A disponibilidade de diretivas depende da sua versão do PHP. Se uma diretiva não aparecer na sua interface, sua versão do PHP não a suporta.
- O sistema só grava uma diretiva em um arquivo .ini ou .htaccess se esse arquivo suportar a diretiva. Seus arquivos php.ini, user.ini podem não ser idênticos, e isso poderá gerar conflitos, observe que esta ferramenta informa o caminho do arquivo de configuração (php.ini ou user.ini). Verifique sem seu arquivo de configuração, se ele foi escrito o código, seja ele php.ini / .user.ini / .htaccess.
- Para garantir a compatibilidade com o módulo LSAPI, o sistema também adiciona uma seção LSAPI ao seu arquivo .htaccess. Esta seção pode se parecer com o exemplo a seguir:
<IfModule lsapi_module>
php_value date.timezone “America/Chicago”
php_value memory_limit 128M
php_value upload_max_filesize 60M
</IfModule>
Segue um exemplo, de como alterar a diretiva “memory_limit” no “Modo Básico” de 128 MB para 256 MB:
- Localize a diretiva “memory_limit”: Na interface de configuração do PHP, encontre a linha correspondente à diretiva “memory_limit”:
- Editar o valor: Clique no campo de valor atual (por exemplo, “128M”) na coluna “Configurar”, e edite para 256M:
Assim que você editar, aparecerá uma notificação no canto superior direito para o próximo passo:
- Aplicar as mudanças: Após selecionar o novo valor, clique no botão “Aplicar” para salvar as alterações:
🚨 OBSERVAÇÃO: sua hospedagem precisar comportar os recursos que tentar alocar, exemplo se você detiver uma hospedagem que permite o uso de até 128 MB de memória, se tentar alocar mais que isso, o sistema não irá atualizar, mesmo que ele aceite, ele não irá atualizar a memória para mais que 128 MB.
MODO EDITOR:
1° Passo
Este modo, é mais avançado e requer conhecimento técnico para usar. Clique no ‘’Modo Editor’’. Selecione o local que você deseja configurar no menu:
2° Passo
Você pode editar o diretório home da conta do usuário ou a raiz do documento do domínio.
Se você quiser que as alterações feitas reflitam em qualquer site sob este usuário cPanel, edite o “diretório home” (Home Directory).
Se você quiser que as alterações se apliquem somente a um domínio específico, edite a raiz do documento do domínio.
Após editar, clique no botão ‘’Salvar’’:
⚠️ ATENÇÃO:
- Você deve ter extremo cuidado ao fazer alterações nesta interface. Erros podem resultar em scripts PHP não funcionais, culminando em um site fora do ar, como exemplo WordPress. Somente usuários avançados devem usar esta interface.
- Restringimos as seguintes palavras e você não pode usá-las como diretivas: null, yes, no, true, false, on, off, e none. As diretivas também não podem conter nenhum dos seguintes caracteres especiais: ?{}|&~
