Utiliser des paquets PEAR dans des applications PHP existantes

PEAR distribue des bibliothèques PHP qu'utilisent encore certaines applications. Si un projet dépend de l'un de ces paquets, vous pouvez le gérer depuis PHP PEAR Packages dans cPanel lorsque cette fonction est disponible. Pour les nouvelles dépendances, vérifiez si le projet utilise Composer.

Rechercher et installer un paquet

1. Ouvrez PHP PEAR Packages dans cPanel.
2. Recherchez le nom exact qu'indique la documentation de l'application.
3. Vérifiez la version, sa maintenance et la compatibilité avec le PHP qu'utilise le projet.
4. Installez-le et vérifiez le résultat et les dépendances qui ont été ajoutées.

La présence d'un paquet dans le catalogue ne garantit pas qu'il soit toujours maintenu ni qu'il fonctionne avec n'importe quelle version de PHP. Ne mettez pas à jour un composant partagé par plusieurs applications sans les avoir testées au préalable.

Ajouter le chemin de recherche

cPanel indique où il installe les composants de votre compte, habituellement /home/usuario_cpanel/php. Utilisez le chemin qu'indique votre installation.

Si vous devez l'ajouter uniquement à un script, conservez aussi les chemins existants :

<?php
ini_set('include_path', '/home/usuario_cpanel/php'
    . PATH_SEPARATOR . get_include_path());

Remplacez l'utilisateur, puis chargez le fichier précis qu'exige le paquet selon sa documentation. Si vous le configurez depuis le sélecteur PHP, vérifiez que l'option est disponible et tenez compte de son effet sur les autres applications qui utilisent cette version.

Vérifier ou retirer un paquet

Testez la fonction de l'application qui l'utilise et consultez le journal si PHP ne trouve pas un fichier ou une dépendance. Vérifiez le chemin et le PHP effectif du site, qui peuvent différer de ceux du terminal.

Avant de désinstaller, identifiez les projets qui le chargent. Migrer vers Composer nécessite d'adapter l'installation et l'autoload du projet ; installer Composer ne remplace pas automatiquement les require ou include d'une application héritée.