PEAR がデフォルトで提供する標準のファイルロールは以下のとおりです。
php
data
doc
test
script
src
ext
サードパーティが提供する、より高度なインストール処理を行えるロールを パッケージで使用したい場合は、<file> タグの中に以下のように そのロールを指定するだけです。
<file role="foo"/> |
しかし、独自のロール "foo" を提供するパッケージを ユーザがインストールしていない場合は、インストール時に "unknown role 'foo'" というエラーが出てしまいます。 これはあまり親切とはいえません。
<usesrole> タグを使用すると、インストーラはその代わりに "this package uses the custom role 'foo', install package pear.example.com/Foo to use" というメッセージを表示するようになります。
<usesrole> <role>foo</role> <package>Foo</package> <channel>pear.example.com</channel> </usesrole> |
静的 URI のパッケージ (チャネルを使用しないパッケージ) も サポートされていることに注意しましょう。
<usesrole> <role>foo</role> <uri>http://pear.example.com/Foo-1.2.0</uri> </usesrole> |