Problèmes après la mise à jour vers WordPress 5.x

Note historique : ce guide concerne le passage de WordPress 4.x à 5.x. Pour une installation actuelle, utilisez des versions compatibles et maintenues de WordPress, de PHP, des thèmes et des plugins.

Qu'une erreur apparaisse après une mise à jour ne prouve pas à lui seul que WordPress ou un plugin en soit la cause. Reproduisez le symptôme une fois et consultez l'erreur enregistrée à ce moment précis.

Diagnostic

1. Faites une sauvegarde avant de modifier des composants.
2. Reproduisez l'action qui échoue et notez l'heure et l'URL.
3. À partir de WordPress 5.2, consultez aussi l'e-mail de récupération ; dans les versions antérieures, cette fonction n'existe pas. Consultez le journal PHP. Si vous n'en avez pas, activez temporairement le journal privé de débogage.
4. Notez la première erreur fatale de la requête, avec le fichier, la ligne et le composant mentionné.

Un fichier situé dans wp-content/plugins/ ou wp-content/themes/ identifie le composant qui était en cours d'exécution, mais il reste à vérifier s'il est obsolète, s'il existe une incompatibilité documentée ou s'il a reçu des données invalides d'un autre composant.

Appliquer la correction la plus ciblée

• Mettez d'abord à jour le composant signalé et consultez ses prérequis WordPress et PHP.
• Si vous ne pouvez pas accéder à wp-admin, utilisez le mode de récupération. Comme mesure réversible, vous pouvez renommer uniquement le dossier du plugin identifié et recharger la même URL.
• Si le journal ne désigne aucun composant, reproduisez le problème en staging et effectuez un test de conflit : passez temporairement à un thème par défaut et désactivez les plugins par groupes.

Un test ne confirme le lien que si la même action échoue avec le composant actif et fonctionne lorsqu'il est désactivé. Rétablissez ensuite la configuration d'origine et cherchez une mise à jour ou un correctif de l'éditeur.

Consultez aussi Santé du site pour détecter les prérequis non satisfaits, mais ne considérez pas chaque recommandation comme la cause de l'erreur.

Changements de l'éditeur et contenu ancien

Le passage à WordPress 5 a introduit l'éditeur de blocs, mais un changement d'interface n'équivaut pas à une erreur PHP. Si le problème survient lors de la modification d'un article, conservez une révision, examinez la Console et l'onglet Réseau, et vérifiez la compatibilité du thème et des plugins avec l'éditeur utilisé.

Ne convertissez pas en masse le contenu ancien et ne rétrogradez pas le noyau pour résoudre un seul écran. Testez d'abord une copie représentative, conservez ses révisions et vérifiez que le contenu public garde sa mise en page, ses liens et ses images après le changement.