| pkg-php-tools(1) - phpMan
PKG-PHP-TOOLS(1) Debhelper PKG-PHP-TOOLS(1)
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 AT debian.org>
1.28 2015-01-18 PKG-PHP-TOOLS(1)
|