phing用户手册第四章Getting Started译文
phing用户手册第四章Getting Started译文
本章是phing的入门篇，查看 原文请猛击这里。
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文件从源目录安装到目标目录，并将这些文件作了打包处理。
<?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可能在早在之前由于另一个依赖关系的存在而被执行过，这时它将不会再被执行。
下面的例子将说明这一点：
<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的基本结构如下：
<name attribute1="value1" attribute2="value2" ... />name是task名称，attributeN是属性名，valueN是属性值。
有一系列的core task（参见附录B，Core Tasks）以及一些optional task。你也可以很方便的定义自己的task（参见第6章，Extending Phing）。
task可以被赋予一个id属性：
<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
<?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。
下面说一说双星表达式“**”。这个特定的正则表示所有子目录下的所有文件。而一星“*”，只表示当目录下的所有文件。
例：
**/*.phps表示当前目录下，所有子目录中的后缀为phps的文件。
第一个task是一个<copy>。注意copy标签中的fileset，它没有包含include或是exclude元素，而是通过refid引用了之前创建好的一个fileset。通过这种方式，你可以定义一个fileset，然后多次在构建文件中使用。
在第二个target中唯一值得注意的就是<phingcall> 标签（更多信息可参见PhingCallTask）。这个task执行了和自己位于同一文件中的另外一个target。第二个target删除了build目录，然后调用main重新构建项目。
如果在命令行中使用-D参数给property赋值，则构建文件中的同名property的值将会被覆盖。例如，如果在命令行中执行
phing -Dbuilddir=/tmp/system-test上例中的builddir值将不再是./build/testsite，而是/tmp/system-test。