Le message exact est de la forme Fatal error: Maximum execution time of 30 seconds exceeded in /chemin/vers/un-fichier.php on line 123. PHP a arrêté un script qui dépassait la durée autorisée par le réglage max_execution_time. On le rencontre pendant un import, une sauvegarde, une mise à jour ou sur une page qui appelle un service extérieur. La tentation est de relever la limite et de passer à autre chose : c’est parfois nécessaire, rarement suffisant.
Ce que le message vous apprend
Le fichier cité est l’endroit où PHP se trouvait quand le temps s’est écoulé, pas forcément le responsable. Si c’est un fichier de wp-includes lié aux requêtes HTTP, le script attendait un service extérieur. Si c’est un fichier de base de données, une requête était trop lourde. Si c’est le fichier d’un plugin, regardez d’abord ce plugin.
Ne pas confondre avec les délais du serveur
- Une erreur 504 vient du serveur web, par exemple Nginx avec fastcgi_read_timeout, qui abandonne avant PHP.
- Une erreur 524 vient de Cloudflare, qui coupe toute réponse au-delà de 100 secondes sur la plupart des offres.
- Relever max_execution_time ne sert à rien si l’une de ces deux limites tombe avant.
Étape 1 : trouver ce qui est lent
Installez le plugin Query Monitor sur une préproduction : il affiche les requêtes SQL lentes, les appels HTTP sortants et leur durée, ainsi que le plugin à l’origine de chacun. Dans la grande majorité des cas, on trouve l’une de ces quatre causes :
- un appel à un service extérieur qui ne répond pas, sans délai maximal défini ;
- un import ou un export qui traite des milliers de lignes en une seule requête ;
- une requête SQL sans index sur une grosse table, souvent wp_postmeta ;
- les tâches planifiées de wp-cron qui s’exécutent pendant la visite d’un internaute.
Étape 2 : relever la limite au bon endroit
Pour un traitement légitimement long, relevez la limite là où votre hébergement la lit. Le plus fiable est la configuration PHP, dans php.ini ou dans le panneau de votre hébergeur :
max_execution_time = 120
Sur un serveur Apache avec mod_php, la même valeur peut aller dans .htaccess. Évitez en revanche set_time_limit() dans wp-config.php : beaucoup d’hébergements l’ignorent, et cela relève la limite pour tout le site. Réservez set_time_limit() au début d’un traitement précis que vous savez long.
php_value max_execution_time 120
Étape 3 : corriger la cause
Donner un délai maximal aux appels extérieurs
Un service tiers en panne ne doit jamais bloquer votre site. Fixez un délai court sur chaque appel HTTP :
$response = wp_remote_get( $url, array( 'timeout' => 10 ) );
Passer les gros traitements en ligne de commande ou en lots
WP-CLI n’a pas de limite de temps d’exécution par défaut : lancez les imports, les régénérations de miniatures et les migrations en ligne de commande. Pour les traitements déclenchés depuis le site, découpez-les en petits lots avec Action Scheduler, la file de tâches utilisée par WooCommerce.
wp media regenerate --only-missing
wp import fichier.xml --authors=skip
Sortir wp-cron des visites
Par défaut, wp-cron s’exécute pendant la visite d’un internaute. Désactivez ce déclenchement et confiez-le à une vraie tâche planifiée du serveur, toutes les cinq minutes :
define( 'DISABLE_WP_CRON', true );
*/5 * * * * wp cron event run --due-now --path=/var/www/html
Questions fréquentes
Quelle valeur choisir pour max_execution_time ?
30 à 60 secondes suffisent pour un site en bonne santé. Au-delà de 120 secondes, un traitement relève de la ligne de commande ou d’une file de tâches, pas d’une page web.
L’erreur apparaît seulement pendant les mises à jour, est-ce grave ?
Une mise à jour interrompue peut laisser un plugin ou WordPress à moitié installé. Relancez-la en ligne de commande avec WP-CLI, puis vérifiez l’intégrité des fichiers. Notre service de maintenance WordPress fait ces mises à jour en préproduction avant de les appliquer.
Auteur
Walid SadfiWalid Sadfi est le fondateur d'Evolurise, une équipe d'ingénieurs déployés chez ses clients : développement sur mesure (WordPress, Drupal, React, Laravel), agents IA, DevOps et formation des équipes. Fort de 8 ans d'expérience, il accompagne PME et grands comptes, de la compréhension du problème au déploiement de la solution. Il partage sur ce blog des retours de terrain concrets.