Créez votre site WordPress avec Elementor.Découvrir Elementor Lien partenaire

LANGUES DE BLOGPASCHER

Langues de ce guide

Ouvrez une autre édition du guide ou consultez une archive.

Éditions de ce guide

Archives disponibles

Traductions prévues (32)
  • Englishanglais
  • Españolespagnol
  • Deutschallemand
  • Portuguêsportugais
  • Italianoitalien
  • Nederlandsnéerlandais
  • Polskipolonais
  • Українськаukrainien
  • Češtinatchèque
  • Slovenčinaslovaque
  • Hrvatskicroate
  • Românăroumain
  • Magyarhongrois
  • Ελληνικάgrec
  • Türkçeturc
  • العربيةarabe
  • עבריתhébreu
  • हिन्दीhindi
  • বাংলাbengali
  • ไทยthaï
  • Tiếng Việtvietnamien
  • Bahasa Indonesiaindonésien
  • 简体中文chinois simplifié
  • 日本語japonais
  • 한국어coréen
  • Danskdanois
  • Svenskasuédois
  • Norsknorvégien
  • Suomifinnois
  • Eestiestonien
  • Latviešuletton
  • Lietuviųlituanien

Apparence du site

Installation et environnement · Débutant à intermédiaire

Prérequis WordPress non satisfaits : vérifier PHP et MySQL ou MariaDB

WordPress refuse les prérequis du serveur ? Comparez le PHP du domaine, les modules chargés et la version MySQL ou MariaDB réellement utilisée.

Publié le · Mis à jour le · Méthode éditoriale

Lire le prérequis qui bloque réellement WordPress

Vous ouvrez l’installation ou une mise à jour de WordPress, et un message indique une version PHP insuffisante, une base trop ancienne ou une extension PHP absente. Le but est d’obtenir un environnement compatible avec la version prévue, sans contourner le contrôle ni effacer une installation existante.

PHP est le moteur qui exécute WordPress. MySQL ou MariaDB est le service qui conserve ses données. Une extension PHP est un module du moteur, différent d’une extension installée dans le tableau de bord WordPress. Ces trois éléments demandent des vérifications distinctes.

Copiez le texte exact du refus avec la version de WordPress concernée et l’heure. Ne retenez pas seulement « serveur incompatible » : le message peut préciser le composant et le seuil attendu. Une erreur de connexion à la base ne prouve pas, à elle seule, que sa version est trop ancienne.

Ne modifiez pas les fichiers du cœur pour supprimer le contrôle de version. Cela ferait disparaître un avertissement sans fournir les fonctions dont WordPress a besoin.

Protéger ce qui existe avant de relancer l’installation

Vérifiez si le domaine doit héberger un site neuf ou retrouver un site qui contenait déjà des données. Si des articles, comptes ou commandes existaient, ne poursuivez pas l’assistant comme une nouvelle installation. Faites confirmer la bonne base, le bon répertoire et le contexte de la mise à jour.

Conservez les fichiers et une sauvegarde de la base dans un stockage privé avant une évolution d’environnement. Vérifiez leurs dates et la possibilité de les restaurer. Un téléchargement du répertoire du site n’inclut pas automatiquement les données MySQL ou MariaDB.

Notez les versions et réglages actuels ainsi que les autres sites qui utilisent le même compte. Un changement de PHP ou de service de base peut avoir une portée partagée. Préparez le retour avec le prestataire ; un retour de version de base n’est pas un simple bouton garanti.

Si vous préparez une copie de test, assurez sa séparation de base et protégez son accès. Neutralisez courriels, paiements et automatismes externes avant de l’utiliser. Une adresse de préproduction ne suffit pas à rendre les essais sans effet sur l’activité.

Identifier l’offre, les droits et l’environnement

Sur WordPress autohébergé, utilisez le compte d’hébergement autorisé ou l’assistance du prestataire. Le rôle administrateur dans WordPress ne donne pas nécessairement le droit de modifier les moteurs. Si vous gérez seulement les contenus, transmettez le message au responsable sans demander son mot de passe.

