PHP Resources -> Pear Reference

Special extension package tags

Most of the tags for PECL-style PHP extension releases are identical to those for PEAR-style PHP script releases. There are a few extsrc/extbin-specific tags that all PECL developers must know about.

Table 21-1. PECL extsrc/extbin-specific tags in package.xml 2.0

Tag

Description of usage

The <providesextension> tag must be right after <dependencies>. This tag tells the installer the name of the extension provided by the package, allowing different package names from the extension. This could be important for binary packages (such as PDO and PDO_windows or something along those lines).

<providesextension>PDO</providesextension>

<srcpackage> or <srcuri> must follow <providesextension>. Extension binary packages must define either a <srcpackage> tag (for package.xml containing <channel>) or a <srcuri> tag (for package.xml containing <uri>).

<name>PDO_windowsbin</name>
<channel>pecl.php.net</channel>
<!-- snip -->
<providesextension>PDO</providesextension>
<srcpackage>PDO</srcpackage>

or,

<name>Foo_windowsbin</name>
<uri>http://www.example.com/Foo_windowsbin-1.5.0.tgz</uri>
<!-- snip -->
<providesextension>Foo</providesextension>
<srcuri>http://www.example.com/Foo-1.5.0.tgz</srcuri>

extsrcrelease and extbinrelease changes for PECL developers

Special extension package tags