Hospedagem e PHP
max_execution_time em hospedagem compartilhada: limites medidos
Cronometramos o limite de execução do PHP no Linux e no Windows, reunimos os limites documentados de cinco empresas de hospedagem e verificamos qual timeout realmente encerra uma requisição longa de backup Multisite.
O que max_execution_time limita de verdade?
max_execution_time define por quanto tempo o PHP pode executar um script: 30 segundos por padrão e nenhum limite na linha de comando [2][3]. No Linux, as compilações comuns contam apenas o tempo em que o código PHP está rodando; sleep, consultas ao banco e esperas de rede ficam de fora, já no Windows entram na conta [1]. Num backup Multisite, geralmente outra camada corta antes: o nginx após 60 segundos sem dados e o Cloudflare após 125 segundos [5][7].
O que medimos: tempo de CPU no Linux, tempo real no Windows
Segundo o manual do PHP, o limite cobre apenas a execução do próprio script, exceto no Windows, onde se mede o tempo real [1]. Compilações com Zend Max Execution Timers, padrão nas compilações thread-safe desde o PHP 8.3, também medem o tempo decorrido; nelas, dormir e esperar contam [2]. Quisemos ver isso com nossos próprios olhos: definimos um limite de 2 segundos e rodamos três pequenos scripts num servidor Linux e num PC com Windows.
O resultado confirma o manual. No Linux, sleep(5) terminou sem erro após 5,00 segundos, porque dormir não é tempo de execução. Um laço de cálculo puro parou exatamente em 2,00 segundos. Três segundos de pausa seguidos de um laço pararam em 5,00 segundos: a pausa foi ignorada e o laço teve seus 2 segundos inteiros. No Windows, o script com pausa foi interrompido, e o combinado parou já em 3,01 segundos.
Um detalhe nos surpreendeu: no Windows, o erro fatal de sleep(5) não apareceu aos 2 segundos, e sim aos 5,01. O PHP só percebeu o estouro quando a chamada bloqueante retornou. Isso indica que um script preso numa consulta longa ou numa leitura de rede pode passar bem do seu limite antes de o PHP encerrá-lo.
| Script (limite 2 s, mediana de 3 execuções) | Linux, PHP 8.5.12 | Windows, PHP 8.2.12 |
|---|---|---|
sleep(5) | concluído, 5,00 s | erro fatal em 5,01 s |
| Laço de cálculo | erro fatal em 2,00 s | erro fatal em 2,01 s |
sleep(3) + laço de cálculo | erro fatal em 5,00 s | erro fatal em 3,01 s |
Qual camada encerra a requisição primeiro
Uma requisição de backup iniciada no navegador passa por vários temporizadores, e vence o mais curto. A documentação do WordPress diz o mesmo: um limite alto no PHP não adianta se o servidor web desistir antes [17]. O PHP usa por padrão 30 segundos nas requisições web e 0, ou seja, sem limite, na linha de comando [2][3]. O PHP-FPM tem seu próprio disjuntor, request_terminate_timeout, desligado por padrão e pensado para scripts que o limite de execução não consegue parar [4].
Na frente do PHP, o nginx espera por padrão 60 segundos pelo próximo bloco de dados do PHP-FPM; o contador recomeça a cada leitura, então um script que continua enviando saída pode trabalhar por mais tempo [5]. A diretiva TimeOut do Apache vale 60 segundos na documentação atual da versão 2.4, enquanto o manual do PHP ainda cita 300 segundos para Apache e IIS: confira o valor que sua hospedagem usa de fato [6][2]. Se o site estiver atrás do Cloudflare, o proxy espera 125 segundos por uma resposta e depois mostra o erro 524; só os planos Enterprise podem aumentar esse prazo, até 6.000 segundos [7].
| Camada | Configuração | Padrão | O que você vê |
|---|---|---|---|
| PHP | max_execution_time | 30 s (CLI: ilimitado) | Fatal error: Maximum execution time exceeded |
| PHP-FPM | request_terminate_timeout | 0 (desligado) | Processo encerrado no meio da requisição |
| nginx | fastcgi_read_timeout | 60 s entre duas leituras | Tempo limite do gateway esgotado |
| Apache | TimeOut | 60 s | A requisição termina com erro |
| Cloudflare | Proxy Read Timeout | 125 s | Erro 524 |
Limites publicados por cinco hospedagens
Cada empresa documenta seus limites num lugar diferente, e algumas não deixam mudar nada. Estes valores vêm da documentação de cada uma, consultada em 1º de novembro de 2026. A Kinsta permite 300 segundos na maioria dos planos e 600 segundos nos maiores [8]. A WP Engine define 60 segundos, aceita apenas valores menores e pede que tarefas mais longas sejam divididas em lotes [9]. A Hostinger informa 360 segundos nos planos web e 480 segundos nos planos cloud [10].
Na netcup o valor depende do plano: você não pode alterá-lo, e o suporte também não [11]. Webhosting 1000, 2000, 4000 e 8000 informam 180 segundos cada; de memória, são 128 MB no Webhosting 1000, 512 MB no 2000 e no 4000 e 1024 MB no 8000 [12][13][14][15]. A SiteGround lista max_execution_time entre as configurações que não podem ser alteradas nos servidores compartilhados; nos planos Cloud, o suporte pode ajustá-la [16].
| Hospedagem | Limite de execução | O que a empresa diz |
|---|---|---|
| Kinsta | 300 s; 600 s nos maiores planos | Conforme o plano |
| WP Engine | 60 s | Só pode ser reduzido |
| Hostinger | 360 s web, 480 s cloud | Conforme o tipo de plano |
| netcup Webhosting | 180 s (de 1000 a 8000) | Preso ao plano, o suporte não altera |
| SiteGround compartilhado | Sem número na base de ajuda | Fixo no compartilhado; Cloud pelo suporte |
Atrás do Cloudflare, isso quer dizer que, mesmo com 360 ou 600 segundos de tempo de PHP, uma requisição que passa pelo proxy termina aos 125 segundos [7].
Por que aumentar o limite raramente salva um backup Multisite
Um backup de rede basicamente lê arquivos, consulta o banco de dados e grava arquivos compactados. No Linux, boa parte disso costuma ser espera, não execução; por isso o contador do PHP pode estar longe do limite quando o nginx ou o Cloudflare já fecharam a conexão [1][5][7]. Subir max_execution_time de 30 para 300 segundos não muda nada visível: o navegador continua recebendo um erro de gateway, e o processo PHP talvez siga rodando sem que ninguém perceba.
A saída robusta é manter cada requisição curta e retomar o trabalho na seguinte. A WP Engine recomenda exatamente isso para tarefas acima de 60 segundos [9], e é assim que funcionam as ferramentas de backup em partes. Para trabalhos pesados e pontuais resta a linha de comando: a CLI não tem limite de tempo por padrão e não há proxy no caminho [3]. Para requisições que passam com frequência de 125 segundos, o Cloudflare sugere um subdomínio no modo somente DNS, que contorna o proxy [7].
Como o Multisite Migrate dimensiona suas etapas
Criamos o Multisite Migrate justamente para esse tipo de hospedagem, então aqui está o comportamento do plugin, tirado direto do seu código-fonte público. Cada etapa em segundo plano disparada pelo navegador recebe um orçamento de tempo calculado a partir do max_execution_time do servidor, que nunca passa de 15 segundos; o comentário no código explica o motivo: proxies compartilhados costumam derrubar requisições aos 30 segundos [18]. Sem limite no servidor, o plugin também usa 15 segundos por etapa.
Antes de cada etapa, o worker chama ignore_user_abort(true), para que fechar a aba não corte uma etapa ao meio. No WP-CLI, no WP-Cron e na linha de comando, ele remove o limite com set_time_limit(0); nas requisições do navegador, ajusta o limite ao valor do servidor, com mínimo de 10 segundos [19]. A tela Saúde do plugin mostra um aviso quando max_execution_time é maior que zero, mas menor que 30 segundos [20].
| max_execution_time do servidor | Orçamento por etapa |
|---|---|
| 0 (ilimitado) | 15 s |
| 8 s | 7 s |
| 10 s | 7 s |
| 20 s | 12 s |
| 30 s ou mais | 15 s |
Confira seus limites reais em cinco minutos
Não confie num valor lido na linha de comando. O WP-CLI usa a CLI do PHP, cujo limite padrão é 0; por isso wp eval costuma mostrar 0 mesmo quando as requisições web param aos 30 segundos [3]. Nosso próprio servidor mostrava exatamente isso na CLI: max_execution_time => 0. Leia o valor web, na tela Saúde do site do WordPress (aba de informações, seção do servidor, linha do limite de tempo do PHP) ou com um pequeno arquivo temporário como o abaixo.
- Abra o arquivo uma vez no navegador, anote o SAPI e o limite e depois apague-o.
fpm-fcgisignifica PHP-FPM atrás de nginx ou Apache: pergunte à hospedagem o valor defastcgi_read_timeoutou deTimeOut.- Um valor 0 no navegador quer dizer que o PHP não tem limite, mas os proxies continuam valendo.
- No painel do Cloudflare, veja se o registro passa pelo proxy (nuvem laranja).
- Se
set_time_limitestiver desativada, os plugins não conseguem estender seu tempo durante a execução.
<?php
header('Content-Type: text/plain');
echo 'SAPI: ', PHP_SAPI, "\n";
echo 'max_execution_time: ', ini_get('max_execution_time'), "\n";
echo 'set_time_limit: ', function_exists('set_time_limit') ? 'available' : 'disabled', "\n"; Diagnóstico pela mensagem de erro
O texto do erro revela qual camada parou a requisição, e é isso que define a correção. Aumentar um valor do PHP nunca resolve um timeout de proxy, e pedir um timeout de proxy maior não ajuda quando o próprio PHP é o limite [17].
| O que você vê | Camada provável | Próximo passo |
|---|---|---|
Maximum execution time of N seconds exceeded | PHP | Aumentar o limite se a hospedagem permitir, ou etapas menores |
| 504 após cerca de 60 s | nginx ou Apache | Pedir o timeout de leitura, ou etapas menores |
| Erro 524 após cerca de 125 s | Cloudflare | Etapas mais curtas, WP-CLI ou subdomínio somente DNS |
| 502 após um número redondo de segundos | PHP-FPM | Verificar request_terminate_timeout no pool |
| Nenhum erro, a tarefa empaca | Disparo em segundo plano | Verificar o WP-Cron e as requisições de loopback |
Checklist antes de um backup de rede grande
- Ler o valor web de
max_execution_time, não o da CLI. - Conhecer o teto documentado pela hospedagem e saber se você pode alterá-lo.
- Descobrir se há nginx, Apache ou Cloudflare na frente, e com qual timeout.
- Preferir uma ferramenta que avance em etapas de no máximo 15 segundos e retome após uma interrupção.
- Rodar trabalhos pontuais muito grandes pelo WP-CLI, se você tiver SSH.
- Depois do backup, abrir o log e confirmar que cada etapa foi concluída.
Como testamos
Em 1º de novembro de 2026 executamos um script de teste PHP com set_time_limit(2) em três variantes: sleep(5), um laço de cálculo infinito e sleep(3) seguido do laço. Uma função de encerramento exibia o tempo real medido com microtime(true). Linux: servidor de produção com PHP 8.5.12 CLI, compilação não thread-safe, Zend Max Execution Timers desativados. Windows: PC de mesa com PHP 8.2.12 CLI, compilação thread-safe. Cada variante rodou três vezes por sistema; a tabela mostra a mediana, e as execuções variaram no máximo 0,04 segundo. Não testamos SAPIs web nem uma compilação Linux com Zend Max Execution Timers. Os limites vêm apenas das páginas das próprias hospedagens, consultadas no mesmo dia; o comportamento do plugin, do código-fonte público do Multisite Migrate 1.2.24.
Fontes
Guias e comparações relacionados
Crie grátis o seu primeiro backup restaurável da rede.