Notez le domaine, la racine documentaire et l’offre qui les héberge. La racine documentaire est le répertoire publié pour ce domaine. Une installation peut utiliser une version PHP différente de celle d’un autre site du compte, ou hériter d’un réglage commun.

Sur WordPress.com, les moteurs sont gérés par la plateforme et cPanel ne s’applique pas. Une option PHP peut néanmoins être disponible pour votre site. Préparez les sauvegardes et la copie avant ce parcours. Si l’option manque ou si le moteur de base est en cause, contactez l’assistance du site concerné.

En multisite, associez le responsable du réseau. Les fichiers, la configuration et les composants partagés peuvent rendre une modification utile pour un site mais problématique pour les autres.

  1. Ouvrez le tableau de bord d’hébergement WordPress.com et choisissez le titre du bon site.
  2. Ouvrez Settings, puis la section Server et la rubrique PHP. Relevez la version initiale.
  3. Choisissez une version disponible, maintenue et compatible avec vos thèmes et extensions ; utilisez d’abord la copie préparée.
  4. Cliquez sur Save, puis contrôlez le site et ses fonctions dans ce même environnement.
  5. En cas d’incompatibilité, revenez par le même chemin à la version initiale seulement si elle est encore proposée et supportée. Sinon, appliquez le retour préparé avec l’assistance.

Comparer le PHP du domaine et celui du terminal

Si WordPress répond encore, ouvrez Outils → Santé du site → Informations et relevez les valeurs des rubriques Serveur et Base de données. Si le refus arrive avant l’installation, demandez le relevé correspondant au domaine ou au sous-domaine concerné dans le panneau d’hébergement. Notez l’adresse et, si plusieurs sites partagent le compte, le répertoire et le gestionnaire PHP indiqués. Le PHP choisi pour un domaine peut différer du PHP sélectionné pour un sous-domaine, une tâche planifiée ou le terminal.

Avec un accès au terminal, php -v indique la version du PHP exécuté par cette commande. php -m indique les modules chargés par ce PHP et php --ini aide à identifier sa configuration. Gardez ces relevés pour la comparaison avec le domaine. Même si le numéro de version est identique, la configuration et les modules peuvent différer. Demandez au prestataire de confirmer le module requis dans le processus qui sert le site, surtout lorsque l’erreur cite mysqli et que le terminal le voit déjà. Utilisez les diagnostics privés du panneau. Une page d’information PHP accessible sur le site peut exposer des détails d’environnement inutiles au diagnostic public.

Après un changement autorisé, refaites le même contrôle sur la copie et dans le même domaine. Le résultat attendu est la version sélectionnée dans la demande web, avec le module présent là où WordPress en a besoin. Si le panneau montre la nouvelle version mais que la demande échoue encore avec le même message, faites vérifier l’héritage, le gestionnaire et la configuration du domaine avant de changer un autre réglage. Pour annuler, remettez l’ancienne sélection et vérifiez de nouveau l’adresse concernée.

Vérifier la connexion et la version du serveur de base

Un module MySQLi chargé permet à PHP de tenter la connexion. Si le message indique un refus de connexion, vérifiez d’abord l’adresse de base déclarée et le service qui reçoit réellement la demande. Demandez à l’hébergeur de confirmer le serveur, le port ou le socket attendu et l’accès de l’installation. Un client SQL peut être installé sur la machine sans que le serveur attendu réponde. Une version du client PHP ou de phpMyAdmin ne donne pas la version du serveur.

Si vous avez accès à phpMyAdmin ou à un outil privé de votre hébergeur, ouvrez la connexion utilisée par l’installation. Sélectionnez la base attendue et lancez la requête de lecture suivante. Conservez la chaîne complète, qui permet de reconnaître MySQL ou MariaDB, et comparez-la aux exigences de la version de WordPress visée. Si le panneau vous connecte à une autre instance, demandez au prestataire un relevé depuis l’instance correcte avant de choisir une mise à niveau.

SELECT VERSION() AS version_serveur;

