感谢您使用 PHING!
PH ing不是G NU制造;它是一个基于 Apache Ant 的 PHP 项目构建系统或构建工具。您可以用它做任何您可以用 GNU make 等传统构建系统做的事情,并且它使用简单的 XML 构建文件和可扩展的 PHP“任务”类使其成为一个易于使用且高度灵活的构建框架。
功能包括运行 PHPUnit 单元测试(包括测试结果和覆盖率报告)、文件转换(例如令牌替换、XSLT 转换、模板转换)、文件系统操作、交互式构建支持、SQL 执行、SCM 操作(Git、Subversion 和 Mercurial)、文档生成(PhpDocumentor、ApiGen)等等。
如果您发现自己正在编写自定义脚本来处理应用程序的打包、部署或测试,那么我们建议您查看 Phing。预封装了众多开箱即用的操作模块(任务),以及易于使用的 OO 模型来扩展或添加您自己的自定义任务。
欲了解更多信息和文档,您可以访问我们的官方网站:https://www.phing.info/。
Phing 3 是一次重大更新,与 Phing 2 相比,有一些重大更改。有关详细信息,请参阅 UPGRADING.md 文件。
Phing 3.x 与 PHP 7.4 及更高版本兼容。
安装 Phing 的首选方法是通过 Composer。将 phing/phing 添加到项目composer.json
配置文件的 require-dev 或 require 部分,然后运行“composer install”:
{
"require-dev": {
"phing/phing": "3.0.x-dev"
}
}
下载 Phar 存档。然后可以通过运行以下命令来执行存档:
$ php phing-latest.phar
官方 Phing Docker 镜像可以在 Docker Hub 上找到。
要在容器内执行 Phing 并执行位于/home/user
中的build.xml
,请运行以下命令:
$ docker run --rm -v /home/user:/opt phing/phing:3.0 -f /opt/build.xml
官方 GitHub 操作 phingofficial/phing-github-action 可在 GitHub Marketplace 上找到。
要将Phing 构建作为操作运行,您需要设置.github/workflow/phing.yml
工作流程文件并粘贴以下片段:
name: CI
on: [ push ]
jobs:
build-test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Phing Build
uses: phingofficial/[email protected]
with:
version: 3.0.0-alpha4
user-properties: prop=FooBar
targets: foo
verbose: true
有关更多信息和文档的自述文件。
Phing 的文档可以在 https://www.phing.info/#docs 中找到。
有关文档的来源,请访问 https://github.com/phingofficial/guide。
多年来,开发和维护 Phing 花费了很多时间。如果您想表达您的谢意,可以使用以下方法之一向项目维护者 Michiel Rook 捐赠一些东西:
谢谢你!
当用户报告问题或提出功能请求时,我们非常感激。但是,在提交新问题之前,您应该遵守一些准则:
可以在 GitHub 上报告问题。
向 Phing 提交代码的最佳方式是在 GitHub 上发出 Pull 请求。请帮助我们快速合并您的贡献并保持您的拉取请求干净简洁:压缩提交并且不要引入不必要的(空白)更改。
Phing 的源代码按照 PSR-2 标准进行格式化。
如果您想向 Phing 贡献代码,请确保在提交拉取请求之前运行测试。要成功运行所有 Phing 测试,必须满足以下条件:
然后,执行以下步骤(在 Phing 的克隆/分支上):
$ composer install
$ cd tests
$ ../bin/phing
该软件根据您可以在此目录中名为“LICENSE”的文件中找到的条款获得许可。
自豪地使用:
我们热爱贡献!
感谢所有已经做出贡献的人!