====== PEAR ======



===== Installer PEAR =====




==== Sous Linux ====

Dans un terminal, en supposant que les commandes **lynx** et **php** soient disponibles, il suffit de lancer cette commande :

<code>

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

</code>

Ensuite, il suffit de se laisser guider.


==== Sous Windows ====

Dans une fenêtre de commandes, en supposant que vous avez installé **php**, il suffit de lancer cette commande :

<code>

$ php -r "readfile('http://pear.php.net/go-pear');" > go-pear
$ php -q go-pear

</code>

Ensuite, il suffit de se laisser guider.






===== Utiliser PEAR =====

Une fois PEAR installé, vous devriez pouvoir lancer l'utilitaire pear ou pear.bat (respectivement sous Linux ou sous Windows).

Cet utilitaire va vous permettre de réaliser diverses actions. Il s'utilise de cette manière :

<code>

$ pear [options] command [command-options] <parameters>

</code>


La liste des commandes disponibles s'obtient simplement en tapant :

<code>

$ pear help

</code>



===== Principales commandes PEAR =====

  * Installer un package officiel

<code>

$ pear install HTTP_Request

</code>

  * Voir les packages installés localement

<code>

$ pear list -a

</code>


  * Brancher un channel:

<code>

$ pear channel-discover pear.pxxo.net

</code>

  * Lister le contenu d'un channel

<code>

$ pear remote-list -c pxxo

</code>

  * Installer un package d'un channel

<code>

$ pear install pxxo/Pxxo

</code>




===== Utiliser PEAR dans vos fichiers PHP =====

Pour cela, il suffit d'ajouter le chemin vers votre dépôt PEAR dans la directive de configuration PHP nommé **include_path**.

Cette directive peut être réglée à différent endroits :

  * dans le fichier php.ini <code>
; (sous Linux)
include_path=".:/emplacement/de/votre/depot/pear"
; (sous Windows)
include_path='.;c:\emplacement\de\votre\depot\pear'
</code>
  * dans le fichier de configuration Apache (httpd.conf ou .htaccess) <code>
<IfModule mod_php5.c>
    php_value include_path .:/emplacement/de/votre/depot/pear
</IfModule>
</code> (utilisez ; comme séparateur de chemin si vous êtes sous windows)
  * dans vos scripts PHP <code php>
ini_set('include_path', '.'.PATH_SEPARATOR.'/emplacement/de/votre/depot/pear');
</code>