Introduction -- Introduction à PEAR_Info
Introduction à PEAR_Info
PEAR_Info obtient et affiche les informations sur votre installation
PEAR courante.
La page PEAR_Info contient un index de A à Z pour une recherche plus
facile, ainsi qu'une ancre pour chaque paquet de la forme
pkg_Package_Name (par ex. url.tld/pearinfo.php#pkg_PEAR_Info).
PEAR_Info comporte également une page complète des
'crédits de PEAR', avec des informations sur les auteurs
des paquets que vous avez actuellement installés.
PEAR_Info vous montrera également toutes les dernières versions
disponibles du site de PEAR ce qui vous aidera
pour maintenir à jour votre installation.
Exemple 57-1. Using PEAR_Info
<?php
require_once 'PEAR/Info.php';
/*
Si vous devez fixer une valeur http_proxy pendant l'execution, valeur qui n'est
pas définie dans votre fichier de configuration PEAR (user ou system),
vous pouvez utiliser ce qui suit.
Vous devez faire cet appel AVANT d'instantier l'objet PEAR_Info.
*/
PEAR_Info::setProxy('votre.proxy.ici');
/*
la variable optionnelle pear_dir,
vous permet de choisir où prendre PEAR
au cas où il n'a pas été trouvé
*/
$pear_dir = "/path/to/your/pear/files";
/*
Instantie l'objet PEAR_Info
*/
$info = new PEAR_Info($pear_dir);
/*
Affiche les résultats de PEAR_Info
*/
$info->display();
?>
|
|
Options d'affichage de PEAR_Info
L'affichage peut être personnalisé en utilisant une ou plusieurs des constantes
suivantes, qui peuvent être additionnée dans le tableau du paramètre facultatif
options. Elles sont combinables avec l'opérateur
or.
Tableau 57-1. Options d'affichage de la page principale
| Nom | Valeur | Description |
|---|
| PEAR_INFO_GENERAL | 1 |
Le chemin du ficher de configuration, le logo PEAR et la version courante
de votre installation PEAR.
|
| PEAR_INFO_CREDITS | 2 |
Un lien vers la page des Crédits.
Voyez aussi les constantes PEAR_INFO_CREDITS_*.
|
| PEAR_INFO_CONFIGURATION | 4 | Toutes les directives de PEAR (clés et valeurs). |
| PEAR_INFO_CHANNELS | 8 | La liste des canaux de distribution disponibles. |
| PEAR_INFO_PACKAGES | 4080 |
Toutes les informations sur les paquets.
Voyez aussi les autres constantes PEAR_INFO_PACKAGES_*.
|
| PEAR_INFO_PACKAGES_CHANNEL | 2048 | Affiche le canal de distribution du paquet |
| PEAR_INFO_PACKAGES_SUMMARY | 1024 | Une description succinte du paquet |
| PEAR_INFO_PACKAGES_VERSION | 512 |
Le numéro de version du paquet avec son statut et sa date de publication.
|
| PEAR_INFO_PACKAGES_LICENSE | 256 | La license applicable à la version installée du paquet |
| PEAR_INFO_PACKAGES_DESCRIPTION | 128 | Une longue description du paquet |
| PEAR_INFO_PACKAGES_DEPENDENCIES | 64 | Affiche la liste des dépendances du paquet |
| PEAR_INFO_PACKAGES_XML | 32 |
Indique quelles versions de PEAR et du fichier package xml (1.0 ou 2.0)
ont été utilisées pour construire et installer le paquet.
|
| PEAR_INFO_PACKAGES_UPDATE | 16 |
Indique la dernière version disponible. Celle-ci ne sera affichée que
si la version diffère de celle de votre installation.
|
| PEAR_INFO_ALL | 4095 |
Affiche toutes les informations suscitées. C'est la valeur par défaut.
|
Tableau 57-2. Options d'affichage de la page des Crédits
| Nom | Valeur | Description |
|---|
| PEAR_INFO_CREDITS_ALL | 61440 |
Toutes les informations relatives aux crédits.
Voyez aussi les autres constantes PEAR_INFO_CREDITS_*.
|
| PEAR_INFO_CREDITS_GROUP | 4096 | Affiche la liste des membres du PEAR Group |
| PEAR_INFO_CREDITS_DOCS | 8192 | Affiche la liste des membres de l'équipe de documentation de PEAR |
| PEAR_INFO_CREDITS_WEBSITE | 16384 |
Affiche la liste des membres de l'équipe de maintien du site web de PEAR
|
| PEAR_INFO_CREDITS_PACKAGES | 32768 |
Affiche pour chacun des paquets la liste des auteurs (ainsi que leur rôle)
|
Tableau 57-3. Options d'affichage communes
| Nom | Valeur | Description |
|---|
| PEAR_INFO_FULLPAGE | 65536 |
Indique que la page ainsi générée doit être une page HTML complète,
avec toutes les balises nécessaires. C'est la valeur par défaut.
|
Exemple 57-2. Affichage personnalisé de PEAR_Info
<?php
require_once 'PEAR/Info.php';
/*
L'option facultative resume, vous permet de choisir quels sont les informations
à afficher. Ici nous allons afficher une liste des paquets (avec seulement leur
numéro de version) regroupé par canal de distribution.
*/
$options = array('resume' => PEAR_INFO_FULLPAGE |
PEAR_INFO_GENERAL | PEAR_INFO_CHANNELS | PEAR_INFO_PACKAGES_VERSION,
'channels' => array()
);
/*
Instantie l'objet PEAR_Info, en utilisant la configuration d'installation
par défaut
*/
$info = new PEAR_Info('', '', '', $options);
/*
Défini votre modèle de présentation (taille et couleurs), avec une simple
feuille de style
*/
$css_file = "/path/to/your/file.css";
$info->setStyleSheet($css_file);
/*
Affiche les résultats de PEAR_Info
*/
$info->display();
?>
|
|
