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>