XML And Phing
一个合法的Phing构建文件有以下几部分构成：
1.文档序言
2.唯一的根元素<project>
3.一些Phing的type元素（比如<property>, <fileset>, <patternset>等）
4.一个或多个<target>元素，每个target包含内建或用户自定义的Phing task元素（例如<install>,
<bcc>等）。

Writing A Simple Buildfile
Foobar项目将一些php文件从源目录安装到目标目录，并将这些文件作了打包处理。
[html]
<?xml version="1.0" encoding="UTF-8"?> 
<project name="FooBar" default="dist"> 
    <!-- ============================================ --> 
    <!-- Target: prepare --> 
    <!-- ============================================ --> 
    <target name="prepare"> 
        <echo msg="Making directory ./build" /> 
        <mkdir dir="./build" /> 
 
    </target> 
    <!-- ============================================ --> 
    <!-- Target: build --> 
    <!-- ============================================ --> 
    <target name="build" depends="prepare"> 
        <echo msg="Copying files to build directory..." /> 
        <echo msg="Copying ./about.php to ./build directory..." /> 
        <copy file="./about.php" tofile="./build/about.php" /> 
        <echo msg="Copying ./browsers.php to ./build directory..." /> 
        <copy file="./browsers.php" tofile="./build/browsers.php" /> 
        <echo msg="Copying ./contact.php to ./build directory..." /> 
        <copy file="./contact.php" tofile="./build/contact.php" /> 
    </target> 
    <!-- ============================================ --> 
    <!-- (DEFAULT) Target: dist --> 
    <!-- ============================================ --> 
    <target name="dist" depends="build"> 
        <echo msg="Creating archive..." /> 
        <tar destfile="./build/build.tar.gz" compression="gzip"> 
            <fileset dir="./build"> 
                <include name="*" /> 
            </fileset> 
        </tar> 
        <echo msg="Files copied and compressed in build directory OK!" /> 
    </target> 
</project> 

<?xml version="1.0" encoding="UTF-8"?>
<project name="FooBar" default="dist">
    <!-- ============================================ -->
    <!-- Target: prepare -->
    <!-- ============================================ -->
    <target name="prepare">
        <echo msg="Making directory ./build" />
        <mkdir dir="./build" />

    </target>
    <!-- ============================================ -->
    <!-- Target: build -->
    <!-- ============================================ -->
    <target name="build" depends="prepare">
        <echo msg="Copying files to build directory..." />
        <echo msg="Copying ./about.php to ./build directory..." />
        <copy file="./about.php" tofile="./build/about.php" />
        <echo msg="Copying ./browsers.php to ./build directory..." />
        <copy file="./browsers.php" tofile="./build/browsers.php" />
        <echo msg="Copying ./contact.php to ./build directory..." />
        <copy file="./contact.php" tofile="./build/contact.php" />
    </target>
    <!-- ============================================ -->
    <!-- (DEFAULT) Target: dist -->
    <!-- ============================================ -->
    <target name="dist" depends="build">
        <echo msg="Creating archive..." />
        <tar destfile="./build/build.tar.gz" compression="gzip">
            <fileset dir="./build">
                <include name="*" />
            </fileset>
        </tar>
        <echo msg="Files copied and compressed in build directory OK!" />
    </target>
</project>一个phing的构建文件通常以build.xml命名。如果没有指定文件名，phing会将build.xml作为默认执行的文件。
执行上面构建文件中的默认target，只要直接运行phing。
这将执行名为dist的target。执行构建文件中的task时将会输出一些信息，显示受影响的文件。
如果要执行其它target，只要在命令行中写明相应的target名字即可。例如要执行名为build的target，只要执行：phing build即可。
其它命令行参数请参见附录A（Fact Sheet）。

Project Element
文档序言之后的第一个元素就是根元素<project>。其它元素必须包含在<project>之中。它有以下属性：
属性 含意 是否必须
name 项目名称 否
basedir 当前项目的起始目录，“.”表示当前目录。
注意：如果未指定此参数，则构建文件的父目录将被设为默认值。 否
default 指定默认的target。如果在调用当前文件时未指定target，
将执行默认target。 是
description 项目描述 否

 

Target Element
一个target可以依赖其它target。Phing会处理它们之间的依赖关系。
注意，Phing的depend属性仅能指定target的执行顺序，不能确认依赖的target一定执行。当被依赖的target没有必要执行时，Phing就不会执行它。
Phing按照从左至右的顺序执行depends属性中指定的target。注意，一个被依赖的target可能在早在之前由于另一个依赖关系的存在而被执行过，这时它将不会再被执行。
下面的例子将说明这一点：
[html]
<target name="A" /> 
<target name="B" depends="A" /> 
<target name="C" depends="B" /> 
<target name="D" depends="C,B,A" /> 

<target name="A" />
<target name="B" depends="A" />
<target name="C" depends="B" />
<target name="D" depends="C,B,A" />假定我们想执行target D。根据它的depends属性，你可能会认为执行顺序会是，C，B，A。错！C依赖B，B依赖A，因此A会先执行，然后是B，接下来是C，最后是D。
一个target只会执行一次，即使有很多taget依赖它时也是如此。
description属性用于描述此target，命令行模式时可以通过-projecthelp选项将其打印出来。

