パッケージについての情報の取得

インストールされているパッケージのバージョンやその説明を見たい場合は info コマンドを実行します。

$ pear info PEAR
About pear.php.net/PEAR-1.7.1
.. この後にいろいろな情報が続きます ..

あるパッケージを構成するファイルがどれであるのかがわからなくなることもよくあります。 そんな場合は list-files を使用します。 これは、各ファイルのロール (種別) とそのフルパスを表示します。

$ pear list-files log
Installed Files For log
=======================
Type Install Path
doc  /usr/share/pear/docs/Log/docs/guide.txt
...
php  /usr/share/pear/Log/composite.php
php  /usr/share/pear/Log/console.php
...
data /usr/share/pear/data/Log/misc/log.sql
test /usr/share/pear/tests/Log/tests/composite.phpt
...
php  /usr/share/pear/Log.php

PEAR パッケージのドキュメントは可能な限りマニュアルに掲載されるよう試みていますが、 それ以外にも多くのパッケージにはサンプルプログラムが付属しています。 サンプルのロールは "doc" で、 list-files コマンドで見つけることができます。

$ pear list-files log | grep ^doc
doc  /usr/share/pear/docs/Log/docs/guide.txt
doc  /usr/share/pear/docs/Log/examples/composite.php
doc  /usr/share/pear/docs/Log/examples/console.php
doc  /usr/share/pear/docs/Log/examples/display.php
doc  /usr/share/pear/docs/Log/examples/error_log.php
doc  /usr/share/pear/docs/Log/examples/file.php
doc  /usr/share/pear/docs/Log/examples/firebug.php
...

list コマンドは、 インストールされているすべてのパッケージとそのバージョン、 そして安定性を表示します。

$ pear list
Installed packages, channel pear.php.net:
=========================================
Package                   Version   State
Archive_Tar               1.3.2     stable
Auth                      1.5.4     stable
Cache                     1.5.4     stable
Console_Getargs           1.3.4     stable
Console_Getopt            1.2.3     stable
...

あるチャネルサーバ上にあるすべてのパッケージを知りたい場合は remote-list を使用します。

$ pear remote-list
... 出力が続きます ...

サーバ上に多くのパッケージが登録されている場合は、 このコマンドの実行に時間がかかります。

わざわざ PEAR のウェブサイトに行かなくても、 pear インストーラでパッケージ名による検索をすることができます。

$ pear search w3c
Retrieving data...0%.
Matched packages, channel pear.php.net:
=======================================
Package                    Stable/(Latest) Local
Services_W3C_CSSValidator  0.1.0 (alpha)         An Object Oriented Interface ...

出力結果には、名前とバージョンそして安定性のほかに パッケージの説明も含まれています。 あるいは、pear.php.net の パッケージブラウザ を使用することもできます。