チャネルの使用法

チャネルとは、パッケージの取得元のことです。 詳細な情報は、マニュアルの チャネルに関するセクション 参照ください。

とりあえずは「チャネルっていうものを使えば、 PEAR 以外のところにあるパッケージもインストールできるらしい」 ということを知っておけばよいでしょう。かの有名な Horde や PHPUnit といったプロジェクトも、PEAR 互換のチャネルでソフトウェアを配布しています。

チャネルを使う前に、まずそのチャネルを pear に登録しなければなりません。 このことを "channel discovery" と言います。

プロジェクトが使用しているチャネルの URL を調べて、たとえば次のように入力します。

$ pear channel-discover http://pear.phpunit.de
Adding Channel "pear.phpunit.de" succeeded

あるいは、channel.xml ファイルをダウンロードすれば channel-add でチャネルを追加することができます。

$ pear channel-add my-channel.xml
...

list-channels を使用すれば、 登録済みのチャネルの概要を知ることができます。

$ pear list-channels
Registered Channels:
====================
Channel                  Summary
components.ez.no         eZ Enterprise components
demochanserv.bogo        Simple demo channel server
gnope.org                PHP-Gtk2 applications
pear.chiaraquartet.net   Chiara Testing Channel
pear.phing.info          Channel for Phing build tool releases
pear.php.net             PHP Extension and Application Repository
pear.phpunit.de          PHPUnit channel server
pear.symfony-project.com symfony project PEAR channel
pearified.com            PEAR-Compatible Extension and Application
                         Repository
pecl.php.net             PHP Extension Community Library
__uri                    Pseudo-channel for static packages

チャネルについてのより詳細な情報を取得するには channel-info を使用します。 これは、チャネルについての説明とその短縮名 (エイリアス)、 そしてミラーの情報を表示します。

$ pear channel-info pear.php.net
Channel pear.php.net Information:
=================================
Name and Server         pear.php.net
Alias                   pear
Summary                 PHP Extension and Application Repository
...

デフォルトのチャネル 以外にあるパッケージをインストールしたり その他の操作をしたりするには、チャネル名を (フルネームあるいは短縮形式で) 指定する必要があります。

$ pear install gnope/Dev_Inspector
... installation of package "Dev_Inspector" in channel "gnope"

$ pear list -c pear.phpunit.de
Installed packages, channel pear.phpunit.de:
============================================
Package Version State
PHPUnit 3.2.5   stable

要するに、パッケージ名を指定するところでは $channel/$packagename を指定するようにすればいいということです。 また、チャネルをサポートしているすべての機能では -c オプションでチャネル名あるいはエイリアスを指定することができます。

PEAR 互換のチャネルは、パスワードで保護することもできます。 これを使用するのは、特定の顧客向けにカスタマイズした プロプライエタリソフトウェアを配布するなど、 パッケージを不特定多数には公開したくない場合です。

パスワードによる保護は、HTTP ベーシック認証 (Apache の場合は .htaccess と .htpassword) で行います。 パスワードで保護されたチャネルを登録しようとすると、 このようなメッセージが表示されます。

$ pear channel-discover pear.company.com
Discovery of channel "pear.company.com" failed
 (channel-add: Cannot open "http://pear.company.com/channel.xml"
 (File http://pear.company.com:80/channel.xml not valid
 (received: HTTP/1.1 401 Authorization Required
)))

この場合は、まずはブラウザや wget などで channel.xml ファイルをダウンロードします。 channel.xml は、 常にチャネルサーバのルートディレクトリにあります。 ダウンロードしたら、そのファイルを使ってチャネルを登録します。

$ pear channel-add /path/to/saved/channel.xml
Adding Channel "pear.company.com" succeeded

さらに、このチャネル用のユーザ名とパスワードを PEAR マネージャに教えてやらなければなりません。 set-config にチャネル名を指定して これを登録します。

$ pear config-set -c pear.company.com username johndoe
config-set succeeded
$ pear config-set -c pear.company.com password secret
config-set succeeded

うまく登録できたかどうか確かめるために、 チャネル上のパッケージの一覧を取得してみましょう。

$ pear list-all -c pear.company.com
Retrieving data...0%
All packages [Channel pear.company.com]:
==========================
Package             Latest Local
comp/WorldDominator 0.8.1        Tool to dominate the world

認証情報を変更した場合は、 pear clear-cache コマンドを実行してキャッシュデータを削除しなければなりません。