Come appare il messaggio
PHP Fatal error: Maximum execution time of 30 seconds exceeded in /var/www/html/wp-admin/includes/class-wp-upgrader.php on line 214Cause frequenti
- Una query lenta, un'API esterna lenta oppure un'importazione o esportazione grande.
- Il compito è semplicemente più grande del limite predefinito: aggiornamenti, backup, lotti di immagini.
- Un ciclo infinito o un'attesa di qualcosa che non arriva.
- Il limite è stato alzato per PHP ma nginx o un proxy interrompe prima (allora vedi 504).
- La riga di comando non ha limite (predefinito 0), quindi il problema compare solo nel browser.
Verifica
- Quale limite usa PHP-FPM?
grep -rn 'max_execution_time' /etc/php/*/fpm/ - Controlla il valore attivo dal punto di vista del web server
php-fpm8.3 -i | grep -i max_execution_time - Il timeout del web server è più corto?
nginx -T 2>/dev/null | grep -E 'fastcgi_read_timeout|proxy_read_timeout'
Soluzione
- Trova la parte lenta (query, chiamata API) e velocizzala. È la vera soluzione.
- Alza il limite dove serve:
max_execution_time = 120nelphp.inidi FPM, oppurephp_admin_value[max_execution_time] = 120nel pool, poi ricarica PHP-FPM. - Alza di conseguenza
fastcgi_read_timeoutin nginx, altrimenti gli utenti ricevono prima un 504. - Esegui i compiti lunghi come cron job, worker di coda o comando CLI invece che in una richiesta web.
- Nel tuo codice chiama
set_time_limit()solo per lo script che ne ha bisogno.
Scenario tipico
Aggiorni dieci plugin di WordPress in una volta su un piccolo VPS. Dopo 30 secondi PHP si ferma con "Maximum execution time exceeded" in class-wp-upgrader.php e il sito mostra poi in modo permanente "Briefly unavailable for scheduled maintenance". WordPress ha creato il file .maintenance nella cartella principale e, a causa dell'interruzione, non l'ha più rimosso. Controlla prima se quel file esiste e cancellalo se nessun aggiornamento è più in corso.
Domande frequenti
Perché ricevo ancora un 504 dopo aver alzato max_execution_time?
nginx ha un limite proprio, di default 60 secondi. Vedi upstream timed out (110).
Un limite molto alto è sicuro?
Un limite lungo lascia che una richiesta bloccata occupi a lungo un worker. Tienilo basso quanto consente il compito reale.
Il tempo delle query al database e di sleep() viene contato?
Non su Linux. max_execution_time misura solo il tempo in cui lo script lavora davvero. Le attese in chiamate di sistema, query al database o stream di rete non contano. Uno script che per lo più aspetta può quindi durare molto più di 30 secondi.
Posso cambiare il limite dall'interno dello script?
Sì, con set_time_limit(120) o ini_set('max_execution_time', '120'); il contatore riparte. Non funziona se la funzione è in disable_functions o se l'hosting impone il limite, e non aiuta contro i timeout di nginx. Una barra di avanzamento o una richiesta di stato via AJAX rende i compiti lunghi più sopportabili per gli utenti.
Come evito l'errore in modo definitivo per importazioni grandi?
Dividi il lavoro in piccoli blocchi con indicatore di avanzamento, oppure eseguilo da cron, da un worker di coda o da WP-CLI, dove non c'è timeout del web server. Un limite più alto rimanda solo il problema quando i dati continuano a crescere.