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

インストールされているパッケージのバージョンやその説明を見たい場合は 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

... 出力が続きます ...

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

わざわざ 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 の パッケージブラウザ を使用することもできます。