Erreur lors de la mise à jour de WordPress, « cURL operation timed out »

Si, lors de la mise à jour de WordPress depuis le tableau de bord, vous obtenez une erreur semblable à celle-ci :

Le téléchargement a échoué.: cURL error 28: Operation timed out after 

L'erreur cURL 28 confirme que la requête ne s'est pas terminée dans le délai autorisé. Elle n'indique pas à elle seule si c'est la résolution DNS, la connexion, le téléchargement ou la réponse de la destination qui a échoué.

1. Identifiez la requête

Notez le message complet, l'heure, la durée indiquée et l'URL distante si elle apparaît. Répétez une seule fois la même mise à jour pour confirmer que l'erreur est toujours d'actualité. Query Monitor peut afficher l'URL et la durée dans HTTP API Calls lorsque la requête s'exécute pendant le chargement d'une page du tableau de bord.

N'attendez pas 24 heures comme première mesure : une nouvelle tentative rapide permet de repérer un échec passager, mais s'il se reproduit, vous devez conserver les données de cette requête.

2. Vérifiez depuis le serveur

Demandez au fournisseur de tester la même URL depuis l'environnement qui exécute PHP et de vérifier le DNS, la connectivité sortante et les temps de réponse. Un test depuis votre navigateur passe par un autre réseau et ne représente pas la connexion du serveur.

• Si plusieurs URL externes échouent depuis le serveur, vérifiez d'abord la connectivité, le DNS ou le proxy sortant.
• Si une seule destination échoue, conservez son URL et sa réponse pour que son fournisseur puisse l'examiner.
• Si le test depuis le serveur fonctionne mais que WordPress échoue, vérifiez si un plugin ou une constante modifie l'API HTTP et répétez la même requête avant et après un changement contrôlé.

3. Ne vérifiez ModSecurity que si c'est pertinent

ModSecurity inspecte les requêtes qui arrivent sur le serveur. Un délai dépassé lors d'un téléchargement depuis un serveur externe ne prouve pas un blocage par ModSecurity. Consultez son journal d'audit uniquement si l'URL concernée revient vers votre propre site, comme une requête loopback, et s'il existe un événement à la même heure et sur le même chemin.

Si un blocage apparaît, identifiez la règle exacte et demandez une exclusion limitée à cette règle et à ce chemin. Ne laissez pas ModSecurity désactivé pour mettre à jour WordPress.

Vérification

Relancez la mise à jour et confirmez que la même URL aboutit correctement. Vérifiez qu'aucune nouvelle erreur cURL 28 n'apparaît et rétablissez tout plugin ou mesure temporaire utilisé pendant l'isolement.

Si la mise à jour est restée inachevée

Vérifiez si l'échec s'est produit pendant le téléchargement ou après le début du remplacement des fichiers. En cas de mise à jour partielle, examinez son état avant d'en lancer une autre en parallèle. Un téléchargement terminé ne confirme pas que la nouvelle version a été installée et activée correctement.

Augmenter un délai n'a de sens que si la requête progresse et a besoin de plus de temps ; cela ne corrige ni le DNS, ni une connexion bloquée, ni une destination qui ne répond pas. Ne désactivez pas la validation TLS : l'erreur 28 de délai et l'erreur 60 de certificat sont des problèmes différents.