Séparer minimum accepté, recommandation et support

Un contrôle d’installation vérifie les seuils de la version WordPress utilisée. Les recommandations d’hébergement visent un environnement plus adapté à l’exploitation actuelle. Enfin, le cycle de support du moteur détermine si sa branche reçoit encore des corrections. Satisfaire un minimum ancien ne répond pas automatiquement à ces trois besoins.

Au 3 novembre 2026, la page officielle des recommandations WordPress indique PHP 8.3 ou supérieur, MariaDB 10.11 ou supérieur, ou MySQL 8.0 ou supérieur, ainsi que HTTPS. Ces repères sont à recontrôler avant une évolution future. Ils ne constituent pas une garantie de compatibilité pour chaque extension.

Choisissez avec le prestataire une branche maintenue et compatible avec la version WordPress cible et vos composants. La version la plus élevée proposée n’est pas nécessairement le meilleur premier essai pour un ancien site. Une branche en correctifs de sécurité seuls ne possède pas le même horizon qu’une branche en support actif.

Gardez le minimum exact annoncé par votre installation pour expliquer le refus. Ne réutilisez pas les numéros d’un ancien tutoriel comme recommandation de déploiement.

Comparez aussi la ligne de votre version WordPress cible dans la matrice officielle PHP/WordPress. Une combinaison supportée par le cœur ne valide pas tous vos thèmes et extensions. Notez donc trois conclusions séparées dans votre relevé : seuil du refus, compatibilité de la version cible et durée de maintenance de la branche PHP retenue.

Choisir entre activation, évolution préparée et migration

La première approche convient lorsque l’offre possède déjà les versions et modules nécessaires, mais que le domaine utilise un ancien réglage. Elle peut répondre à une installation neuve après vérification du répertoire et de l’absence de données à préserver.

La deuxième prépare l’évolution d’un site existant ou du service de base. Elle demande une copie de test, des sauvegardes et un retour documenté. Elle est nécessaire lorsque les données et composants actuels doivent suivre le changement, même si le panneau offre un bouton très simple.

La troisième devient pertinente si le prestataire confirme que l’offre ne peut pas fournir un environnement compatible et maintenu. Il faut alors préparer un transfert ou une autre offre adaptée, sans changer les DNS avant de vérifier la destination.

Commencez sans installer de nouvelle extension WordPress. Un plugin ne met pas à niveau le serveur MySQL et ne remplace pas un module PHP absent au démarrage. Le panneau et l’assistance de l’hébergement sont les premiers moyens de correction.

Approche 1 : sélectionner le bon moteur pour le domaine

Cette manipulation convient si la bonne version est déjà disponible et si le site neuf ou la copie préparée peut l’utiliser. Le compte cPanel doit disposer des droits sur le domaine confirmé. Avant toute application, relevez la version initiale et l’héritage, puis vérifiez que leur rétablissement sera autorisé.

Ne sélectionnez pas tous les domaines du compte. Vérifiez les racines documentaires partagées et la portée avec le prestataire. Si la version nécessaire n’apparaît pas, elle n’est pas disponible pour ce compte ; ne remplacez pas cette sélection par une directive ajoutée dans le thème. MultiPHP Manager ne constitue pas non plus un écran universel d’installation de modules PHP. Relevez l’état PHP-FPM sans le changer pour cet essai ; le mode inherit ne permet pas d’activer PHP-FPM. Une intervention sur ce gestionnaire de processus peut affecter plusieurs domaines partageant la même racine.

Rouvrez le même contrôle d’installation ou Santé du site pour vérifier la version effective. Contrôlez ensuite l’accueil, une page intérieure et l’éditeur sur la copie. Si la version annoncée n’a pas changé, faites identifier le contexte avant une autre modification.

