Le message configure: error: xml2-config not found peut apparaître pendant la préparation d’une compilation de PHP à partir de ses sources. Il indique que cette procédure n’a pas trouvé l’outil attendu pour repérer libxml2. Il ne prouve pas, à lui seul, que PHP est absent du serveur ou qu’un site déjà en service est défectueux.
Identifier la procédure qui échoue
Relevez la version PHP que vous cherchez à construire, le système d’exploitation, son architecture et l’origine des sources ou des paquets. Précisez si l’erreur survient pendant la configuration, la compilation ou l’exécution d’une application. Conservez le message original et les lignes qui le précèdent, sans traduire les noms d’outils ni les options.
Une erreur de connexion à une base de données relève d’un autre diagnostic : consultez notre guide MySQL et MariaDB. Pour choisir le PHP utilisé par votre site, commencez par le guide de sélection d’une version PHP.
Distinguer une ancienne compilation du mécanisme actuel
- PHP antérieur à 7.4 : la procédure historique recherche
xml2-configpour localiser libxml2. La documentation PHP de cette ancienne procédure précise les emplacements examinés. La présence de la bibliothèque d’exécution ne suffit pas à confirmer que les éléments nécessaires à la compilation sont disponibles. - PHP 7.4 et versions suivantes : la configuration de libxml utilise
pkg-configpour déterminer les bibliothèques, les en-têtes et les options de compilation. La procédure PHP actuelle décrit ce mécanisme et son chemin de recherche.
Cette différence situe une méthode de compilation; elle ne recommande pas une ancienne version de PHP. Si un outil récent affiche encore l’ancien message, identifiez le composant ou le script qui l’émet avant d’ajouter un paquet ou de modifier un chemin.
Sur un hébergement géré par un panneau
Un compte d’hébergement partagé n’a pas à reconstruire PHP pour corriger ce message. Dans cPanel, les versions et extensions fournies par EasyApache 4 sont gérées par l’administrateur, tandis que les options accessibles au compte dépendent du service. La documentation PHP de cPanel explique cette organisation.
LiteSpeed distingue aussi ses installations autonomes des environnements avec panneau. Son guide des extensions PHP renvoie aux outils du panneau concerné. Sur un service administré, demandez une vérification de la version et du module nécessaires plutôt que de remplacer le PHP installé.
Pour une compilation administrée à partir des sources
L’administrateur vérifie les dépendances dans l’environnement exact de construction, notamment s’il s’agit d’un conteneur. Il contrôle les en-têtes de développement, la version compatible de libxml2, l’outil de détection et les chemins réellement utilisés. Les exigences libxml de PHP varient selon la version ciblée.
Le nom des paquets et la méthode d’installation dépendent du système et des dépôts approuvés. Une bibliothèque déjà installée peut être invisible à la construction ou d’une version incompatible. Ajouter un chemin au hasard, copier une bibliothèque d’un autre serveur ou désactiver libxml pour franchir l’étape peut créer un autre problème. Examinez d’abord le journal de configuration.
Valider la correction et obtenir de l’aide
Après une correction ciblée, vérifiez la détection des dépendances et les essais de l’application dans un environnement de test. Une compilation réussie ne confirme pas que le site utilise le nouveau binaire : le PHP web et celui des tâches planifiées peuvent différer.
Depuis votre espace client, transmettez le contexte, la version visée et un extrait d’erreur nettoyé, sans secrets ni données personnelles. Notre équipe peut orienter la correction du service ou préparer avec vous la modernisation d’une application qui dépend d’un environnement ancien.