Les fichiers de rôles standards, fournis par défaut avec PEAR, sont :

• php

• data

• doc

• test

• script

• src

• ext

Si votre paquet choisit d'utiliser un rôle fourni par une troisième partie qui implémente un gestionnaire de fichiers d'installations avancés, tout ce dont vous avez à faire est de spécifier le rôle dans le xml, dans la balise <file>, comme ceci :

<file role="foo"/>

Dependant, si un utilisateur n'a pas installé le paquet qui fournit le rôle personnalisé "foo", alors, le message d'erreur lors de l'installation affichera simplement : "unknown role 'foo'", ce qui n'est pas très parlant.

La balise <usesrole> informe l'installeur d'informer l'utilisateur en ces termes : "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>

Notez que les paquets URI statiques (paquets supportant les canaux) sont également supportés :

<usesrole>
 <role>foo</role>
 <uri>http://pear.example.com/Foo-1.2.0</uri>
</usesrole>