Pour annuler cet essai, revenez à la même ligne et rétablissez la version ou l’héritage initial noté, si ce choix est toujours autorisé, puis Apply et nouveau contrôle. Sinon, utilisez le retour préparé avec le prestataire ; le panneau ne garantit pas de rendre une ancienne branche disponible. Sur un site existant, le basculement en production suit seulement la préparation décrite plus loin. Ce retour PHP n’annule aucune mise à jour de fichiers ou de données effectuée en parallèle.

  1. Dans cPanel, ouvrez Software, ou Logiciel, puis MultiPHP Manager.
  2. Retrouvez le domaine exact. Notez la version PHP et l’éventuelle indication Inherited ; faites confirmer les racines partagées.
  3. Cochez seulement la ligne de ce domaine, puis choisissez la version validée dans PHP Version. Vérifiez une dernière fois la possibilité de retour.
  4. Cliquez sur Apply. Gardez l’état PHP-FPM relevé ; ne changez pas simultanément ce réglage pour cet essai.
  5. Rouvrez le contrôle d’installation ou Santé du site, puis vérifiez l’accueil, une page interne et l’éditeur. La version effective doit correspondre à la sélection.
  6. Si l’essai échoue, rétablissez la version ou l’héritage initial autorisé sur cette même ligne, puis Apply. Si ce choix a disparu, utilisez le retour prévu avec le prestataire.

Confirmer le module demandé avant de modifier l’installation

Le message de WordPress qui annonce une extension MySQL manquante peut désigner mysqli, le module PHP utilisé par une installation standard pour parler à MySQL ou MariaDB. Notez le message exact et le contexte web. Si vous pouvez changer les modules dans le panneau, demandez quel ensemble s’applique au PHP du domaine. Une case active pour un autre moteur PHP n’explique pas ce refus. Un site hébergé avec des réglages gérés doit faire contrôler ces valeurs par le prestataire.

Sur une copie, activez seulement le module demandé avec le mécanisme documenté pour l’offre, puis relancez le même contrôle. La disparition du message permet de passer à la vérification de la connexion. Si un nouveau message désigne une base injoignable ou un accès refusé, poursuivez avec les paramètres du service de base. La version du moteur se vérifie après une connexion réussie. Pour annuler l’essai, rétablissez la configuration du domaine que vous aviez relevée. Si l’installation utilise un mécanisme de base particulier fourni par son hébergeur, demandez quelles exigences s’y appliquent.

Approche 2 : préparer l’évolution d’un site existant

Créez avec le responsable une copie protégée qui reproduit les composants et les données utiles, puis préparez l’environnement cible. Vérifiez la base distincte et la neutralisation des effets externes avant de l’ouvrir. Une copie sur un moteur différent ne reproduit pas forcément toutes les conditions actuelles ; documentez ces différences.

Mettez les composants en conformité avec leurs exigences et leur procédure de mise à jour. Vérifiez la compatibilité de leurs versions avec PHP et WordPress prévus. Ne désactivez pas un composant essentiel puis ne considérez pas comme validé un site qui ne réalise plus sa fonction.

Testez d’abord le changement PHP isolément lorsqu’il est possible de le séparer. Une modification simultanée du thème, du moteur, de la base et des adresses empêcherait d’attribuer un échec à sa cause. Gardez une trace des étapes et du dernier état fonctionnel.

Si une incompatibilité apparaît, conservez son message et faites corriger ou remplacer le composant concerné dans ce contexte. Un ancien moteur non maintenu ne doit pas devenir une solution définitive simplement parce qu’il masque cette incompatibilité.

Confier la mise à niveau de la base au bon responsable

Le service MySQL ou MariaDB appartient souvent à l’infrastructure de l’hébergeur. Sur un compte partagé, sa mise à niveau peut dépasser votre seul site. Demandez la version cible, le chemin de mise à niveau prévu, la sauvegarde adaptée et la portée de l’intervention avant toute décision.

Changer la version de PHP ne met pas à niveau ce service de base. Inversement, migrer la base ne charge pas un module PHP absent. Gardez les deux vérifications séparées afin de savoir quel refus doit disparaître après chaque correction.

Une évolution de moteur de base peut modifier des structures internes et ne pas permettre un simple retour vers l’ancienne version. Le prestataire doit préparer une restauration ou un autre retour pris en charge. Ne vous contentez pas d’une promesse de « downgrade » sans explication des données préservées et de la fenêtre d’écriture.

