PEAR_Info 導入
PEAR_Infoは、
あなたの現在インストールしている PEAR に関する情報を得て表示します。
PEAR_Info のページは、A-Z のインデックスで簡単にパッケージを探せるようになっており、
pkg_Package_Name 形式のアンカー
(例えば url.tld/pearinfo.php#pkg_PEAR_Info)
がパッケージごとに定義されています。
PEAR_Info はまた、完全な「PEAR クレジット」ページを作成することもできます。
ここには、現在インストールされているパッケージの作者の情報が含められます。
また、インストールされているバージョンより新しいバージョンが利用可能な場合は、
その情報を表示します。
これにより、最新版への追従を支援します。
例 57-1PEAR_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();
?>
|
|
PEAR_Info のオプション
以下の定数の組み合わせを
オプションのハッシュパラメータ options
に指定することで、出力をカスタマイズすることができます。
複数を指定するには、それぞれの定数あるいはビット値を
or
演算子で連結します。
表 57-1全般のオプション
| 名前 | 値 | 説明 |
|---|
| 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 | これらすべてを表示する。デフォルトは、この値です。 |
表 57-2クレジットページのオプション
| 名前 | 値 | 説明 |
|---|
| 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 | パッケージのメンテナ (と各メンテナのロール)。 |
表 57-3共通オプション
| 名前 | 値 | 説明 |
|---|
| PEAR_INFO_FULLPAGE | 65536 |
他のフラグで指定する情報を含めた完全なスタンドアロンの HTML
ページを作成することを指示します。これがデフォルトの値です。
|
例 57-2PEAR_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();
?>
|
|