Task Elements
一个task是一段可以被执行的php代码。这段代码完成一个特定的功能（比如安装文件）。它在构建文件中定义，由Phing来调用。
task的基本结构如下：
[html]
<name attribute1="value1" attribute2="value2" ... /> 

<name attribute1="value1" attribute2="value2" ... />name是task名称，attributeN是属性名，valueN是属性值。
有一系列的core task（参见附录B，Core Tasks）以及一些optional task。你也可以很方便的定义自己的task（参见第6章，Extending Phing）。
task可以被赋予一个id属性：
[html]
<taskname id="taskID" ... /> 

<taskname id="taskID" ... />可以在其它task中通id引用这个task。

Property Element
property是构建文件中的重要变量。通过PropertyTask设定property，也可以通过命令方式设定（命令行中设定的property值会覆盖构建文件中的同名property值）。一个property只能有一个名字和一个值。property可以成为task的属性值，使用时只需要将property的名字放在“${”和"｝"之间即可。例如，假设我们定义了一个property叫作BC_BUILD_DIR，它的值为‘build’，我们可以这样使用它：${BC_BUILD_DIR}/en。这条语句会被解析为build/en。
如果你使用了没有通过property task定义的property，phing会从系统的环境变量中查找是否有同名property。例如，假如你使用了${BCHOME}，但你没有在命令行或构建文件中定义它，而环境变量中存在此值，那phing就会使用环境变量中的BCHOME值。

Built-in Properties
phing提供了访问系统属性的方法，其用法和通过<property>task定义的属性一样。比如，${os.name}代表的操作系统的名子。更多信息可参见附录A中的Built-In Properties。

More Complex Buildfile
[html]
<?xml version="1.0" encoding="UTF-8" ?> 
    <project name="testsite" basedir="." default="main"> 
    <property file="./build.properties" /> 
    <property name="package" value="${phing.project.name}" override="true" /> 
    <property name="builddir" value="./build/testsite" override="true" /> 
    <property name="srcdir" value="${project.basedir}" override="true" /> 
    <!-- Fileset for all files --> 
    <fileset dir="." id="allfiles"> 
        <include name="**" /> 
    </fileset> 
    <!-- ============================================ --> 
    <!-- (DEFAULT) Target: main --> 
    <!-- ============================================ --> 
    <target name="main" description="main target"> 
        <copy todir="${builddir}"> 
            <fileset refid="allfiles" /> 
        </copy> 
    </target> 
    <!-- ============================================ --> 
    <!-- Target: Rebuild --> 
    <!-- ============================================ --> 
    <target name="rebuild" description="rebuilds this package"> 
        <delete dir="${builddir}" /> 
        <phingcall target="main" /> 
    </target> 
</project> 

<?xml version="1.0" encoding="UTF-8" ?>
    <project name="testsite" basedir="." default="main">
    <property file="./build.properties" />
    <property name="package" value="${phing.project.name}" override="true" />
    <property name="builddir" value="./build/testsite" override="true" />
    <property name="srcdir" value="${project.basedir}" override="true" />
    <!-- Fileset for all files -->
    <fileset dir="." id="allfiles">
        <include name="**" />
    </fileset>
    <!-- ============================================ -->
    <!-- (DEFAULT) Target: main -->
    <!-- ============================================ -->
    <target name="main" description="main target">
        <copy todir="${builddir}">
            <fileset refid="allfiles" />
        </copy>
    </target>
    <!-- ============================================ -->
    <!-- Target: Rebuild -->
    <!-- ============================================ -->
    <target name="rebuild" description="rebuilds this package">
        <delete dir="${builddir}" />
        <phingcall target="main" />
    </target>
</project>
这份构建文件首先定义了一些property。然后定义了一个fileset和二个target。下面我们来快速解读下这份文件。
project标签中的前五行用于定义property。它们展现了property标签的两种使用形式：
1.第二个property标签只包含了一个file属性。这个值必须对应一个property文件，可以使用绝对或相对路径（文件格式参见附录I，File Formats）。
2.标签中含有name和value属性。执行后，可以通过${name}的方式取得value值。

接下来我们看<fileset>标签。它定义了一个文件集合。你可以使用inlude和exclude标签来加入或排除文件。如果给fileset设置了id属性，那么可以通过id引用该fileset。

下面说一说双星表达式“**”。这个特定的正则表示所有子目录下的所有文件。而一星“*”，只表示当目录下的所有文件。
例：
[html]
**/*.phps 

**/*.phps表示当前目录下，所有子目录中的后缀为phps的文件。

第一个task是一个<copy>。注意copy标签中的fileset，它没有包含include或是exclude元素，而是通过refid引用了之前创建好的一个fileset。通过这种方式，你可以定义一个fileset，然后多次在构建文件中使用。

在第二个target中唯一值得注意的就是<phingcall> 标签（更多信息可参见PhingCallTask）。这个task执行了和自己位于同一文件中的另外一个target。第二个target删除了build目录，然后调用main重新构建项目。

如果在命令行中使用-D参数给property赋值，则构建文件中的同名property的值将会被覆盖。例如，如果在命令行中执行
[plain] view plaincopyprint?phing -Dbuilddir=/tmp/system-test 

phing -Dbuilddir=/tmp/system-test上例中的builddir值将不再是./build/testsite，而是/tmp/system-test。