Ressources Spip-Agora Clever Age

Installer PEAR, le 16 mai 2005

Le framework technique utilisé par SPIP-AGORA

Depuis l’ouverture du code de SPIP-AGORA, installer PEAR est la première difficulté rencontrée par les utilisateurs. En fait, PEAR n’est rien d’autre qu’un ensemble de fichiers PHP organisé et accessible depuis n’importe quel autre script.

Depuis la version 1.2.1 de SPIP-AGORA, la présence des composants PEAR  [1] est vérifiés à l’installation du logiciel. Toutefois, il faut faire l’installation à la main des éventuels modules PEAR manquant.

Installation sur votre machine personnelle ou sur un serveur dédié

Sous Linux ou tout autre *Nix

Il est nécessaire de disposer en premier lieu de php en ligne de commande ... Le binaire php vous permettra de lancer des scripts PHP via votre shell. Il est maintenant fourni avec toutes les versions récentes de PHP. Dans le cas contraire il faut généralement installer un paquet comme php-cli.

Si vous disposez d’un gestionnaire de paquets [2], vous pouvez commencer par installer pear via ce mode [3]. Le gestionnaire de paquet, s’il est bien fait, devrait régler pour vous tous les problèmes liés à la configuration de php etc....

Dans le cas contraire nous vous conseillons d’utiliser le site go-pear.org. Il faut avoir le logiciel lynx [4] installé. Connecté sous le compte root saisissez cette commande :

lynx -source http://pear.php.net/go-pear | php -q

Répondez aux questions du script interactif et c’est gagné.

A ce stade, pour installer les modules PEAR nécessaires à SPIP-AGORA il suffit normallement de taper, en tant que root :
pear install Date
pear install DB
pear install Log
pear install DB_NestedSet-1.3.6
pear install Cache
pear install DB_ldap2-0.4
pear install Text_Diff-0.2.0
pear install Mail 
pear install Mail_Mime
pear install PHP_Compat

Les versions minimums pour ces packages sont nécessaires :

  • DB 1.7.6
  • PEAR 1.3.5
  • DB_NestedSet 1.3.6

Il est enfin possible de faire tout manuellement :
- télécharger chaque module sur le site http://pear.php.net/packages.php
- les installer tous au même endroit (classiquement dans /usr/share/pear)
- ajouter le chemin d’installation à la directive include_path de votre fichier de configuration PHP.

Sous Windows

Avec EasyPHP 1.8, par exemple, il suffit de se rendre dans le répertoire d’installation de PHP (par défaut c:\Program Files\EasyPHP1-8\php\ ) puis de lancer go-pear.bat . Cela devrait lancer une invite de commande DOS, il ne reste plus qu’à répondre questions posées... ça y est PEAR est installé. Ensuite de la même façon que sous Linux, il faut installer les modules nécessaire à SPIP-Agora sous DOS en utilisant :
pear install Date
...

Installation sur un serveur mutualisé

Certains hébergeurs mettent à votre disposition un répertoire include, présent dans l’option include_path du fichier de configuration de PHP. Installer PEAR se résume à réunir tous les packages et les poser à cet endroit.

Pour toutes remarques vous pouvez utiliser ce formulaire

Vous pouvez également consulter cet excellent article.

[1] http://www.clever-age.com/veille/livres-blancs/pear-framework-technique-php_127.html : présente PEAR sur le site de Clever Age

[2] comme apt-get sous Debian ou urpmi sous Mandrake

[3] sous Mandrake, par exemple, il faut taper la commande urpmi php-pear

[4] navigateur web historique en mode texte