Greg Beaver による返答。

そのパッケージは、リリースされてはいるのですが、安定版 (stable) では無いためです。対処方法は 2 つあります。

1. preferred_state を alpha か beta にセットした後、インストール作業を行う

   $ pear config-set preferred_state alpha

   $ pear install Packagename

2. 開発状況フラグやバージョン番号を直接指定してインストールする

   $ pear install Packagename-alpha

   $ pear install Packagename-1.5.3

あなたの使用している PEAR のバージョンが 1.4.0 未満です。

そのパッケージをインストールするには、 次のコマンドで PEAR を更新しなければなりません。

$ pear upgrade PEAR

これは、最新バージョンの PEAR をインストールします。 最新バージョンでは、package.xml バージョン 2.0 しか存在しないパッケージをインストールすることができます。

古いバージョンの PEAR (< 1.3.6) がインストールされている場合は、 次のふたつのコマンドを使用して最新の PEAR をインストールする必要があります。

$ pear upgrade -a PEAR-1.3.6

$ pear upgrade -a PEAR

すべてのパッケージのドキュメントが PEAR マニュアルにあるというわけではありませんが、 ほとんどすべてのパッケージにはサンプルが付属しています。 このサンプルは、パッケージをコマンドラインでインストールする際に自動的にインストールされます。 インストール先は $peardir/docs/$packagename/ です。

サンプル/ドキュメントのディレクトリを調べるには、コマンドラインで $ pear config-get doc_dir と入力します。

Windows で PEAR を動作させるには、PEAR をインストールしたディレクトリ (例えば c:\php\pear )を php.ini の include_path ディレクティブに追加します。

注：*nix 特有のコマンドを使用するため、 Windows で動作しないクラス （たとえば Schedule/At.php）があります。

一般的な PEAR の開発と様相が異なり、windows 版 PHP 4.3.x のビルドは、 CVS でトラッキングされていません。windows 版 のスナップショットが ビルドされているマシンで扱われているのです。 ですので、PEAR が更新されても、こちらは更新されないことがよくあります。 PHP 5.x のビルドシステムはこれと異なり、PEAR の最新版に自動的に更新されるように なっています。

PHP 4.3.x のパッケージが古く動かなくなっているのを見つけたら、 その旨を pear-dev@lists.php.net に報告してください。

$ which pear とすると /usr/local/bin/pear など出て pear コマンドは使えるのだけれど、 $ pear -V とするとバージョンが古い場合とか、その他の理由で、 違うバージョンの PEAR を使いたい場合は、ホームディレクトリにインストールすると 良いでしょう。

http://go-pear.org を訪れ、 gopear.php という名で保存し、 $ php gopear.php とするか、 $ lynx -source http://pear.php.net/go-pear | php -q とするかします。

PEAR のインストールにあたっては、 /home/user/pear を prefix に指定してください（ここで user は、あなたのユーザ名）。

インストールが完了したら、PATH 環境変数に、新しい PEAR のディレクトリを 既存の PATH の 前 に追加してください。

たとえば、 ~/.bashrc や ~/.profile の最後のほうに、 export PATH=/home/user/pear/bin:$PATH を追加します。 $ echo $PATH として、 /home/user/pear/bin:[...] のように表示されるでしょうか。

$ which pear とすると /home/user/pear/bin/pear と表示され、 $ pear -V で "PEAR Version: 1.4.8" （執筆時。これ以降であればよい）と出力されると問題ありません。 最新の安定版については、 http://pear.php.net/package/PEAR の Current Release のところをチェックしてください。

最後に、 include_path を正しくセットします。 たとえば、次のようにします。

<?php $path = ini_get('include_path'); ini_set('include_path', '/home/user/pear'.PATH_SEPARATOR.$path); ?>

おそらく、二ヶ所の PEAR ディレクトリが include_path に設定されているものと思われます。 そして、 include_path で最初に指定されているディレクトリのせいで、 実際にパッケージを更新した場所が見えなくなっているのでしょう。 不要なディレクトリを include_path から削除するか、 include_path 内での並び順を変更すれば、エラーメッセージは表示されなくなります。