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~)
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>