Installation par ligne de commande

Prérequis

La description ci-dessous nécessite la dernière version du gestionnaire de paquets PEAR.

L'installation par ligne de commande est la procédure la plus simple pour ajouter des paquets PEAR sur votre système : une connexion est initié vers le serveur de paquets de PEAR via le protocole HTTP, le paquet est téléchargé sur votre système et installé à l'endroit désiré.

Installation automatique

L'installation par ligne de commande est très simple à utiliser. Lancez simplement cette commande sur votre shell:


      $ pear install <paquet>
     

<paquet> doit être remplacé par le nom du paquet que vous souhaitez installer (e.g. HTTP_Upload).

Si le paquet désiré n'a pas encore atteint une version stable, vous pouvez forcer l'installation en ajoutant le suffixe "-beta" ou "-alpha", suivant le statut courant du paquet :


$ pear install <package>-beta
      

Il y a aussi d'autres options pour installer un paquet en version béta ou alpha, en utilisant l'option "-f" pour forcer l'installation ou en définissant l'option preferred_state à beta. Toutes les commandes suivantes fonctionnent :


$ pear config-set preferred_state beta
$ pear install <package>
$ pear config-set preferred_state stable
      


$ pear -d preferred_state=beta install <package>
      


$ pear install -f <package>
      

Pour récupérer une liste des paquets disponibles, vous pouvez visiter la page des paquets PEAR ou vous pouvez exécuter :


      $ pear remote-list
     

Cette commande renvoie une liste de tous les paquets disponibles dans PEAR à l'heure actuelle.

Installation semi-automatique

En téléchargeant un paquet compressé au format tar gzip à partir de http://pear.php.net/, il vous est possible de l'installer manuellement. Pour cela, lancer la commande suivante dans votre shell:


      $ pear install <file>.tgz
     

Cette commande va automatiquement installer le paquet sans avoir besoin d'une connexion en ligne. <file>.tgz doit être remplacé par le nom du fichier téléchargé.

Commandes et Variables

Voici une liste de commandes disponibles pour l'utilitaire de ligne de commande PEAR. Beaucoup de ces commandes nécessitent un accès administrateur sur le serveur.

CommandeDescription
buildConstruit une extension depuis les fichiers sources
bundle Télécharge et décompresse une extension PECL
channel-addAjoute un canal (PEAR 1.4+)
channel-aliasSpécifie un alias pour un nom de canal (PEAR 1.4+)
channel-deleteEfface un canal de la liste (PEAR 1.4+)
channel-discoverInitialise un canal depuis son nom de serveur (PEAR 1.4+)
channel-infoRécupère les informations sur un canal (PEAR 1.4+)
channel-updateMet à jour un canal existant (PEAR 1.4+)
clear-cacheEfface le cache XML-RPC
config-createCrée un fichier de configuration par défaut (PEAR 1.4+)
config-getAffiche un paramètre de configuration spécifique
config-helpMontre les informations sur une configuration
config-setDéfinie une valeur de configuration spécifique
config-showMontre toutes les valeurs des paramètres de configuration
convertConvertie un fichier package.xml au format 1.0 en un fichier package.xml au format 2.0 (PEAR 1.4+)
cvsdiff Exécute et affiche un "cvs diff -u" sur tous les fichiers d'un package
cvstagDéfinie un tag "release" CVS
downloadTélécharge un package mais ne l'installe pas
download-allTélécharge tous les packages disponibles
infoAffiche les informations d'un package
install Installe un package et informe en cas de succès ou d'échec de l'installation
listListe tous les packages installés
list-allListe tous les packages, qu'ils soient packagés et/ou disponibles
list-channelsListe tous les canaux disponibles (PEAR 1.4+)
list-filesListe les fichiers d'un paquet installé (PEAR 1.4+)
list-upgradesListe les mises à jour disponibles pour les packages installés
loginConnexion et authentification sur le serveur PEAR distant
logoutDéconnexion du serveur PEAR distant
makerpmConstruit un fichier spécifique RPM depuis un package PEAR
packageConstruit un package
package-dependenciesAffiche les dépendances d'un package
package-validateValide la consistence d'un package
remote-infoInformation sur des packages distants
remote-listListe les packages distants
run-scriptsExécute les scripts post-installation d'un paquet (PEAR 1.4+)
run-testsLance des tests de régression
searchRecherche la base de données distante de packages
shell-testEffectue un test shell
signSigne un fichier de distribution de package
uninstallDésintalle et efface un package
update-channelsMet à jour la liste des canaux (PEAR 1.4+)
upgrade Met à jour un package vers sa version courante (voir aussi la commande : preferred_state)
upgrade-allMet à jour tous les package (voir aussi la commande : list-upgrades)

Voici une liste des variables de configuration PEAR. Utilisez les options de commandes config-get, config-help, config-set et config-show pour utiliser ces variables de configuration. Durant l'installation de PEAR sur le système, PEAR essayera de remplacer les valeurs par défaut avec les valeurs spécifiques pour le serveur. Ajustez en conséquence.

Nom de la variableDescriptionValeur par défaut
bin_dirDossier d'installation des exécutables/usr/bin
doc_dirDossier d'installation de la documentation/usr/lib/php/docs
ext_dirDossier d'installation des extensions./
php_dir Dossier où se trouve les fichiers PHP (comme les fichiers PEAR) /usr/lib/php
cache_dirDossier utilisé par la cache de l'installateur PEAR et utilisé par XMLRPC/tmp/pear/cache
data_dirDossier d'installation des fichiers de données/usr/lib/php/data
php_binLe PHP CLI ou le binaire CGI pour l'exécution des scripts/usr/bin/php
test_dirDossier d'installation des tests de régression/usr/lib/php/tests
cache_ttk Nombre de secondes d'utilisation du cache local sans mise à jour (Time To Kill) 3600
preferred_state Statut préféré des packages : stable, beta, alpha, devel ou snapshot stable
umask umask utilisé pour la création des fichiers (Uniquement sur les systèmes Unix-like) 22
verboseDegrès pour les logs de débogage : 0-3 où 3 est le maximum.1
http_proxy L'adresse du proxy HTTP (optionnel) (hôte:port) utilisée pour télécharger les packages  
remote_config Fichier de configuration distant, utilisé pour faire un miroir local d'une installation sur un serveur distant via FTP. (PEAR 1.4+)  
auto_discoverDécouvre automatiquement les nouveaux canaux depuis la ligne de commande ou des dépendances0
default_channelCanal par défaut (PEAR 1.4+)pear.php.net (pecl.php.net si vous utilisez la commande pecl)
preferred_mirrorCanal miroir préféré (PEAR 1.4+)pear.php.net (pecl.php.net if using the pecl command)
master_serverserveur PEAR [obsolète en PEAR 1.4+]pear.php.net
passwordmot de passe PEAR (utilisé par les mainteneurs) 
sig_binProgramme de gestion des signatures/sw/bin/gpg
sig_keydirDossier contenant les clés des signatures/etc/pearkeys
sig_keyidLa clé utilisée pour signer 
sig_typeType de signature du package (uniquement gpg)gpg
usernamenom d'utilisateur (utilisé par les mainteneurs)