| 前提事項 |
以下の説明は、最新版の パッケージマネージャ がインストールされていることを前提とします。 |
コマンドライン インストーラは、PEAR パッケージをシステムにインストールする 最も簡単な方法です。このインストーラは、HTTP 接続により PEAR パッケージサーバに接続し、システムにパッケージをダウンロードし、 任意の場所にインストールします。
コマンドライン版インストーラの使用方法は、非常に分かりやすく簡単です。 シェル上にて、以下の1行を実行してみて下さい。
$ pear install <package>
|
<package> は、（たとえば HTTP_Upload のように）インストールするパッケージの 名前で置き換えて下さい。利用可能なパッケージの一覧を見るには、 PEAR パッケージブラウザを参照するか、以下のコマンドを実行します。
$ pear remote-list
|
このコマンドは、その時点で PEAR で利用可能なすべてのパッケージの リストを返します。
pear.php.netから リリースパッケージを gzip 圧縮された tar アーカイブの形式で （手動で）ダウンロードし、ローカルな環境にインストールできます。 シェルで以下の1行を実行して下さい。
$ pear install <file>.tgz
|
このコマンドは、自動的にパッケージをインストールしますが、 その際オンライン接続を必要としません。 <file>.tgzは、ダウンロードしたファイルの 名前に置き換えてください。
PEAR コマンドラインツールで使用可能なコマンドの一覧を示します。 サーバへのルート権限でのアクセスが必要なコマンドもあります。
| コマンド | 説明 |
|---|---|
| build | エクステンションをソースよりビルドする |
| bundle | PECL エクステンションを ダウンロードし、アンパックする |
| clear-cache | XML-RPC キャッシュをクリアする |
| config-get | 指定した構成の設定内容を表示する |
| config-help | 構成についてのヘルプを表示する |
| config-set | 指定した構成に値を設定する |
| config-show | すべての構成の設定値を表示する |
| cvsdiff | パッケージの全ファイルに対し cvs diff -u を実行し、結果を表示する |
| cvstag | CVS のリリースタグをセットする |
| download | パッケージをダウンロードする。インストールは行わない |
| download-all | すべての利用可能なパッケージをダウンロードする |
| info | パッケージについての情報を表示する |
| install | パッケージをインストールする |
| list | インストール済のパッケージの一覧を示す |
| list-all | 利用可能なすべてのパッケージのリストを表示する |
| list-upgrades | インストール済のパッケージ対し適用可能なアップグレードの一覧を表示する |
| login | リモートの PEAR サーバに接続しログインする |
| logout | リモートの PEAR サーバからログアウトする |
| makerpm | PEAR パッケージからRPM spec ファイルをビルドする |
| package | パッケージをビルドする |
| package-dependencies | パッケージの依存性を表示する |
| package-validate | パッケージの整合性を確認する |
| remote-info | リモートのパッケージの情報を示す |
| remote-list | リモートのパッケージの一覧を表示する |
| run-tests | 回帰テストを実行する |
| search | リモートのパッケージのデータベースを検索する |
| shell-test | シェルスクリプトテストを行う |
| sign | パッケージの配布ファイルに署名する |
| uninstall | パッケージをアンインストールする |
| 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 ファイルがインストールされるディレクトリ (like PEAR files) | /usr/lib/php |
| cache_dir | PEAR インストーラの XMLRPC キャッシュ用のディレクトリ | /tmp/pear/cache |
| data_dir | データファイルがインストールされるディレクトリ | /usr/lib/php/data |
| php_bin | PHP スクリプトの実行に使用する 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 系の systems のみ) | 22 |
| verbose | デバック用のログレベル。 0-3 で、 3 が完全なデバックモード. | 1 |
| http_proxy | パッケージのダウンロードの際に使う HTTP プロキシのアドレス (host:port) 。 オプション | |
| master_server | PEAR サーバ | pear.php.net |
| password | PEAR パスワード (メンテナ用) | |
| sig_bin | 署名処理のプログラム | /sw/bin/gpg |
| sig_keydir | 署名キーのディレクトリ | /etc/pearkeys |
| sig_keyid | 署名につかうキー | |
| sig_type | パッケージ署名の種類 (現在のところ、gpg のみ) | gpg |
| username | PEAR ユーザ名 (メンテナ用) |