您當(dāng)前位置：首頁 > 數(shù)據(jù)庫 > access > PHP 實現(xiàn)的項目構(gòu)建工具：Phing

PHP 實現(xiàn)的項目構(gòu)建工具：Phing

來源：程序員人生發(fā)布時間：2014-09-25 00:46:48 閱讀次數(shù)：4796次

前言

Phing 是一個 PHP 實現(xiàn)的項目構(gòu)建工具。按照官方文檔的說法，你可以用它做任何傳統(tǒng)的構(gòu)建(build/make)工具（比如 Java 的 Ant，GNU Make 等）能做的所有工作。PHP 中比較有名的 framework: Symfony 就用到了 Phing — 順便提一下，Symfony 中還用到了另外一個 PHP 的輕量級 build 工具： PHP Pake(http://www.pake-project.com/) 。

下面的文檔由 httpnet 翻譯，本人( Hick )整理，網(wǎng)頁中只提供了部分內(nèi)容摘要，請下載 pdf 文檔查看全文。本人也在學(xué)習(xí)階段，錯漏之處歡迎指正。

官方網(wǎng)站：http://phing.info/
用戶文檔：http://phing.info/docs/guide/2.2.0/
PDF 下載：Phing 用戶指南
原文地址：http://blog.csdn.net/httpnet/archive/2005/04/20/354864.aspx
本文地址：http://www.hickwu.com/?p=12

Phing 簡介

Phing 是一個基于 Apache Ant 的項目代碼構(gòu)建系統(tǒng).你可以用她做傳統(tǒng)的構(gòu)建系統(tǒng)能做的任何事情,比如 GNU make, 并且 Phing 使用簡單的XML構(gòu)建文件和可擴(kuò)展的”任務(wù)”使之成為易于使用和極具可擴(kuò)展性的框架.

因為 Phing 是基于 Ant 的,所以本手冊部分內(nèi)容是摘自 Ant 手冊.

Phing源自Binarycloud的一個子項目.Binaryclound是一個高度工程化的框架,為了在企業(yè)環(huán)境中使用而設(shè)計.Binarycloud廣泛使用XML來存儲關(guān)于項目的元數(shù)據(jù)(配置,節(jié)點,窗口小部件,站點結(jié)構(gòu),等等).

因為Binarycloud是為PHP構(gòu)建的,在每一個頁面請求上執(zhí)行XML處理和轉(zhuǎn)換是不切實際的.Phing用于”編譯”XML元數(shù)據(jù)為可被PHP引擎處理的數(shù)組形式.

當(dāng)然, XML ”編譯”只是 Binarycloud 使用 Phing 構(gòu)建系統(tǒng)的許多方法中的一個. Phing 構(gòu)建系統(tǒng)使你能夠:

1. 從單一的源代碼樹構(gòu)建多語言頁面.

2. 在單個 XML 文件中聚集元數(shù)據(jù)(Metadata)并且用多個不同的 XSLT 生成幾個文件.（譯者注:在 XSLT2.0 規(guī)范中,消除了1.0規(guī)范只能有一個輸入一個輸出的限制,現(xiàn)在我們可以做到單一輸入來生成多個輸出文件）

最初, Binarycloud 使用 GNU make 構(gòu)建系統(tǒng),但是,這樣有些缺點. 在 makefile 中的”Space before tab problem”問題.實際上,它僅在 UNIX 系統(tǒng)上沒有問題.因此需要尋找一個更好的構(gòu)架系統(tǒng). Apache Ant 是一個不錯的選擇—它使用 XML 構(gòu)建文件和模塊化的設(shè)計.但問題是 Ant 用 java 寫成,要使用它你必須得在你得計算機(jī)上安裝 Java 虛擬機(jī).

因此, Phing 開始開發(fā)了, Phing 是一個借助于 Ant 的思想用 PHP 寫成的構(gòu)建系統(tǒng).第一版同時設(shè)計和開發(fā),因此不是十分穩(wěn)定.系統(tǒng)很快暴露出了它的限制并且需要一個更好的 Phing 系統(tǒng).因此衍生了 Phing2 的雛形.

Phing 當(dāng)前的開發(fā)集中于 Phing2,它涉及許多功能增強(qiáng), bug 修正,并且最值得注意的轉(zhuǎn)變是用 PHP5 的抽象類,接口,和 try/catch/throw 異常處理來重寫了原來 Phing 的基礎(chǔ)代碼.

Phing 使用包含一組項目構(gòu)建描述的 XML 構(gòu)建文件.構(gòu)建文件由一些運(yùn)行實際的命令的目標(biāo)組成(比如復(fù)制文件,刪除目錄,執(zhí)行數(shù)據(jù)庫查詢,等等).因此使用 Phing ,第一步要編寫構(gòu)建文件,然后運(yùn)行 Phing ,在構(gòu)建文件中定義的要執(zhí)行的目標(biāo).

phing -f mybuildfile.xml mytarget

鍵入 phing –h 可以查看命令參數(shù)的描述.

默認(rèn)情況下, Phing 將會查找一個叫 build.xml 的文件.(除非構(gòu)建文件的名稱不是 build.xml ,否則不必為 Phing 指定構(gòu)建文件的名稱) 并且,如果沒有指定任何目標(biāo)那么 Phing 將執(zhí)行在 <project> 標(biāo)簽中設(shè)置的默認(rèn)目標(biāo)( default 屬性所指定的).

安裝 Phing

要使用 Phing 你必須安裝 PHP5.0.0b1 和以上的版本并且加上 –with-libxml2, 和 –with-xsl 選項. 自2.0.0b1版之后,你可以可以下載 PEAR 可安裝包和完全的 Phing 分發(fā)包.如果你希望修改 Phing ,我們建議你下載完整的 Phing 發(fā)行包,這樣你可以創(chuàng)建你自己的 PEAR 包.如果你知識簡單地使用 Phing 作為項目的需要或構(gòu)建其他的包,下載并且安裝 PEAR 包.

安裝 Phing 最簡易的方法是使用 PEAR 安裝工具.

C:/> pear install http://phing.info/pear/phing-current.tgz

( Hick 說明：這里是假設(shè) pear.bat 所在目錄，通常是 php 安裝目錄在系統(tǒng)環(huán)境變量 PATH 中，否則請先在命令行下切換到 pear.bat 所在目錄。)

PEAR 安裝工具將檢查包的依賴性,并把 Phing 的執(zhí)行腳本放到 PHP 的安裝目錄下面( PEAR 命令腳本同時也在這個目錄下面)

下載完整的發(fā)行包及非pear安裝方法見 http://phing.info/docs/guide/2.2.0/chapters/Setup.html

調(diào)用 Phing

命令行
phing [targetname]

XML 和 Phing

構(gòu)建文件有如下基本結(jié)構(gòu):

1．文檔序言（document prolog）
2．根元素 <project>
3．幾個類型元素（<property>,<fileset>,<patternset>）
4．包含一個或幾個內(nèi)建的或用戶自定義的任務(wù)元素(例如:<javac>,<tar>)

編寫一個簡單的構(gòu)建文件

<? xml version = " 1.0 " encoding = " utf-8 " ?>
< project name = " FooBar " default = " dist " basedir = " . " >
< target name = " prepare " >
< echo msg = " Preparing build... " />
< mkdir dir = " ./pub " />
</ target >
< target name = " build " depends = " prepare " >
< echo > Building... </ echo >
< copy todir = " ./pub/ " >
< fileset dir = " ./src/ " >
</ fileset >
</ copy >
</ target >
< target name = " dist " depends = " build " if = "" >
< echo message = " Creating archive... " />
< tar destfile = " ./phing.tar " compression = " tar " >
< fileset dir = " ./pub " >
</ fileset >
</ tar >
</ target >
< target name = " clean " >
< echo msg = " Cleaning up... " />
< delete dir = " ./pub " includeemptydirs = " true " verbose = " true " failonerror = " true " />
</ target >
</ project >

project 元素

文件序言之后緊跟著的第一個元素的是<project>,此元素是一個包含其他元素的容器,并且有以下屬性:

name 項目的名稱
basedir 項目的根目錄,如果未指定將使用當(dāng)前目錄
default 在調(diào)用構(gòu)建文件的時候,如果沒有指定要執(zhí)行的目標(biāo),
將執(zhí)行在此定義的項目默認(rèn)目標(biāo)
description 項目的描述

target 元素

一個目標(biāo)(target)可依賴其他的目標(biāo).你可能有一個在構(gòu)建樹中安裝文件的目標(biāo),例如,創(chuàng)建一個 tar.tgz 分發(fā)包的目標(biāo).

Target元素的屬性:

屬性含義要求
name 目標(biāo)的名稱 Yes
depends 此目標(biāo)依賴的逗號分隔列表 No
if 為了使此目標(biāo)得以執(zhí)行而必須設(shè)置的屬性的名稱 No
unless 為了使此目標(biāo)得以執(zhí)行而禁止設(shè)置的屬性的名稱 No

property 元素

屬性是在構(gòu)建文件使用的基本的變量,可以在構(gòu)建文件中通過 PropertyTask 任務(wù)設(shè)置或在 Phing 外部通過命令行傳遞.通過命令行傳遞的屬性總是會覆蓋在構(gòu)建文件中設(shè)置的屬性,也就是說命令行是最后傳遞給 Phing 的,自然會覆蓋先前在構(gòu)建文件中設(shè)置的屬性.

屬性有一個名稱和一個唯一的值.屬性可以作為任務(wù)屬性的值.這是通過在”${”和”}”包含屬性名稱來設(shè)置的.例如:

< property name = " sourcedir " value = " /src/data/ " />
< echo msg = " ${sourcedir} " />

這里在運(yùn)行時${sourcedir}將被展開為/src/java

或者在命名行中：

phing –Dsourcedir=”/backup/data/” –f mybuild.xml

內(nèi)建屬性

Phing給你提供了訪問系統(tǒng)屬性的能力,好像它已經(jīng)通過定義過的一樣.例如,${php.version}展開為php的版本.

http://phing.info/docs/guide/2.2.0/chapters/appendixes/AppendixA- 有完整的內(nèi)建屬性的列表
一個復(fù)雜的例子

<? xml version = " 1.0 " ?>
< project name = " testsite " basedir = " . " default = " main " >
< property file = " ./mybuild.properties " />
< property name = " builddir " value = " ${projectdir}/pub " override = " true " />
< property name = " srcdir " value = " ${projectdir}/src " override = " true " />
< fileset dir = " ${srcdir} " id = " allfiles " >
< include name = " * " />
< exclude name = " *.txt " />
</ fileset >
< target name = " main " description = " main target " >
< copy todir = " ${builddir} " >
< fileset refid = " allfiles " />
</ copy >
</ target >
< target name = " rebuild " description = " rebuilds this package " >
< delete file = " ${builddir}/*.* " />
< phingcall target = " main " />
</ target >
</ project >