Manuel Pear

Niveau superieur
Sommaire

Introduction

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

  1. <?php
  2. require_once 'PEAR/Info.php';  
  3.  
  4. /*
  5. Si vous devez fixer une valeur http_proxy pendant l'execution, valeur qui n'est
  6. pas définie dans votre fichier de configuration PEAR (user ou system),
  7. vous pouvez utiliser ce qui suit.
  8. Vous devez faire cet appel AVANT d'instantier l'objet PEAR_Info.
  9. */  
  10.  
  11. PEAR_Info::setProxy('votre.proxy.ici');  
  12.  
  13. /*
  14. la variable optionnelle pear_dir,
  15. vous permet de choisir où prendre PEAR
  16. au cas où il n'a pas été trouvé
  17. */  
  18.  
  19. $pear_dir = "/path/to/your/pear/files";  
  20.  
  21. /*
  22. Instantie l'objet PEAR_Info
  23. */  
  24.  
  25. $info = new PEAR_Info($pear_dir);  
  26.  
  27. /*
  28. Affiche les résultats de PEAR_Info
  29. */  
  30.  
  31. $info->display();  
  32.  
  33. ?> 

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

  1. <?php
  2. require_once 'PEAR/Info.php';  
  3.  
  4. /*
  5. L'option facultative resume, vous permet de choisir quels sont les informations
  6. à afficher. Ici nous allons afficher une liste des paquets (avec seulement leur
  7. numéro de version) regroupé par canal de distribution.
  8. */  
  9.  
  10. $options = array('resume' => PEAR_INFO_FULLPAGE | 
  11.    PEAR_INFO_GENERAL | PEAR_INFO_CHANNELS | PEAR_INFO_PACKAGES_VERSION, 
  12.    'channels' => array()  
  13. );  
  14.  
  15. /*
  16. Instantie l'objet PEAR_Info, en utilisant la configuration d'installation
  17. par défaut
  18. */  
  19.  
  20. $info = new PEAR_Info('', '', '', $options);  
  21.  
  22. /*
  23. Défini votre modèle de présentation (taille et couleurs), avec une simple
  24. feuille de style
  25. */  
  26.  
  27. $css_file = "/path/to/your/file.css";  
  28. $info->setStyleSheet($css_file);  
  29.  
  30. /*
  31. Affiche les résultats de PEAR_Info
  32. */  
  33.  
  34. $info->display();  
  35.  
  36. ?> 
Niveau superieur
Sommaire

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique