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é.
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.
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é.
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.
Commande | Description |
---|---|
build | Construit une extension depuis les fichiers sources |
bundle | Télécharge et décompresse une extension PECL |
channel-add | Ajoute un canal (PEAR 1.4+) |
channel-alias | Spécifie un alias pour un nom de canal (PEAR 1.4+) |
channel-delete | Efface un canal de la liste (PEAR 1.4+) |
channel-discover | Initialise un canal depuis son nom de serveur (PEAR 1.4+) |
channel-info | Récupère les informations sur un canal (PEAR 1.4+) |
channel-update | Met à jour un canal existant (PEAR 1.4+) |
clear-cache | Efface le cache XML-RPC |
config-create | Crée un fichier de configuration par défaut (PEAR 1.4+) |
config-get | Affiche un paramètre de configuration spécifique |
config-help | Montre les informations sur une configuration |
config-set | Définie une valeur de configuration spécifique |
config-show | Montre toutes les valeurs des paramètres de configuration |
convert | Convertie 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 |
cvstag | Définie un tag "release" CVS |
download | Télécharge un package mais ne l'installe pas |
download-all | Télécharge tous les packages disponibles |
info | Affiche les informations d'un package |
install | Installe un package et informe en cas de succès ou d'échec de l'installation |
list | Liste tous les packages installés |
list-all | Liste tous les packages, qu'ils soient packagés et/ou disponibles |
list-channels | Liste tous les canaux disponibles (PEAR 1.4+) |
list-files | Liste les fichiers d'un paquet installé (PEAR 1.4+) |
list-upgrades | Liste les mises à jour disponibles pour les packages installés |
login | Connexion et authentification sur le serveur PEAR distant |
logout | Déconnexion du serveur PEAR distant |
makerpm | Construit un fichier spécifique RPM depuis un package PEAR |
package | Construit un package |
package-dependencies | Affiche les dépendances d'un package |
package-validate | Valide la consistence d'un package |
remote-info | Information sur des packages distants |
remote-list | Liste les packages distants |
run-scripts | Exécute les scripts post-installation d'un paquet (PEAR 1.4+) |
run-tests | Lance des tests de régression |
search | Recherche la base de données distante de packages |
shell-test | Effectue un test shell |
sign | Signe un fichier de distribution de package |
uninstall | Désintalle et efface un package |
update-channels | Met à jour la liste des canaux (PEAR 1.4+) |
upgrade | Met à jour un package vers sa version courante (voir aussi la commande : preferred_state) |
upgrade-all | Met à 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 variable | Description | Valeur par défaut |
---|---|---|
bin_dir | Dossier d'installation des exécutables | /usr/bin |
doc_dir | Dossier d'installation de la documentation | /usr/lib/php/docs |
ext_dir | Dossier d'installation des extensions | ./ |
php_dir | Dossier où se trouve les fichiers PHP (comme les fichiers PEAR) | /usr/lib/php |
cache_dir | Dossier utilisé par la cache de l'installateur PEAR et utilisé par XMLRPC | /tmp/pear/cache |
data_dir | Dossier d'installation des fichiers de données | /usr/lib/php/data |
php_bin | Le PHP CLI ou le binaire CGI pour l'exécution des scripts | /usr/bin/php |
test_dir | Dossier 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 |
verbose | Degrè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_discover | Découvre automatiquement les nouveaux canaux depuis la ligne de commande ou des dépendances | 0 |
default_channel | Canal par défaut (PEAR 1.4+) | pear.php.net (pecl.php.net si vous utilisez la commande pecl) |
preferred_mirror | Canal miroir préféré (PEAR 1.4+) | pear.php.net (pecl.php.net if using the pecl command) |
master_server | serveur PEAR [obsolète en PEAR 1.4+] | pear.php.net |
password | mot de passe PEAR (utilisé par les mainteneurs) | |
sig_bin | Programme de gestion des signatures | /sw/bin/gpg |
sig_keydir | Dossier contenant les clés des signatures | /etc/pearkeys |
sig_keyid | La clé utilisée pour signer | |
sig_type | Type de signature du package (uniquement gpg) | gpg |
username | nom d'utilisateur (utilisé par les mainteneurs) |
Précédent | Sommaire | Suivant |
Récupérer le gestionnaire | Niveau supérieur | Installation d'une copie locale de PEAR sur un hébergement mutualisé |