NAME

       pkg-php-tools - debhelper tool suite for PHP PEAR packages and channels

SYNOPSIS

       dh $@ --buildsystem=phppear --with phppear

DESCRIPTION

       For a quick start, read /usr/share/doc/pkg-php-tools/README.PEAR.

       dh_phppear(1) is a debhelper program that is responsible for generating the ${phppear:*} substitutions
       and adding them to substvars files. See the corresponding manpage.

       dh_phpcomposer is a debhelper program that is responsible for generating the ${phpcomposer:*}
       substitutions and adding them to substvars files. See the corresponding manpage.

       Debian::Debhelper::Buildsystem::phppear is an additionnal build system targeted at PHP PEAR packages
       (with a package.xml or package2.xml file) and PHP PEAR channels (with a channel.xml file). See below.

ADVANCED USAGE

   Building a PECL package
       A PECL package is a PEAR package which is compiled. Extra steps are needed:

       • Adding php5-dev, pkg-php-tools (>= 1.6~) and dh-php5 to Build-Depends.

       • Adding ${shlibs:Depends} and ${php:Depends} to Depends.

       • Adding "--with php5" to dh line in debian/rules.

   Building a channel package
       Simply  put  the  channel.xml file downloaded from the PEAR channel in the root of the package source and
       use a debian/rules similar to a PEAR package.

       This feature requires pkg-php-tools (>= 1.3~)

   Overriding a PEAR Debian package name
       See "FILES" in dh_phppear(1).

   Patching
       pkg-php-tools will remove md5sums and sha1sums to ease patching. You can patch as usual.

   Removing some files from the upstream tarball
       If you have removed some files from the upstream tarball, you will end with an incomplete package  unless
       you  strip  them  from  the  package.xml  file  in  the  PEAR  package  subdir. You can do this after the
       dh_auto_configure step. Example:

         override_dh_auto_configure:
               dh_auto_configure -O--buildsystem=phppear
               # Remove references of JsMin
               sed -i '/JsMin\.php/d' */package.xml

       This feature requires pkg-php-tools (>= 1.1~)

CONFORMS TO

       Debian policy, version 3.9.4

       PHP PEAR policy, version yet-to-be-written

SEE ALSO

       /usr/share/doc/pkg-php-tools/README.PEAR, dh_phppear(1), dh_phpcomposer(1)

       debhelper(7) (Note: This program is not part of debhelper)

AUTHOR

       Mathieu Parent <sathieu@debian.org>

no change                                          2014-02-03                                   PKG-PHP-TOOLS(1)