Base de Conhecimento

Os servidores de hospedagem da Invirtua permitem que diversas configurações e limites do PHP sejam alterados diretamente pelo cliente através do cPanel, sem necessidade de solicitar a alteração ao suporte.

Entre as configurações que podem ser ajustadas estão limite de memória, tamanho máximo para upload de arquivos, tamanho máximo de requisições, tempo de execução de scripts e quantidade de variáveis recebidas por formulários.

Essas configurações são conhecidas como diretivas ou variáveis do PHP e normalmente são armazenadas em arquivos de configuração como php.ini e .user.ini.

1. Como acessar as configurações do PHP

1. Acesse o cPanel da sua conta de hospedagem.
2. Na seção Software, clique em MultiPHP INI Editor.
3. Selecione o domínio que deseja configurar.
4. Utilize preferencialmente o modo Basic Mode para alterar as configurações disponíveis.
5. Localize a variável desejada, altere seu valor e clique em Apply / Aplicar.

As alterações normalmente passam a valer imediatamente para novas execuções do PHP.

2. Configuração por domínio ou para toda a conta

O MultiPHP INI Editor permite selecionar um domínio específico ou o diretório principal da conta (Home Directory).

Quando possível, recomendamos alterar as configurações apenas no domínio que realmente necessita da modificação.

Isso evita que uma necessidade específica de um site seja aplicada desnecessariamente aos demais sites existentes na mesma conta de hospedagem.

Se uma conta possui, por exemplo:

• empresa.com.br
• loja.empresa.com.br
• sistema.empresa.com.br

cada aplicação poderá ter necessidades diferentes de memória, tempo de execução ou tamanho de upload.

3. Principais variáveis do PHP

Abaixo estão algumas das configurações mais utilizadas.

Os valores acima são apenas exemplos. Não é necessário nem recomendável utilizar os mesmos valores em todos os sites.

4. memory_limit

A variável:

memory_limit

define a quantidade máxima de memória que cada execução PHP pode consumir.

Exemplo:

memory_limit = 256M

Isso permite que uma execução PHP utilize até 256 MB de memória.

Aplicações mais complexas, sistemas de comércio eletrônico, plugins, importadores de dados, geradores de relatórios ou operações envolvendo grandes quantidades de informações podem necessitar de limites maiores.

Aumentar o memory_limit não significa automaticamente melhorar o desempenho do site.

Se uma aplicação estiver consumindo memória excessivamente por erro de programação, plugin defeituoso ou consulta inadequada, simplesmente aumentar esse limite pode apenas adiar o problema.

5. upload_max_filesize

A variável:

upload_max_filesize

define o tamanho máximo permitido para um único arquivo enviado através do PHP.

Por exemplo:

upload_max_filesize = 64M

permite o envio de arquivos de até 64 MB, desde que os demais limites envolvidos também permitam esse tamanho.

Essa configuração é frequentemente utilizada em:

• upload de imagens;
• envio de documentos;
• importação de bancos ou arquivos;
• instalação de plugins e temas;
• restauração de backups através de aplicações Web.

6. post_max_size

A variável:

post_max_size

define o tamanho máximo da requisição inteira enviada ao PHP através do método POST.

Por isso, para permitir um upload de:

upload_max_filesize = 64M

o valor de post_max_size deve ser maior que 64 MB.

Por exemplo:

upload_max_filesize = 64M
post_max_size = 72M

Se post_max_size for menor que upload_max_filesize, o limite efetivo da requisição continuará impedindo o envio do arquivo.

7. Relação entre memória e tamanho de upload

Quando estiver ajustando aplicações que processam arquivos grandes, observe principalmente estas três variáveis:

upload_max_filesize
post_max_size
memory_limit

Como regra prática:

upload_max_filesize < post_max_size < memory_limit

Por exemplo:

upload_max_filesize = 64M
post_max_size = 72M
memory_limit = 256M

Isso não significa que esses valores sejam ideais para todas as aplicações. Eles servem apenas para demonstrar a relação entre os limites.

8. max_execution_time

A variável:

max_execution_time

define o tempo máximo, em segundos, durante o qual um script PHP poderá permanecer em execução.

Exemplo:

max_execution_time = 120

