Capítulo 14 · 14.3
Opções PHP: upload_max_filesize, memory_limit e max_execution_time
Veja num pequeno vídeo
Ao PHP estão associadas definições que determinam o que um script pode fazer: qual o tamanho máximo de um upload, quanta memória um script pode utilizar e durante quanto tempo pode ser executado. Estas definições são ajustadas em Select PHP version, no separador Options. Ou seja, não precisa de um ficheiro php.ini nem de regras no .htaccess.
Como ajustar uma opção
- No DirectAdmin, em Recursos extras, clique em Select PHP version.
- Verifique em PHP version se a versão correta está selecionada. As opções são definidas por versão.
- Clique no separador Options.
- Clique no valor junto à opção que pretende alterar e escolha ou introduza o novo valor.
O novo valor é guardado de imediato e aplica-se logo a todos os sites do seu pacote que utilizem esta versão de PHP.
As opções mais importantes
| Opção | O que faz? | Quando aumentar? |
|---|---|---|
| upload_max_filesize | Qual o tamanho máximo de um único ficheiro carregado. | Se quiser carregar um tema grande, um vídeo ou uma cópia de segurança e receber uma mensagem a indicar que o ficheiro é demasiado grande. |
| post_max_size | Qual o tamanho total de tudo o que é enviado de uma vez (ficheiro mais formulário). | Sempre em conjunto com upload_max_filesize. Defina post_max_size com um valor pelo menos igual, de preferência um pouco maior. |
| memory_limit | Quanta memória um script PHP pode utilizar. | Na mensagem "Allowed memory size of ... bytes exhausted" ou quando um plugin pede mais memória. 256M é suficiente para a maioria dos sites. |
| max_execution_time | Durante quantos segundos um script pode ser executado antes de ser interrompido. | Numa importação, exportação ou migração que para a meio com "Maximum execution time exceeded". |
| max_input_time | Durante quanto tempo o PHP pode demorar a receber um upload ou formulário. | Em uploads grandes através de uma ligação lenta. |
| max_input_vars | Quantos campos um formulário pode ter. | Se um menu grande ou uma página com muitas opções no WordPress não for guardada por completo. Defina, por exemplo, 3000 ou 5000. |
| display_errors | Mostra os erros PHP na própria página. | Apenas temporariamente, para procurar um erro. Depois desative novamente: os visitantes não precisam de ver as suas mensagens de erro. |
| date.timezone | O fuso horário para datas e horas. | Já está definido como Europe/Amsterdam. Altere apenas se o seu site tiver de funcionar noutro fuso horário. |
Atenção: Valores mais elevados nem sempre são melhores. Um script que necessite de muita memória ou tempo conta para os limites do seu pacote (consulte Resource Usage: CPU, memória e processos). Por isso, aumente um valor apenas quando for necessário e não o coloque no máximo "por precaução".
Um exemplo: carregar um ficheiro grande
Pretende carregar, com um plugin de migração, uma cópia de segurança de 200 MB, mas recebe uma mensagem a indicar que o ficheiro é demasiado grande. Nesse caso, defina:
- upload_max_filesize para 256M;
- post_max_size para 256M ou mais;
- eventualmente, max_execution_time e max_input_time um pouco mais elevados, por exemplo 300.
Depois, atualize a página do plugin. O novo limite costuma aparecer logo de imediato. Se ainda assim não resultar, consulte Carregamento demasiado grande (erro 413) ou tempo limite excedido.
Isto também é possível no Mijn WebOké?
Sim, para as opções mais utilizadas. Peça ao assistente de IA no Mijn WebOké, por exemplo, "Define upload_max_filesize como 256M". O assistente pode alterar por si memory_limit, upload_max_filesize, post_max_size, max_execution_time, max_input_time, max_input_vars e display_errors em Select PHP version, para a versão de PHP que o seu pacote está a utilizar nesse momento. Primeiro verá o que vai mudar e só depois clica em Aprovar e executar.
Perguntas frequentes
Aumentei o valor, mas o meu site continua a mostrar o valor antigo.
Verifique se alterou a opção na versão com (current). Verifique também se no seu .htaccess ainda existe uma regra antiga, como php_value upload_max_filesize, ou se em PHP Instellingen existe uma substituição definida para o seu domínio (consulte PHP Instellingen no DirectAdmin ou Select PHP version: qual é a diferença?). Estas têm prioridade.
Qual é o máximo?
No separador Options, em algumas opções só é possível escolher a partir de uma lista. Precisa de um valor superior ao que consegue escolher aí, por exemplo para uma importação grande? Nesse caso, pode definir um valor mais elevado através de uma regra no .htaccess (consulte Definições do PHP por pasta e através de .htaccess), ou abra um ticket.
Porque aparecem disable_functions e open_basedir?
Estas opções existem para a segurança do seu site e do servidor. Deixe-as como estão.