Installer et utiliser PEAR sur votre site

PEAR (faut prononcer « paire » et non « pire ») est une bibliothèque très complète destiné aux programmeurs PHP.
PEAR est composé de paquet (package en anglais).
Chaque paquet à ses propres fonctionnalités.
Un paquet est composé de X classes.
Le site de PEAR

quelques exemples de paquet :

  • MDB2 : accés aux bases de données.
  • Auth : Authentification des utilisateurs.
  • Net_Socket : gestion des communications TCP/IP
  • Net_POP3 : accés aux serveurs POP3
  • Log : gestion des logs
  • Mail : interface pour envoyer des mails

cliquez sur ce lien pour accéder à la Liste des paquets


Pour installer PEAR sur votre site web, le plus simple et de passer par go-pear, c’est un script PHP qu’il suffit de récuperer a cette adresse : go-pear.
Copier le code dans un fichier PHP (par exemple « index.php »).
Placer le fichier sur votre site, dans un répertoire prévu a cet effet (dans mon exemple /www/classe/PEAR/) et étant protégé des accès indésirable par un .htaccess et un .htpasswd.

note : pour être certain du chemin réel d’un répertoire, voir ici : Récuperer le chemin réel d’un répertoire

contenu du .htaccess

AuthUserFile /www/classe/PEAR/.htpasswd
AuthName "Accès Restreint"
AuthType Basic
<Limit GET POST>
require valid-user
</Limit>

contenu du .htpasswd (voir ici pour créer le mot de passe crypté : htpasswd)

login:motDepasseCrypté

et maintenant vous pouvez exécuter le script dans votre navigateur : http://monSite.com/classe/PEAR/index.php.
Le téléchargement de PEAR et des paquets de base ce fera automatiquement des que vous aurez validé les options.
Une fois tout installé et configuré, vous aurez droit a une belle interface :

pearInterface

Cette interface permet de gérer les paquets (ajout,recherche,effacement).


Après avoir passé toutes ces étapes avec succès, vous êtes prêt a utiliser PEAR dans vos scripts.
Faut eviter les include ou require qui pointent réellement sur les classes de PEAR, exemple :

require_once '/www/classe/PEAR/PEAR/PEAR.php';

Ce n’est pas faux, mais ce n’est pas la bonne solution, surtout si vous travaillez sur plusieurs serveurs, à chaque changement, vous allez être obligé de redéfinir les chemins.

La bonne solution, est de ce contenter d’un :

require_once 'PEAR.php';

Ensuite, il faut donner au moteur PHP les bonnes infos pour trouver le répertoire d’inclusion.

Pour l’aider, voici ce qu’il faut faire (fichier « config.php ») :

define('PEAR_DIR', '/www/classe/PEAR/PEAR/');

(fichier « commun.php »), à insérer dans tous les scripts PHP ayant besoin de PEAR :

require_once 'config.php';
 
set_include_path(get_include_path().PATH_SEPARATOR.PEAR_DIR);
 
require_once 'PEAR.php';
require_once 'MDB2.php';

Voila, rien de plus compliqué que ceci.
Le set_include_path(), nous permet de définir le ou les répertoires d’inclusion, donc si PHP ne trouve pas le fichier « PEAR.php » quand on fait require_once 'PEAR.php';, il va le chercher dans un des répertoires définit par set_include_path() :wink:

Laisser un commentaire

*