MySQL et MariaDB sont deux produits distincts. Un passage de l’un à l’autre exige sa propre vérification de compatibilité et de transfert. Ne le traitez pas comme une modification de numéro dans le panneau, et n’exécutez pas une commande de conversion trouvée dans un forum.

Approche 3 : changer d’environnement si l’offre ne convient pas

Si le prestataire confirme qu’il ne peut pas fournir les versions ou modules nécessaires, demandez d’abord s’il peut déplacer le site vers un environnement compatible dans son service. Une autre offre ou un autre hébergement peut devenir nécessaire, mais la décision doit reposer sur la contrainte exacte.

Avant un achat ou un transfert, faites confirmer les moteurs réellement disponibles pour votre site, leur maintenance et les modules nécessaires. Vérifiez aussi les accès de migration, les sauvegardes, la capacité utile et la méthode de sortie. Une mention commerciale « compatible WordPress » ne décrit pas tous les besoins de vos composants.

Préparez la destination sans remplacer la production. Faites contrôler le site copié dans un accès protégé adapté, avec une base distincte et les effets externes neutralisés. Ne modifiez pas les DNS simplement pour découvrir si le transfert a réussi.

Gardez l’hébergement de départ et les sauvegardes jusqu’à validation. Si la nouvelle destination échoue, vous devez savoir comment revenir au service prévu et quelles données récentes risquent de manquer. Ne supprimez pas le compte d’origine dès que la première page s’affiche ailleurs.

Distinguer compatibilité et problèmes de transfert

Une destination aux bonnes versions peut encore présenter une erreur de connexion de base si les accès, la base sélectionnée ou son hôte ne correspondent pas. Utilisez alors le diagnostic de connexion à la base, en conservant les valeurs sensibles dans les outils privés du responsable.

Si l’assistant apparaît à la place d’anciens articles, arrêtez l’installation. Il faut confirmer les données et leur association, pas créer de nouvelles tables pour faire disparaître l’écran. Un prérequis satisfait ne prouve pas que la bonne base a été importée.

Si le navigateur télécharge un fichier PHP, faites contenir l’exposition possible par l’hébergeur et suivez le guide consacré à ce symptôme. La sélection d’une version récente ne garantit pas, à elle seule, que les demandes sont acheminées au moteur.

Après un transfert, vérifiez aussi les adresses et le certificat du domaine réellement utilisé. Une erreur de nom HTTPS et une exigence de version sont deux diagnostics différents. Ne désactivez pas la validation du certificat pour poursuivre la recette d’installation.

Refaire les contrôles sur une installation isolée

Pour préparer une recette isolée, consignez la version exacte de PHP, celle de WordPress et le serveur de base utilisé. Comparez ensuite le module MySQLi dans le terminal et dans le PHP web. Un même numéro de version peut correspondre à deux configurations différentes. Si le module manque côté web, le précontrôle WordPress peut renvoyer mysql_not_found même si le terminal le charge correctement. Il s’agit d’un scénario à vérifier, pas d’un résultat mesuré sur votre site.

Une fois le module confirmé côté web, vérifiez séparément la connexion à l’instance attendue puis sa version avec la requête de lecture donnée plus haut. Une erreur MySQLi 2002 indique un problème de connexion à préciser par son message complet ; elle ne démontre pas une base trop ancienne. La version de mysqlnd décrit le client PHP, tandis que SELECT VERSION() renseigne le serveur atteint. Notez les deux sans les confondre et appliquez les exigences propres à MySQL ou MariaDB selon le produit réellement utilisé.

Pour refaire la vérification sur votre copie, consignez séparément trois résultats. Relevez d’abord le PHP du domaine et les modules requis. Confirmez ensuite que la connexion utilisée atteint l’instance attendue et lisez la version complète du serveur. Enfin, comparez ces valeurs à la version de WordPress et aux exigences des extensions et du thème. Un précontrôle réussi autorise la suite de la vérification. Il ne valide pas à lui seul l’écriture des fichiers, l’installation des tables ou l’ensemble du site.

