<usesrole>

<usesrole> – <contents> で使用する独自のファイルロールを記述する

独自のファイルロールを記述する

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>
package.xml 2.0 における依存性の指定 (Previous) <contents> で使用する独自のタスクを記述する (Next)
Last updated: Fri, 24 Oct 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.