Custom File Roles

Edited By

Gregory Beaver

$Date: 2008-10-09 15:16:18 $

As of PEAR version 1.4.3, the required format for custom file roles has been
changed due to a minor security vulnerability. All custom file roles must
now define a Role.xml file in order to properly declare
a custom file role. See the example below for more information.

One of the programming features that the PEAR installer enforces is the separation
of files into separate categories, and the important idea that files of a similar
category are always installed into the same location, or at least handled the
same way, as in the case of role="src" for PECL packages.

This has been quite successful for smaller library-style packages, but complete
applications cannot function without customized installation locations. For instance,
some files may be intended for use in a public web frontend, others for library location.
PEAR 1.4 introduces the possibility of defining custom installation roles to fill this
void.