PHPackages                             phing/phing - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. phing/phing

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

phing/phing
===========

PHing Is Not GNU make; it's a PHP project build system or build tool based on Apache Ant.

3.1.2(3mo ago)1.2k21.7M—0.8%318[5 issues](https://github.com/phingofficial/phing/issues)[8 PRs](https://github.com/phingofficial/phing/pulls)20LGPL-3.0-onlyPHPPHP &gt;= 8.1CI passing

Since Apr 6Pushed 1mo ago53 watchersCompare

[ Source](https://github.com/phingofficial/phing)[ Packagist](https://packagist.org/packages/phing/phing)[ Docs](https://www.phing.info/)[ GitHub Sponsors](https://github.com/sponsors/mrook)[ GitHub Sponsors](https://github.com/sponsors/siad007)[ RSS](/packages/phing-phing/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (41)Versions (59)Used By (20)

[![Phing](https://github.com/phingofficial/phingofficial.github.io/raw/main/img/logo.gif?raw=true)](https://github.com/phingofficial/phingofficial.github.io/blob/main/img/logo.gif?raw=true)
=============================================================================================================================================================================================

[](#)

[![Phing CI](https://github.com/phingofficial/phing/actions/workflows/build.yml/badge.svg)](https://github.com/phingofficial/phing/actions/workflows/build.yml) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/10f3dc29156f413f159094b1ed9729b527e8056007324c60e03a359b2215063e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7068696e676f6666696369616c2f7068696e672f6261646765732f7175616c6974792d73636f72652e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/phingofficial/phing/?branch=main)[![codecov](https://camo.githubusercontent.com/ac839617abd1a355f4b40be5e397345a54333f5ea5b5a7a0a72e41fac9bc3943/68747470733a2f2f636f6465636f762e696f2f67682f7068696e676f6666696369616c2f7068696e672f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/phingofficial/phing)

Thank you for using PHING!

**PH**ing **I**s **N**ot **G**NU make; it's a PHP project build system or build tool based on Apache Ant. You can do anything with it that you could do with a traditional build system like GNU make, and its use of simple XML build files and extensible PHP "task" classes make it an easy-to-use and highly flexible build framework.

Features include running PHPUnit unit tests (including test result and coverage reports), file transformations (e.g. token replacement, XSLT transformation, template transformations), file system operations, interactive build support, SQL execution, SCM operations (Git, Subversion and Mercurial), documentation generation (PhpDocumentor, ApiGen) and much, much more.

If you find yourself writing custom scripts to handle the packaging, deploying, or testing of your applications, then we suggest looking at Phing. Pre-packaged with numerous out-of-the-box operation modules (tasks), and an easy-to-use OO model to extend or add your own custom tasks.

For more information and documentation, you can visit our official website at .

Phing 3
-------

[](#phing-3)

Phing 3 is a significant update with some breaking changes compared to Phing 2. For details, please refer to the [UPGRADING.md](UPGRADING.md) file.

Supported PHP versions
----------------------

[](#supported-php-versions)

Phing 3.x is compatible with PHP 8.1 or later.

Installation
------------

[](#installation)

1. **Composer**

The preferred method to install Phing is through [Composer](https://getcomposer.org/). Add [phing/phing](https://packagist.org/packages/phing/phing) to the require-dev or require section of your project's `composer.json`configuration file, and run 'composer install':

```
     {
         "require-dev": {
             "phing/phing": "3.1.x-dev"
         }
     }

```

2. **Phar**

Download the [Phar archive](https://www.phing.info/get/phing-latest.phar). The archive can then be executed by running:

```
     $ php phing-latest.phar

```

3. **Docker** (experimental)

The official Phing Docker image can be found on [Docker Hub](https://hub.docker.com/r/phing/phing/).

To execute Phing inside a container and execute `build.xml` located in `/home/user`, run the following:

```
     $ docker run --rm -v /home/user:/opt phing/phing:3.0 -f /opt/build.xml

```

4. **Phing GitHub Action**

The official GitHub action [phingofficial/phing-github-action](https://github.com/phingofficial/phing-github-action) is available on [GitHub Marketplace](https://github.com/marketplace/actions/run-a-phing-build).

To *Run a Phing Build* as an action, you need to setup a `.github/workflow/phing.yml` workflow file and paste the following snipped:

```
 name: CI
 on: [ push ]
 jobs:
   build-test:
     runs-on: ubuntu-latest

     steps:
       - uses: actions/checkout@v2
       - name: Phing Build
         uses: phingofficial/phing-github-action@v2.0.0
         with:
           version: 3.0.0-alpha4
           user-properties: prop=FooBar
           targets: foo
           verbose: true

```

[README](%5Bphingofficial/phing-github-action%5D(https://github.com/phingofficial/phing-github-action)) for more info and documentation.

Documentation
-------------

[](#documentation)

Phing's documentation can be found at .

For the source of the documentation, go to .

Contact
-------

[](#contact)

- Twitter: [@phingofficial](https://twitter.com/phingofficial)
- Website:
- Slack: [https://phing.slack.com/](https://slack.phing.info)
- IRC: Freenode, #phing
- GitHub:

Donations
---------

[](#donations)

Developing and maintaining Phing has cost many hours over the years. If you want to show your appreciation, you can use one of the following methods to donate something to the project maintainer, Michiel Rook:

- Become a patron on [Patreon](https://www.patreon.com/michielrook)
- [Flattr](https://flattr.com/thing/1350991/The-Phing-Project) Phing
- Send money via [PayPal](https://www.paypal.me/MichielRook)
- Choose something from the [Amazon Wishlist](https://www.amazon.com/hz/wishlist/ls/10DZLPG9U429I)

Thank you!

### Help us spot &amp; fix bugs

[](#help-us-spot--fix-bugs)

We greatly appreciate it when users report issues or come up with feature requests. However, there are a few guidelines you should observe before submitting a new issue:

- Make sure the issue has not already been submitted, by searching through the list of (closed) issues.
- Support and installation questions should be asked on Twitter, Slack or IRC, not filed as issues.
- Give a good description of the problem, this also includes the necessary steps to reproduce the problem!
- If you have a solution - please tell us! This doesn't have to be code. We appreciate any snippets, thoughts, ideas, etc that can help us resolve the issue.

Issues can be reported on [GitHub](https://github.com/phingofficial/phing/issues).

### Pull requests

[](#pull-requests)

The best way to submit code to Phing is to [make a Pull Request on GitHub](https://help.github.com/articles/creating-a-pull-request). Please help us merge your contribution quickly and keep your pull requests clean and concise: squash commits and don't introduce unnecessary (whitespace) changes.

Phing's source code is formatted according to the PSR-2 standard.

### Running the (unit) tests

[](#running-the-unit-tests)

If you'd like to contribute code to Phing, please make sure you run the tests before submitting your pull request. To successfully run all Phing tests, the following conditions have to be met:

- PEAR installed, channel "pear.phing.info" discovered
- Packages "python-docutils" and "subversion" installed
- php.ini setting "phar.readonly" set to "Off"

Then, perform the following steps (on a clone/fork of Phing):

```
     $ composer install
     $ cd tests
     $ ../bin/phing

```

Licensing
---------

[](#licensing)

This software is licensed under the terms you may find in the file named "LICENSE" in this directory.

Proud to use:

[![PhpStorm Logo](https://camo.githubusercontent.com/1e31d98d23a59aa7fddbdae1155126adeac9ad6cded9a478fc8c5d377942c433/68747470733a2f2f7265736f75726365732e6a6574627261696e732e636f6d2f73746f726167652f70726f64756374732f636f6d70616e792f6272616e642f6c6f676f732f50687053746f726d2e737667 "Proud to use")](https://www.jetbrains.com/phpstorm)

Contributing
------------

[](#contributing)

We love contributions!

Thanks to all the people who already contributed!

[ ![](https://camo.githubusercontent.com/d6d6488156c624729fd1a37a371a659185c099e962864dad2c3c0f1e463edf09/68747470733a2f2f636f6e7472696275746f72732d696d672e7765622e6170702f696d6167653f7265706f3d7068696e676f6666696369616c2f7068696e67)](https://github.com/phingofficial/phing/graphs/contributors)

###  Health Score

78

—

ExcellentBetter than 100% of packages

Maintenance86

Actively maintained with recent releases

Popularity73

Solid adoption and visibility

Community61

Healthy contributor diversity

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 62.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~112 days

Recently: every ~161 days

Total

46

Last Release

101d ago

Major Versions

2.16.1 → 3.0.0-alpha12018-03-23

2.16.3 → 3.0.0-alpha42020-07-04

2.16.4 → 3.0.0-RC12021-02-17

2.17.0 → 3.0.0-RC32021-09-09

2.17.4 → 3.0.0-RC42023-01-20

PHP version history (8 changes)2.4.12PHP &gt;=5.2.0

3.0.0-alpha1PHP &gt;=7.1

3.0.0a3PHP ^7.1.3

3.0.0-alpha4PHP ^7.3 || ^7.4

3.0.0-RC1PHP ^7.3 || ^7.4 || ^8.0

3.0.0-RC4PHP ^7.3 || ^7.4 || ^8.0 || ^8.1

3.0.0-rc5PHP &gt;= 7.4

3.1.0PHP &gt;= 8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/197f7436c47067343def1d182dd597dbd104774fe17071e0b983487dc3652fe8?d=identicon)[siad007](/maintainers/siad007)

![](https://www.gravatar.com/avatar/a44b54e66ddb560dcbb821b6036d4d993e6e87a3f94c7fe9f283e935a20e3b69?d=identicon)[mrook](/maintainers/mrook)

---

Top Contributors

[![mrook](https://avatars.githubusercontent.com/u/477719?v=4)](https://github.com/mrook "mrook (2739 commits)")[![siad007](https://avatars.githubusercontent.com/u/2149445?v=4)](https://github.com/siad007 "siad007 (840 commits)")[![hozn](https://avatars.githubusercontent.com/u/391939?v=4)](https://github.com/hozn "hozn (149 commits)")[![farazdagi](https://avatars.githubusercontent.com/u/188194?v=4)](https://github.com/farazdagi "farazdagi (130 commits)")[![johan162](https://avatars.githubusercontent.com/u/1390967?v=4)](https://github.com/johan162 "johan162 (77 commits)")[![jawira](https://avatars.githubusercontent.com/u/496541?v=4)](https://github.com/jawira "jawira (67 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (66 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (61 commits)")[![kenguest](https://avatars.githubusercontent.com/u/234118?v=4)](https://github.com/kenguest "kenguest (46 commits)")[![llaville](https://avatars.githubusercontent.com/u/364342?v=4)](https://github.com/llaville "llaville (27 commits)")[![winkbrace](https://avatars.githubusercontent.com/u/1883930?v=4)](https://github.com/winkbrace "winkbrace (20 commits)")[![cweiske](https://avatars.githubusercontent.com/u/59036?v=4)](https://github.com/cweiske "cweiske (20 commits)")[![HuffAndPuff](https://avatars.githubusercontent.com/u/3001764?v=4)](https://github.com/HuffAndPuff "HuffAndPuff (18 commits)")[![grasmash](https://avatars.githubusercontent.com/u/539205?v=4)](https://github.com/grasmash "grasmash (14 commits)")[![chasepeeler](https://avatars.githubusercontent.com/u/155993?v=4)](https://github.com/chasepeeler "chasepeeler (11 commits)")[![sad-spirit](https://avatars.githubusercontent.com/u/4820288?v=4)](https://github.com/sad-spirit "sad-spirit (11 commits)")[![alexeyshockov](https://avatars.githubusercontent.com/u/203120?v=4)](https://github.com/alexeyshockov "alexeyshockov (10 commits)")[![extraordinaire](https://avatars.githubusercontent.com/u/109460?v=4)](https://github.com/extraordinaire "extraordinaire (9 commits)")[![mimmi20](https://avatars.githubusercontent.com/u/1120192?v=4)](https://github.com/mimmi20 "mimmi20 (9 commits)")[![MiRacLe-RPZ](https://avatars.githubusercontent.com/u/920542?v=4)](https://github.com/MiRacLe-RPZ "MiRacLe-RPZ (9 commits)")

---

Tags

antbuild-automationbuild-toolmakephingphpphpdevtooltaskphingmakebuildbuild-toolantbuild-automation

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/phing-phing/health.svg)

```
[![Health](https://phpackages.com/badges/phing-phing/health.svg)](https://phpackages.com/packages/phing-phing)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

53541.0k3](/packages/jolicode-castor)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)[netgen/layouts-core

Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul.

3689.4k10](/packages/netgen-layouts-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
