Introduction
Introduction to PEAR_Info
PEAR_Info obtains and displays information about your current PEAR Install. The PEAR_Info page features an A-Z index for easy searching, aswell as anchors for each package in the form of pkg_Package_Name (i.e. url.tld/pearinfo.php#pkg_PEAR_Info) PEAR_Info also features a full 'PEAR Credits' page, with information about the authors of the packages you currently have installed. PEAR_Info will also display any later versions that are available from PEAR to help keep you up to date.
Using PEAR_Info
<?php
require_once 'PEAR/Info.php';
/*
If you need to set a http_proxy value at run-time that is not set in
your user or system pear configuration file, you can use the
following, this must be called BEFORE instantiating the PEAR_Info object
*/
PEAR_Info::setProxy('your.proxy.here');
/*
Optional pear_dir variable, allows you to choose where your PEAR
install is, in case it's not found
*/
$pear_dir = "/path/to/your/pear/files";
/*
Instantiate PEAR_Info object
*/
$info = new PEAR_Info($pear_dir);
/*
Show PEAR_Info output
*/
$info->display();
?>
PEAR_Info options
The output may be customized by passing one or more of the following constants bitwise values summed together in the optional options hash parameter. One can also combine the respective constants or bitwise values together with the or operator.
| Name | Value | Description |
|---|---|---|
| PEAR_INFO_GENERAL | 1 | The configuration file location, PEAR logo and current install version. |
| PEAR_INFO_CREDITS | 2 | A link to PEAR Credits page. See also PEAR_INFO_CREDITS_* constants. |
| PEAR_INFO_CONFIGURATION | 4 | All PEAR settings (keys and values). |
| PEAR_INFO_CHANNELS | 8 | List available channels |
| PEAR_INFO_PACKAGES | 4080 | All package informations. See all others PEAR_INFO_PACKAGES_* constants. |
| PEAR_INFO_PACKAGES_CHANNEL | 2048 | Show the package channel |
| PEAR_INFO_PACKAGES_SUMMARY | 1024 | A short description of the package |
| PEAR_INFO_PACKAGES_VERSION | 512 | Package version with state and release date. |
| PEAR_INFO_PACKAGES_LICENSE | 256 | License of the package release |
| PEAR_INFO_PACKAGES_DESCRIPTION | 128 | A long description of the package |
| PEAR_INFO_PACKAGES_DEPENDENCIES | 64 | Show package dependency list |
| PEAR_INFO_PACKAGES_XML | 32 | Tell what PEAR packager and package xml version (1.0 or 2.0) was used to build and install the package. |
| PEAR_INFO_PACKAGES_UPDATE | 16 | Show the latest version available. Displayed only if different than current install version. |
| PEAR_INFO_ALL | 4095 | Shows all of the above. This is the default value. |
| Name | Value | Description |
|---|---|---|
| PEAR_INFO_CREDITS_ALL | 61440 | All credits informations. See all others PEAR_INFO_CREDITS_* constants. |
| PEAR_INFO_CREDITS_GROUP | 4096 | Show PEAR Group members list |
| PEAR_INFO_CREDITS_DOCS | 8192 | Show PEAR Documentation Team list |
| PEAR_INFO_CREDITS_WEBSITE | 16384 | Show PEAR Website Team list |
| PEAR_INFO_CREDITS_PACKAGES | 32768 | Show authors (and roles) of package maintainers |
| Name | Value | Description |
|---|---|---|
| PEAR_INFO_FULLPAGE | 65536 | Indicates that a complete stand-alone HTML page needs to be printed including the information indicated by the other flags. This is the default value. |
Customize PEAR_Info output
<?php
require_once 'PEAR/Info.php';
/*
Optional resume option, allows you to choose what information to display.
Here we will display a quick list of package (version only) group by channel.
*/
$options = array('resume' => PEAR_INFO_FULLPAGE |
PEAR_INFO_GENERAL | PEAR_INFO_CHANNELS | PEAR_INFO_PACKAGES_VERSION,
'channels' => array()
);
/*
Instantiate PEAR_Info object, using PEAR default install configuration
*/
$info = new PEAR_Info('', '', '', $options);
/*
Set you own presentation size and colors, with a simple style sheet.
*/
$css_file = "/path/to/your/file.css";
$info->setStyleSheet($css_file);
/*
Show PEAR_Info output
*/
$info->display();
?>