Les tests de compatibilité PHP WordPress consistent à vérifier si votre plugin se comporte correctement sur chaque combinaison de versions PHP et WordPress que vous supportez. Avec un sandbox WordPress sur wp.run, vous pouvez lancer des installations de test propres, comme PHP 8.4 avec WordPress 6.9, puis répéter le même test de fumée sans serveurs locaux ni risque en production.
Pourquoi la compatibilité PHP WordPress nécessite une matrice
Un plugin peut passer sur un stack et échouer sur un autre. Les changements PHP peuvent exposer de la syntaxe obsolète, un typage plus strict, des fonctions supprimées, ou des avertissements qui n’apparaissaient pas sur un ancien environnement d’exécution. Les changements WordPress peuvent affecter le comportement de l’éditeur, les hooks, les endpoints REST et les écrans d’administration.
| Dimension | Ce qu’il faut décider | Exemple |
|---|---|---|
| Versions WordPress | Version actuelle, précédente et suivante que vous supportez | WordPress 6.9 et 6.8 |
| Versions PHP | La plus ancienne supportée, la cible par défaut, la cible la plus récente | PHP 8.1, 8.4, 8.5 |
| État du plugin | Nouvelle installation, chemin de mise à jour, dépendances actives | Installation propre plus WooCommerce |
| Profondeur du test | Test de fumée, test admin, test front-end, test de désinstallation | Activer, configurer, utiliser, désactiver |
Construisez une petite matrice PHP x versions WordPress
Commencez par la matrice la plus petite qui répond à une vraie question de version — trois lignes : le stack le plus ancien supporté, le plus récent recommandé et le stack le plus nouveau.
Sur wp.run, utilisez des URLs de lancement pour des tests reproductibles :
https://wp.run/new?php=8.4&wp=6.9Ajoutez le paramètre plugin pour les presets :
https://wp.run/new?plugin=woocommerce&php=8.4&wp=6.9Comment tester la compatibilité du plugin avec PHP 8.4 sur wp.run
- Lancez le stack cible. Appuyez sur Lancer WordPress, choisissez PHP 8.4 et la version WordPress, créez le sandbox.
- Confirmez l’environnement. Ouvrez wp-admin, vérifiez Outils → Santé du site → Informations pour les versions PHP et WordPress.
- Installez ou activez le plugin. Chargez un preset depuis un paramètre d’URL de lancement, ou téléchargez le ZIP de votre plugin dans wp-admin.
- Exécutez la vérification d’activation. Surveillez les erreurs fatales, avis d’administration, dépendances manquantes, boucles de redirection et échecs de l’assistant de configuration.
- Exercez la fonctionnalité principale. Exécutez le plus petit flux de travail réel que le plugin est censé supporter.
- Vérifiez les surfaces admin et front-end. Ouvrez l’éditeur de blocs, les paramètres du plugin, la sortie de la page publique, les endpoints REST et la console du navigateur.
- Répétez sur le stack suivant. Lancez la version PHP ou WordPress suivante et exécutez la même liste de contrôle, en changeant une dimension à la fois.
Ajoutez un scan statique, mais ne vous arrêtez pas là
Utilisez les deux signaux ensemble :
- Scan statique d’abord. Trouvez les fonctions supprimées, signatures obsolètes et syntaxe PHP spécifique à une version.
- Test en sandbox ensuite. Confirmez que le plugin démarre, affiche son interface et complète son flux de travail réel sur le stack cible.
- Note de régression en dernier. Enregistrez ce qui a échoué, les versions exactes et si le problème est un avertissement, une erreur fatale, une interface cassée ou un problème de données.
Ce qu’il faut vérifier lors des tests de versions WP
- Activation et désactivation. Le plugin doit s’activer et se désactiver proprement.
- Chemin de mise à jour. Installez la version précédente, créez des données exemples, puis mettez à jour et confirmez que les migrations s’exécutent.
- Écrans admin et éditeur. Testez chaque menu que le plugin ajoute sur toutes les versions WordPress.
- Sortie front-end. Confirmez que les modèles, shortcodes, formulaires ou widgets s’affichent correctement.
- REST, AJAX et tâches planifiées. Testez les requêtes d’endpoint et le comportement dépendant des crons.
- Hygiène de désinstallation. Désactivez et supprimez dans un sandbox jetable pour vérifier le comportement de nettoyage.
Une matrice pratique pour la version d’un plugin
| Ligne de test | PHP | WordPress | Build du plugin | Objectif |
|---|---|---|---|---|
| Support de base | 8.1 | 6.8 | Candidat à la version | Confirmer que le runtime le plus ancien supporté fonctionne toujours |
| Cible actuelle | 8.4 | 6.9 | Candidat à la version | Confirmer que le stack de démo et de support par défaut fonctionne |
| Vérification la plus récente | 8.5 | 7.0 | Candidat à la version | Trouver les problèmes précoces avant que les utilisateurs ne les rencontrent |
| Chemin de mise à jour | 8.4 | 6.9 | Précédent → candidat à la version | Confirmer que les paramètres et données migrent proprement |
Échecs de compatibilité courants à surveiller
- Erreur fatale à l’activation. Fonctions PHP supprimées, classes manquantes ou problèmes de chargement automatique des dépendances.
- Avertissements sur PHP plus récent. Propriétés dynamiques, arguments nullables, signatures obsolètes.
- Rupture de l’éditeur. Le plugin fonctionne en front-end mais l’éditeur de blocs échoue sur WordPress plus récent.
- Échecs AJAX, REST ou de mise à jour. Gestion des nonces, enregistrement des routes ou tables personnalisées.
- Conflits de dépendances. Deux plugins embarquant des versions incompatibles d’une bibliothèque partagée.
Questions fréquentes
Qu’est-ce que la compatibilité PHP WordPress ? La capacité de WordPress core, d’un plugin ou d’un thème à fonctionner correctement sur une version PHP spécifique. Les plugins doivent être testés dans un vrai environnement WordPress.
Comment tester un plugin sur PHP 8.4 ? Lancez un sandbox wp.run avec PHP 8.4, confirmez dans Santé du site, installez le plugin, exécutez les vérifications d’activation, admin, éditeur, front-end et désinstallation.
La compatibilité de WordPress core signifie-t-elle que mon plugin est aussi compatible ? Non. WordPress core peut être compatible tandis qu’un plugin échoue toujours à cause de son propre code, de ses dépendances ou de son interface admin.
Combien de combinaisons PHP et WordPress dois-je tester ? Testez la plus ancienne que vous supportez, la version par défaut actuelle et la plus récente. Ajoutez des lignes pour les chemins de mise à jour ou les environnements signalés par les clients.