Aplicações podem necessitar de tempos maiores durante operações como:

• importação ou exportação de grandes volumes de dados;
• geração de relatórios;
• processamento de imagens;
• instalação ou atualização de sistemas;
• rotinas de manutenção;
• migração ou restauração de conteúdo.

Se um script frequentemente precisa de vários minutos para executar uma operação comum, entretanto, recomendamos verificar também a aplicação. Um tempo de execução elevado pode estar mascarando problemas de desempenho.

9. max_input_time

A variável:

max_input_time

controla quanto tempo o PHP pode utilizar para processar os dados recebidos pela requisição.

Ela pode ser relevante em formulários grandes ou operações envolvendo grandes volumes de dados enviados ao servidor.

Exemplo:

max_input_time = 120

10. max_input_vars

A variável:

max_input_vars

limita a quantidade de variáveis recebidas em uma requisição.

Essa configuração pode ser especialmente importante para:

• formulários muito grandes;
• painéis administrativos;
• menus extensos;
• sistemas ERP e aplicações Web;
• WordPress e plugins que utilizem grande quantidade de campos.

Quando o limite é atingido, parte das informações enviadas pelo formulário poderá não ser processada pela aplicação.

Exemplo:

max_input_vars = 3000

11. Como informar valores de memória e tamanho

Para variáveis relacionadas a tamanhos, normalmente podem ser utilizadas abreviações como:

Não utilize espaços desnecessários entre o número e a unidade.

12. Basic Mode e Editor Mode

O MultiPHP INI Editor oferece dois modos de configuração.

Basic Mode

É o modo recomendado para a maioria dos usuários.

Ele apresenta as principais variáveis disponíveis em campos próprios, reduzindo o risco de erros de sintaxe.

Editor Mode

O Editor Mode permite editar diretamente as diretivas PHP e é destinado a usuários com conhecimento técnico mais avançado.

Um erro de sintaxe ou uma diretiva inadequada pode causar falhas no funcionamento de aplicações PHP.

Se a variável desejada já estiver disponível no Basic Mode, recomendamos utilizar essa opção.

13. Nem todas as variáveis podem ser alteradas

Algumas configurações PHP podem ser controladas ou limitadas pela configuração global do servidor.

Além disso, a disponibilidade das diretivas pode variar conforme a versão do PHP utilizada.

Se determinada opção não estiver disponível no MultiPHP INI Editor ou se o valor configurado não estiver sendo aplicado, entre em contato com nosso suporte.

14. Não utilize valores excessivamente altos sem necessidade

Configurar limites muito elevados não torna automaticamente uma aplicação mais rápida ou estável.

Por exemplo:

memory_limit = 4G
max_execution_time = 3600
upload_max_filesize = 2G

pode parecer uma maneira simples de eliminar limitações, mas também pode permitir que uma aplicação defeituosa consuma recursos desnecessariamente durante muito tempo.

O ideal é utilizar valores compatíveis com a necessidade real da aplicação.

15. O site apresentou erro após uma alteração?

Se um site deixar de funcionar depois da modificação de alguma diretiva PHP:

1. Retorne ao MultiPHP INI Editor.
2. Selecione o mesmo domínio alterado anteriormente.
3. Revise a última configuração modificada.
4. Retorne o valor ao estado anterior, caso necessário.
5. Teste novamente a aplicação.

Alterações no PHP devem ser realizadas preferencialmente uma de cada vez. Isso facilita identificar qual configuração provocou algum comportamento inesperado.

16. Diferença entre versão do PHP e variáveis do PHP

São configurações diferentes.

A versão do PHP, como PHP 7.4, PHP 8.2 ou PHP 8.3, é selecionada através do MultiPHP Manager.

Já limites e outras diretivas, como:

• memory_limit;
• upload_max_filesize;
• post_max_size;
• max_execution_time;
• max_input_vars;

são administrados através do MultiPHP INI Editor.

17. Resumo rápido

18. Suporte

Se precisar utilizar uma variável que não esteja disponível no painel, se uma configuração não estiver sendo aplicada ou se tiver dúvidas sobre os valores adequados para sua aplicação, entre em contato com nosso suporte através do e-mail suporte@invirtua.com.br.