| 前提事項 |
|
次の説明は、最新版の PEAR パッケージマネージャ がインストールされていることを前提としています。 |
コマンドラインインストーラは、PEAR パッケージをシステムにインストールする最も簡単な方法です。 このインストーラは、HTTP 接続で PEAR パッケージサーバにアクセスし、 パッケージをダウンロードし、任意の場所にインストールします。
コマンドライン版インストーラの使用方法は、非常に分かりやすく簡単です。 シェルで、次の行を実行してください。
$ pear install <package> |
<package> は、インストールするパッケージの名前 (たとえば HTTP_Upload など) に置き換えます。
使用したいパッケージがまだ安定版になっていない場合は、そのパッケージの状況に応じ、 最後に "-beta" あるいは "-alpha" をつけると 強制的にインストールすることができます。
$ pear install <package>-beta |
ベータ版やアルファ版のパッケージをインストールする方法はほかにもあります。 "-f" スイッチを使用して強制的にインストールするか、 preferred_state を beta に設定します。以下のいずれの方法でもインストールできます。
$ pear config-set preferred_state beta $ pear install <package> $ pear config-set preferred_state stable |
$ pear -d preferred_state=beta install <package> |
$ pear install -f <package> |
利用可能なパッケージの一覧を取得するには、 PEAR パッケージブラウザ を参照するか、次のコマンドを実行します。
$ pear remote-list |
このコマンドは、その時点で PEAR で利用可能なすべてのパッケージのリストを返します。
http://pear.php.net/ から gzip 圧縮された tar アーカイブの形式でパッケージがリリースされています。 それを手動でダウンロードして、ローカルでインストールすることも可能です。 シェルで次のコマンドを実行してください。
$ pear install <file>.tgz |
このコマンドにより、自動的にパッケージがインストールされますが、 その際にはオンライン接続が不要です。 <file>.tgz は、ダウンロードしたファイルの 名前に置き換えてください。
PEAR コマンドラインツールで使用可能なコマンドの一覧を示します。 これらのコマンドの多くは、ルート権限でのサーバアクセスが必要となります。
| コマンド | 説明 |
|---|---|
| build | ソースから拡張モジュールをビルドする |
| bundle | PECL 拡張モジュールをダウンロードし、展開する |
| channel-add | チャンネルを追加する (PEAR 1.4 以降) |
| channel-alias | チャンネル名にエイリアスを指定する (PEAR 1.4 以降) |
| channel-delete | リストからチャンネルを削除する (PEAR 1.4 以降) |
| channel-discover | 指定したサーバ名のチャンネルを初期化する (PEAR 1.4 以降) |
| channel-info | チャンネルの情報を取得する (PEAR 1.4 以降) |
| channel-update | 既存のチャンネルをアップデートする (PEAR 1.4 以降) |
| clear-cache | XML-RPC キャッシュをクリアする |
| config-create | デフォルトの設定ファイルを生成する (PEAR 1.4 以降) |
| config-get | 指定された設定項目の設定値を表示する |
| config-help | 設定項目についてのヘルプを表示する |
| config-set | 指定された設定項目に値を設定する |
| config-show | すべての設定項目の設定値を表示する |
| convert | package.xml 1.0 形式を package.xml 2.0 形式に変換する (PEAR 1.4 以降) |
| cvsdiff | パッケージのすべてのファイルに対し cvs diff -u を実行し、結果を表示する |
| cvstag | CVS のリリースタグをセットする |
| download | パッケージをダウンロードする。インストールは行わない |
| download-all | すべての利用可能なパッケージをダウンロードする |
| info | パッケージについての情報を表示する |
| install | パッケージをインストールし、成功か失敗かを表示する |
| list | インストール済のパッケージの一覧を表示する |
| list-all | 利用可能なすべてのパッケージの一覧を表示する |
| list-channels | 利用可能なチャンネル一覧を表示する (PEAR 1.4 以降) |
| list-files | インストール済のパッケージに含まれるファイルの一覧を表示する (PEAR 1.4 以降) |
| list-upgrades | インストール済のパッケージ対し適用可能なアップグレードの一覧を表示する |
| login | リモートの PEAR サーバに接続しログインする |
| logout | リモートの PEAR サーバからログアウトする |
| makerpm | PEAR パッケージから RPM spec ファイルをビルドする |
| package | パッケージをビルドする |
| package-dependencies | パッケージの依存性を表示する |
| package-validate | パッケージの整合性を確認する |
| remote-info | リモートのパッケージの情報を表示する |
| remote-list | リモートのパッケージの一覧を表示する |
| run-scripts | パッケージにバンドルされたインストール後用のスクリプトを実行する (PEAR 1.4 以降) |
| run-tests | 回帰テストを実行する |
| search | リモートのパッケージのデータベースを検索する |
| shell-test | シェルスクリプトテストを行う |
| sign | パッケージの配布ファイルに署名する |
| uninstall | パッケージをアンインストールする |
| update-channels | チャンネルのリストをアップデートする (PEAR 1.4 以降) |
| upgrade | パッケージを最新のバージョンにアップグレードする (preferred_state も参照ください) |
| upgrade-all | すべてのパッケージをアップグレードする (list-upgrades も参照ください) |
次に、PEAR の設定項目の一覧を示します。 config-get , config-help , config-set および config-show コマンドを使って これらの項目を設定します。PEAR をシステムにインストールする際に、 そのサーバに対応した値でデフォルト値が設定されます。 必要に応じて調整してください。
| 設定項目 | 説明 | デフォルト値 |
|---|---|---|
| bin_dir | 実行ファイルがインストールされるディレクトリ | /usr/bin |
| doc_dir | ドキュメントがインストールされるディレクトリ | /usr/lib/php/docs |
| ext_dir | 拡張モジュールがインストールされるディレクトリ | ./ |
| php_dir | PHP ファイル (PEAR のファイルなど) がインストールされるディレクトリ | /usr/lib/php |
| cache_dir | PEAR インストーラの XMLRPC キャッシュ用のディレクトリ | /tmp/pear/cache |
| data_dir | データファイルがインストールされるディレクトリ | /usr/lib/php/data |
| php_bin | スクリプト実行に使われる PHP の CLI または CGI バイナリ | /usr/bin/php |
| test_dir | 回帰テストがインストールされるディレクトリ | /usr/lib/php/tests |
| cache_ttk | ローカルキャッシュが使用され、更新が行われない秒数 (有効期限) | 3600 |
| preferred_state | パッケージの開発状況で、優先的にインストールされるもの。 stable, beta, alpha, devel または snapshot | stable |
| umask | ファイル作成時に使われる umask (Unix 系の環境のみ) | 22 |
| verbose | デバック用のログレベル。 0-3 で、3 が完全なデバックモード | 1 |
| http_proxy | パッケージのダウンロードの際に使う HTTP プロキシのアドレス (host:port) 。任意 | |
| remote_config | リモート用設定ファイル。ローカルのインストールをリモートのサーバに FTP を使ってミラーする場合に使用する (PEAR 1.4 以降) | |
| auto_discover | コマンドライン指定または依存性に基づいて新しいチャンネルが自動的に探知される | 0 |
| default_channel | デフォルトのチャンネル (PEAR 1.4 以降) | pear.php.net (pecl コマンドの場合は pecl.php.net) |
| preferred_mirror | 優先的に使用されるチャンネルのミラー (PEAR 1.4 以降) | pear.php.net (pecl コマンドの場合は pecl.php.net) |
| master_server | PEAR サーバ [PEAR 1.4 以降で廃止されました] | pear.php.net |
| password | PEAR パスワード (メンテナ用) | |
| sig_bin | 署名処理のプログラム | /sw/bin/gpg |
| sig_keydir | 署名キーのディレクトリ | /etc/pearkeys |
| sig_keyid | 署名に使用するキー | |
| sig_type | パッケージ署名の種類 (gpg のみ) | gpg |
| username | PEAR ユーザ名 (メンテナ用) |