If you simply want to get to know the installed version of a
package or see its description, issue an info
command:
$ pear info PEAR
About pear.php.net/PEAR-1.7.1
.. more info follows .. |
You often don't know which files belong to a certain installed
package. list-files is helping you here. It shows you
the file's role and its full path:
$ 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 |
While we try to document each package in the manual, many packages
- with or without a manual entry - come with examples. They have the
file role "doc" and can be located with
list-files, too:
$ 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 shows you all installed packages with
their version and stability:
$ 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
... |
To see all available packages on the channel server, use
remote-list:
$ pear remote-list
... output follows ... |
Note: This command takes some time if there are many packages on the
server
Instead of going to the PEAR website, you can use the pear
installer to search for package names.
$ 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 ... |
The result list shows name, remote version and stability and the
package description. Alternatively, you can use the package browser on
pear.php.net.
