コマンドPEARの使い方 †
質問などは掲示板にでもどうぞ.
おおざっぱな情報 †
コマンドpearの実行例
| <COMMAND>と<PARAMETER>の指定例 | 用途 |
| pear install <PACKAGE> | <PACKAGE>をインストールする.カレントディレクトリに存在しない場合,ネットワーク上に取得しに行く.--forceで強制インストール,--alldepsで依存関係があるパッケージもインストールし,--nodepsで依存関係を無視したインストールをする |
| pear upgrade <PACKAGE> | <PACKAGE>を更新する.install同様カレントのパッケージ,もしくはネットワークのパッケージを用いる.--forceや--alldepsなど併記することができる |
| pear upgrade-all | 更新可能なパッケージをすべて更新する.--nodepsなどを指定できる |
| pear uninstall | インストール済パッケージの削除をする.--nodepsなどを指定できる |
| pear list | インストール済パッケージの一覧を出力する.--channelや--allchannelsでチャンネル(後述)を意識した一覧表示ができる |
| pear list-channels | 現在使用できるチャンネルサーバーの一覧を出力する |
| pear list-files <PACKAGE> | <PACKAGE>に含まれるファイルの一覧を出力する |
| pear list-upgrades | 更新可能なパッケージの一覧を出力する |
| pear channel-discover <CHANNEL> | <CHANNEL>*1がチャンネルサーバーかどうか調べ,チャンネルサーバーなら内部データベースに追加する |
| pear channel-delete <CHANNEL> | <CHANNEL>がチャンネルサーバーかどうか調べ,チャンネルサーバーなら内部データベースから削除する |
| pear info <URL><FILE><PACKAGE> | URL,ファイル名,パッケージ名のいずれかで指定されたパッケージの情報を出力する |
パッケージ管理 †
パッケージインストール †
$ pear install <PACKAGE>
普通にインストール.既にインストール済ならインストール済といわれる.
$ pear install <PACKAGE>-<STATE>
| STATE | 意味 |
|---|
| alpha | |
|---|
| beta | |
|---|
| devel | |
|---|
| snapshot | |
|---|
| stable | 内部情報としてあるだけで指定はできないかも(笑 |
|---|
$ pear install <PACKAGE>-<VERSION>
PACKAGE>の指定されたバージョン番号のものをインストールします.
$ pear install --alldeps <PACKAGE>
依存性のあるパッケージも同時にインストールします.
依存性の弱いもの(推奨など)は提案(suggest)として表示されるだけです.
$ pear install --force <PACKAGE>
強制インストールです.何らかの問題が発生する場合も考えられますのでどういう処理が行われるのかある程度理解と推測ができなければ使用しない法がいいでしょう.
わかりやすい使用シーンとしては,「パッケージを更新したらエんばぐしてるくさい」とか「パッケージの調査にデバッグコードいれまくって元に戻すのが面倒になった」といったケースはあるかもしれません.
バージョンダウンしたいとき
$ pear install --force <PACKAGE>-<OLDVERSION>
上書きしたいときに戻す
$ pear install --force <PACKAGE>
パッケージ更新 †
個人的にはupdateだろって思うんですがまぁupgradeってことで.
基本的な使い方はinstallと同様です.
$ pear upgrade <PACKAGE>
パッケージ情報取得 †
$ pear info <PACKAGE>
PACKAGE>はパッケージ名(「DB」とか),パッケージファイル名(「DB-1.7.2.tgz」とか)のどちらでもかまいません.
取得できる情報は下記のものです.
| 項目 | 意味 |
|---|
| About <PACKAGE>-<VERSION> | 表示するパッケージ名とバージョン番号 |
|---|
| Provides | 提供するクラス名など |
|---|
| Package | パッケージ名 |
|---|
| Summary | パッケージ要約 |
|---|
| Description | パッケージ詳細説明文 |
|---|
| Maintainers | パッケージメンテナー |
|---|
| Version | バージョン番号 |
|---|
| Release Date | リリース日 |
|---|
| Release License | ライセンス |
|---|
| Release State | リリース品質 |
|---|
| Release Notes | 変更情報 |
|---|
| Package.xml Version | package.xml(package2.xml)の情報 |
|---|
| Last Installed Version | 最後にインストールしたバージョン |
|---|
| Last Modified | 最終修正日? |
|---|
チャンネル管理 †
チャンネル追加 †
$ pear channel-discover <CHANNEL>
チャンネルサーバーとして<CHANNEL>を登録します.
これを実行するとき,実際に<CHANNEL>にアクセスできる必要があります.
また,チャンネル登録にはチャンネルサーバーに http://<CHANNEL>/channel.xml というURLでアクセスします.
チャンネル情報更新 †
$ pear channel-update <CHANNEL>
channel-discoverの時と同様にchannel.xmlを取得し,内部情報を更新します.
チャンネル情報削除 †
$ pear channel-delete <CHANNEL>