PEAR_Infoは、 あなたの現在インストールしている PEAR に関する情報を得て表示します。 PEAR_Info のページは、A-Z のインデックスで簡単にパッケージを探せるようになっており、 pkg_Package_Name 形式のアンカー (例えば url.tld/pearinfo.php#pkg_PEAR_Info) がパッケージごとに定義されています。 PEAR_Info はまた、完全な「PEAR クレジット」ページを作成することもできます。 ここには、現在インストールされているパッケージの作者の情報が含められます。 また、インストールされているバージョンより新しいバージョンが利用可能な場合は、 その情報を表示します。 これにより、最新版への追従を支援します。
PEAR_Infoの 使用法
<?php
require_once 'PEAR/Info.php';
/*
もし http_proxy を実行時に指定する必要があるのなら、次のようにします。
これは、PEAR_Info のインスタンスを作成する「前に」行う必要があります。
*/
PEAR_Info::setProxy('your.proxy.here');
/*
オプションの pear_dir で、PEAR のインストールされている場所を
指定することができます。
*/
$pear_dir = "/path/to/your/pear/files";
/*
PEAR_Info のインスタンスを作成します
*/
$info = new PEAR_Info($pear_dir);
/*
PEAR_Info の出力結果を表示します
*/
$info->display();
?>
以下の定数の組み合わせを オプションのハッシュパラメータ options に指定することで、出力をカスタマイズすることができます。 複数を指定するには、それぞれの定数あるいはビット値を or 演算子で連結します。
| 名前 | 値 | 説明 |
|---|---|---|
| PEAR_INFO_GENERAL | 1 | 設定ファイルの位置、PEAR のロゴ、そして現在インストールされているバージョン。 |
| PEAR_INFO_CREDITS | 2 | PEAR クレジットページへのリンク。 PEAR_INFO_CREDITS_* を参照ください。 |
| PEAR_INFO_CONFIGURATION | 4 | PEAR のすべての設定 (キーと値)。 |
| PEAR_INFO_CHANNELS | 8 | 使用できるチャネルの一覧。 |
| PEAR_INFO_PACKAGES | 4080 | パッケージについてのすべての情報。 他のすべての PEAR_INFO_PACKAGES_* を参照ください。 |
| PEAR_INFO_PACKAGES_CHANNEL | 2048 | パッケージのチャネル。 |
| PEAR_INFO_PACKAGES_SUMMARY | 1024 | パッケージの簡単な説明。 |
| PEAR_INFO_PACKAGES_VERSION | 512 | パッケージのバージョンと状態、リリース日。 |
| PEAR_INFO_PACKAGES_LICENSE | 256 | パッケージのライセンス。 |
| PEAR_INFO_PACKAGES_DESCRIPTION | 128 | パッケージの詳細な説明。 |
| PEAR_INFO_PACKAGES_DEPENDENCIES | 64 | パッケージの依存性一覧。 |
| PEAR_INFO_PACKAGES_XML | 32 | パッケージをビルド、インストールする際に使用した PEAR パッケージャおよび package.xml のバージョン (1.0 あるいは 2.0)。 |
| PEAR_INFO_PACKAGES_UPDATE | 16 | 最新のバージョン。 これは、現在インストールされているバージョンと最新バージョンが 異なる場合にのみ表示されます。 |
| PEAR_INFO_ALL | 4095 | これらすべてを表示する。デフォルトは、この値です。 |
| 名前 | 値 | 説明 |
|---|---|---|
| PEAR_INFO_CREDITS_ALL | 61440 | すべてのクレジット情報。 その他の PEAR_INFO_CREDITS_* を参照ください。 |
| PEAR_INFO_CREDITS_GROUP | 4096 | PEAR Group のメンバーの一覧。 |
| PEAR_INFO_CREDITS_DOCS | 8192 | PEAR Documentation Team の一覧。 |
| PEAR_INFO_CREDITS_WEBSITE | 16384 | PEAR Website Team の一覧。 |
| PEAR_INFO_CREDITS_PACKAGES | 32768 | パッケージのメンテナ (と各メンテナのロール)。 |
| 名前 | 値 | 説明 |
|---|---|---|
| PEAR_INFO_FULLPAGE | 65536 | 他のフラグで指定する情報を含めた完全なスタンドアロンの HTML ページを作成することを指示します。これがデフォルトの値です。 |
PEAR_Info の出力のカスタマイズ
<?php
require_once 'PEAR/Info.php';
/*
オプションの指定により、どの情報を表示するかを指定します。
ここでは、パッケージの簡単なリスト (バージョンのみ) を各チャネルごとに表示します。
*/
$options = array('resume' => PEAR_INFO_FULLPAGE |
PEAR_INFO_GENERAL | PEAR_INFO_CHANNELS | PEAR_INFO_PACKAGES_VERSION,
'channels' => array()
);
/*
PEAR_Info オブジェクトのインスタンスを、デフォルトの PEAR の設定で作成します
*/
$info = new PEAR_Info('', '', '', $options);
/*
詳細な表示方法はスタイルシートで設定します
*/
$css_file = "/path/to/your/file.css";
$info->setStyleSheet($css_file);
/*
PEAR_Info を出力します
*/
$info->display();
?>