PEAR logo

PEAR_PackageFileManager : The Definitive Guide

Improve warning message requiring custom file role handler
Prev  Chapter 11. Using custom file roles  Next


Improve warning message requiring custom file role handler

This problem may be solve easily by adding a <usersrole> tag documenting package to install that will handle the new role. Uses methods : addUsesrole() with (replace role) or without (append role) its resetUsesrole() companion.

Table 11.2. install custom file role handler

PHP code XML equivalent 
           
$p2->resetUsesrole();
// use channel-based package
$p2->addUsesrole('web', 'Role_Web', 'pearified.com');
           
          

           
<usesrole>
 <role>web</role>
 <package>Role_Web</package>
 <channel>pearified.com</channel>
</usesrole>
           
          

           
$p2->resetUsesrole();
// use uri-based package
$p2->addUsesrole('web',
    'http://pearified.com/Role-1.1.1');
           
          

           
<usesrole>
 <role>web</role>
 <uri>http://pearified.com/Role-1.1.1</uri>
</usesrole>
[Tip] Tip
If Role_Web package is not installed, then PEAR installer take aware user with a message like This package contains role "web" and requires package "channel://pearified.com/Role_Web" to be used.
PEAR_PackageFileManager : The Definitive Guide v 1.6.0 : November 17, 2006
Prev  Up  Next
Chapter 11. Using custom file roles  Home  Chapter 12. Using custom file tasks