PEAR マニュアル
前のページ次のページ

導入

導入 -- PEAR_Info 導入

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_GENERAL1 設定ファイルの位置、PEAR のロゴ、そして現在インストールされているバージョン。
PEAR_INFO_CREDITS2 PEAR クレジットページへのリンク。 PEAR_INFO_CREDITS_* を参照ください。
PEAR_INFO_CONFIGURATION4PEAR のすべての設定 (キーと値)。
PEAR_INFO_CHANNELS8使用できるチャネルの一覧。
PEAR_INFO_PACKAGES4080 パッケージについてのすべての情報。 他のすべての PEAR_INFO_PACKAGES_* を参照ください。
PEAR_INFO_PACKAGES_CHANNEL2048パッケージのチャネル。
PEAR_INFO_PACKAGES_SUMMARY1024パッケージの簡単な説明。
PEAR_INFO_PACKAGES_VERSION512パッケージのバージョンと状態、リリース日。
PEAR_INFO_PACKAGES_LICENSE256パッケージのライセンス。
PEAR_INFO_PACKAGES_DESCRIPTION128パッケージの詳細な説明。
PEAR_INFO_PACKAGES_DEPENDENCIES64パッケージの依存性一覧。
PEAR_INFO_PACKAGES_XML32 パッケージをビルド、インストールする際に使用した PEAR パッケージャおよび package.xml のバージョン (1.0 あるいは 2.0)。
PEAR_INFO_PACKAGES_UPDATE16 最新のバージョン。 これは、現在インストールされているバージョンと最新バージョンが 異なる場合にのみ表示されます。
PEAR_INFO_ALL4095これらすべてを表示する。デフォルトは、この値です。

表 57-2クレジットページのオプション

名前値説明
PEAR_INFO_CREDITS_ALL61440 すべてのクレジット情報。 その他の PEAR_INFO_CREDITS_* を参照ください。
PEAR_INFO_CREDITS_GROUP4096PEAR Group のメンバーの一覧。
PEAR_INFO_CREDITS_DOCS8192PEAR Documentation Team の一覧。
PEAR_INFO_CREDITS_WEBSITE16384PEAR Website Team の一覧。
PEAR_INFO_CREDITS_PACKAGES32768パッケージのメンテナ (と各メンテナのロール)。

表 57-3共通オプション

名前値説明
PEAR_INFO_FULLPAGE65536 他のフラグで指定する情報を含めた完全なスタンドアロンの 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();
?>
前のページホーム次のページ
ニュース上に戻るPEAR_PackageFileManager