The goal of this chapter is to help you obtain and correctly setup and execute Phing on your operating system. Once you setup Phing properly you shouldn't need to revisit this chapter, unless you're re-installing or moving your installation to another platform.
To use Phing you must have installed PHP version 5.2 or above compiled
--with-libxml2
, as well as --with-xsl
if you
want to make use of advanced functionality.
For more information on PHP and the required modules see the PHP [php] website. For a brief list of software dependencies see below.
Designed for portability from the get go, Phing runs on all platforms that run PHP. However
some advanced functionality may not work properly or is simply ignored on some
platforms (i.e. chmod
on the Windows platform).
To get the most out of Phing, a Unix style platform is recommended. Namely: Linux, FreeBSD, OpenBSD, etc.
For a detailed list of required and/or optional software and libraries, refer to the following table of Software Dependencies.
NB: This list is not exhaustive, please refer to individual Phing tasks to find out additional software requirements.
Table 3.1: Software Dependencies
Software | Required for | Source |
---|---|---|
PHP 5.2+ | Execution | http://www.php.net |
PHPUnit 3.6.0+ | Optional; enables additional task(s) | http://www.phpunit.de |
Xdebug 2.0.5+ | Optional; enables additional task(s) | http://www.xdebug.org |
SimpleTest 1.0.1 beta+ | Optional; enables additional task(s) | http://simpletest.sourceforge.net |
phpDocumentor 2.0.0b7+ (PEAR package) | Optional; enables additional task(s) | http://pear.phpdoc.org |
VersionControl_SVN (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/VersionControl_SVN |
VersionControl_Git (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/VersionControl_Git |
PHP_CodeSniffer (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/PHP_CodeSniffer |
Archive_Tar (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/Archive_Tar |
Services_Amazon_S3 (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/Services_Amazon_S3 |
HTTP_Request2 (PEAR package) | Optional; enables additional task(s) | http://pear.php.net/package/HTTP_Request2 |
Net_FTP (PEAR package) | Optional; enables SSL connection in FtpDeployTask | http://pear.php.net/package/Net_FTP |
PHP Depend | Optional; enables additional task(s) | http://www.pdepend.org |
PHP Mess Detector | Optional; enables additional task(s) | http://www.phpmd.org |
PHP Copy/Paste Detector | Optional; enables additional task(s) | http://pear.phpunit.de |
Phing does not work with safe mode enabled in PHP!