Si votre accès se limite au tableau de bord ou au panneau, transmettez au prestataire le domaine, l’heure, le message exact et les résultats déjà disponibles. Demandez un relevé du PHP qui sert le domaine et de la version de l’instance de base visée. Reprenez le test sur copie après la correction et vérifiez aussi les fonctions qui comptent pour ce site. Gardez l’ancienne sélection et la procédure de retour jusqu’à la fin de la validation.

Valider les prérequis dans le bon environnement

Après modification, relevez de nouveau les versions complètes et les modules dans le contexte qui échouait. Vérifiez le domaine et le serveur de base utilisés. Un numéro récent dans le panneau ne suffit pas si WordPress continue à atteindre l’ancien service.

Pour une installation neuve confirmée comme telle, reprenez l’assistant prévu et vérifiez que le refus de prérequis a disparu avant de poursuivre la création du site. Pour un site existant, vérifiez son démarrage et ses données ; n’ouvrez pas une nouvelle installation pour prouver simplement que le moteur fonctionne.

Conservez les éventuels nouveaux messages. Une incompatibilité de composant ou une connexion de base refusée après le changement demande une analyse distincte, pas la suppression du contrôle initial. Le support doit pouvoir comparer l’avant et l’après à partir des mêmes informations.

Si le résultat n’est pas satisfaisant, appliquez le retour préparé. Ne présumez pas qu’une baisse de version de moteur restaurera les données ou qu’un changement de fichier de configuration annulera une mise à niveau déjà exécutée sur la base.

Contrôler les fonctions utiles avant la mise en service

Sur la copie ou dans le parcours de validation autorisé, ouvrez l’accueil, une page interne et l’administration habituelle. Vérifiez les ressources, les liens et la connexion. Un site qui charge sa page d’accueil peut encore échouer dans l’éditeur ou le traitement des médias.

Utilisez un brouillon de contrôle pour confirmer l’enregistrement, puis rouvrez-le. Si le projet nécessite une fonction spécialisée, préparez son essai dans un contexte qui neutralise les paiements et envois externes. Ne concluez pas à partir de la seule activation d’une extension.

Après une migration, le responsable doit contrôler les données attendues et les écritures récentes avant la bascule définitive. La méthode dépend de l’activité : une boutique ouverte ne se synchronise pas comme un site vitrine inchangé. Gardez un point de retour et les conditions de fermeture de l’ancien service.

Retirez les diagnostics temporaires et vérifiez que la copie ne reste pas exposée. Conservez les sauvegardes et le compte rendu jusqu’à validation du site et des opérations nécessaires.

Conserver les exigences du projet et les échéances

Votre dossier de support doit contenir le message exact, la version WordPress cible, les versions PHP et de base relevées, les modules concernés et le domaine. Ajoutez la portée du changement, les composants importants, les sauvegardes disponibles et les résultats du test sur copie.

Demandez au prestataire de distinguer ce qui est disponible immédiatement, ce qui exige une intervention et ce qui dépasse l’offre. Faites préciser les éventuels coûts avant un changement commercial, sans supposer qu’un achat remplace la résolution d’une mauvaise association de domaine.

Gardez les exigences documentées des composants et les dates de fin de support des moteurs retenus. Prévoyez une évolution avant leur expiration, avec un contrôle de compatibilité à chaque étape. Une installation qui fonctionne aujourd’hui sur une branche ancienne ne garantit pas sa maintenance future.

À la prochaine modification, vérifiez de nouveau les sources officielles et l’environnement réellement chargé. Les recommandations évoluent. Le repère durable reste un site compatible, maintenu et vérifié dans ses usages réels, avec une procédure de retour proportionnée aux changements effectués.

Sources et références

Ces références permettent de vérifier les fonctions, les prérequis et les limites décrits. Une documentation consultée ne constitue pas un essai pratique.

Consulter les 19 références

Ces guides peuvent aussi vous aider