用 DomIt! 做简单的 XML 处理工作

有一次我拿到了个处理 XML 文件的活儿。这个 XML 文件是用来跟 Flash mp3 播放器做通信使用的，包含了音乐的地址、描述等。我需要做的仅仅是让管理员可以通过一个表单完成添加、删除音乐项并更新 XML 文件。听起来很简单吧？但我却在做删除功能时遇到了麻烦。在我花了无数时间抓耳挠腮想办法、搜索、翻阅官方 PHP 文档里关于 DOM XML 的内容时，DomIt! 及时地出现了（其实是我及时地找到了）。DomIt! 非常的强大、易用（至少拿来做简单的处理工作时）、兼容 PHP4，并且在愿意细读它的源代码时帮助你快速地学好 DOM XML。

当时需要的 XML 文件为如下格式：

<?xmlversion="1.0"?>

<audio>

<file>

<track>音乐文件位置</track>

<caption>音乐文件标题</caption>

<record>音乐录制信息</record>

</file>

</audio>

当然，这个 XML 文件在我接这活儿的时候已经预先给了。但我想使用 DomIt! 创建这样的一个文件作为本系列的第一部分内容，同时也是为了展示 DomIt! 的强大和易用。

首先我们要做的是调用 DomIt! 的库文件（到这里，下载、解压 DomIt! 库并将所有的文件放入与下面将要创建的程序文件相同的目录），并创建一个 DomIt! 文档实例：

require_once('xml_domit_include.php');

$xmlDoc=&newDOMIT_Document();// 文档实例

注意“&”符号是用来兼容 PHP4 的。

这样我们就准备好一个实例可以按需使用了。看到 XML 文件内容中的第一行了么？没错，我们要添加 XML 的文件声明：

$xmlDecl=&$xmlDoc->createProcessingInstruction('xml','version="1.0"');

$xmlDoc->appendChild($xmlDecl);

在这我们可以看到声明信息也被当作是一个子节点做处理，也算是合理的定义。但这里我们可以发现 createProcessingInstruction() 方法存在一个明显的缺点——只有两个声明参数（通常我们可能还会定义编码之类的 XML 声明信息）。幸运的是我们使用的是一个开源的库，也就是说我们可以轻易地将它修改定制以满足要求。如果你实在需要帮助来修改这个特定的方法以添加足够的 XML 文件声明信息（如编码等），我将在本系列的最后一篇中加以介绍。

让我们回到正题。完成 XML 文件声明部分后，我们在 XML 文件内容中看到的是“audio”标签。它是这个 XML 文件中的根元素（根节点）。让我们来创建这部分：

$rootElement=&$xmlDoc->createElement('audio');

$xmlDoc->appendChild($rootElement);

你不需要担心标签关闭的问题，DomIt! 已经完全替你做好了。利用类似的方法，我们将建立“audio”的子节点——“file”元素；在“file”元素内，还包含了几个姊妹元素“track”、“caption”和“record”及它们的文字内容。既然创建它们时都要用到一个主要的方法 appendChild()，我们可以归纳到一起说：

// "file" 元素

$fileElement=&$xmlDoc->createElement('file');



// "track" 元素

$trackElement=&$xmlDoc->createElement('track');

// 增加"track"元素的文本内容

$trackElement->appendChild($xmlDoc->createTextNode('音乐文件位置'));

// 添加到"file"元素中去

$fileElement->appendChild($trackElement);



// "caption" 元素，其他同"track"

$captionElement=&$xmlDoc->createElement('caption');

$captionElement->appendChild($xmlDoc->createTextNode('音乐文件标题'));

$fileElement->appendChild($captionElement);



// "record" 元素，其他同"track"

$recordElement=&$xmlDoc->createElement('record');

$recordElement->appendChild($xmlDoc->createTextNode('音乐录制信息'));

$fileElement->appendChild($recordElement);

就像之前说的，核心部分是 appendChild() 方法。在不同的实例上调用它就可以起到不同的作用（这就是面向对象）。如果你用 appendChild() 将“track”元素添加进“audio”，那“file”和“track”就变成姊妹节点了。

完成创建所有节点的工作后，我们需要将这些内容添加进“audio”元素，或许你还想将最后的内容输出到屏幕上查看、以及保存到真正的 XML 文件中去：

// 添加所有"file"元素里的内容到"audio"里

$rootElement->appendChild($fileElement);

// 在屏幕上（网页）打印出来

echo$xmlDoc->toNormalizedString(true);

// 将文档实例保存进一个真正的 XML 文件中

$xmlDoc->saveXML('audio.xml',true);

然后在屏幕上（浏览器中），你可以看到：

<?xmlversion="1.0"?>

<audio>

<file>

<track>音乐文件位置</track>

<caption>音乐文件标题</caption>

<record>音乐录制信息</record>

</file>

</audio>

与给我的文件内容一模一样。这就是《用 DomIt! 做简单的 XML 处理工作》第一部分的结尾。下一篇，我将谈谈如何修改我们刚刚创建的 XML 文件，包括对内容的添加、删除和编辑。

哦，我还忘了给你们一个 DomIt! 明显的下载链接（我知道可能你们很多人已经 Google 出来了）：http://sourceforge.net/projects/domit-xmlparser/

到这里下载一份 DomIt!，并且可以在下一篇出炉前读读它的文档。