用 SAX 方式解析 XML,得自己湊出三個函式,還要直接靠這三個函式回傳資料,邏輯一複雜就難寫;換成不同結構的 XML 還得重寫一遍,很麻煩。
改用 DOM 方式確實好些,但它把每個節點都當成一個 node,操作起來要寫一大堆程式碼,同樣麻煩。
網路上開源的 XML 解析類庫不少,但用起來總覺得不太踏實,像是跟在別人屁股後面。於是就花了一天時間自己寫了一個——用 PHP 5 實作,做法是包裝 SAX 的解析結果,對我個人來說相當實用,效能也還過得去,多數處理需求都能應付。
第一,每個節點最好都帶一個 id。程式的命名規則是「節點標籤_節點 id」,若沒設 id,程式會自動用該節點在上層節點中的位置編號補上,從 0 開始。
第二,查詢節點時用 | 串接各層的「節點名字」,順序由外而內。例如 cat_food|goods_food11 就是「food 分類底下 id 為 food11 的商品」。
注意這個類別以 PHP 5 實作,在 PHP 4 下無法正常執行。
<?xml version="1.0" encoding="GB2312"?>
<shop>
<name>華聯</name>
<address>北京長安街-9999號</address>
<desc>連鎖超市</desc>
<cat id="food">
<goods id="food11">
<name>food11</name>
<price>12.90</price>
</goods>
<goods id="food12">
<name>food12</name>
<price>22.10</price>
<desc creator="hahawen">好東西推薦</desc>
</goods>
</cat>
<cat>
<goods id="tel21">
<name>tel21</name>
<price>1290</price>
</goods>
</cat>
<cat id="coat">
<goods id="coat31">
<name>coat31</name>
<price>112</price>
</goods>
<goods id="coat32">
<name>coat32</name>
<price>45</price>
</goods>
</cat>
<special id="hot">
<goods>
<name>hot41</name>
<price>99</price>
</goods>
</special>
</shop>
<?php
require_once "XML/SimpleDocumentParser.php";
require_once "XML/SimpleDocumentBase.php";
require_once "XML/SimpleDocumentRoot.php";
require_once "XML/SimpleDocumentNode.php";
$test = new SimpleDocumentParser();
$test->parse("test.xml");
$dom = $test->getSimpleDocument();
echo "<pre>";
// 1. 匯出整份 XML 的資料陣列
print_r($dom->getSaveData());
// 2. 為根節點新增節點,並輸出結果
$dom->setValue("telphone", "123456789");
echo htmlspecialchars($dom->getSaveXML());
// 3. 取出 food 分類下的所有商品
$obj = $dom->getNode("cat_food");
$nodeList = $obj->getNode();
foreach ($nodeList as $node) {
$data = $node->getValue();
echo "商品名:" . $data[name] . "<br>";
print_r($data);
print_r($node->getAttribute());
}
// 4. 依路徑取單一商品
$obj = $dom->findNodeByPath("cat_food|goods_food11");
if (!is_object($obj)) {
echo "該商品不存在";
} else {
$data = $obj->getValue();
echo "商品名:" . $data[name] . "<br>";
print_r($data);
print_r($obj->getAttribute());
}
// 5. 為商品加上帶屬性的子節點
$obj = $dom->findNodeByPath("cat_food|goods_food11");
$obj->setValue("leaveWord", array(
"value" => "這個商品不錯",
"attrs" => array("author" => "hahawen", "date" => date("Y-m-d"))
));
echo htmlspecialchars($dom->getSaveXML());
// 6. 修改與刪除節點
$obj = $dom->findNodeByPath("cat_food|goods_food12");
$obj->setValue("name", "new food12");
$obj->removeValue("desc");
echo htmlspecialchars($dom->getSaveXML());
// 7. 新增商品
$obj = $dom->findNodeByPath("cat_food");
$newObj = $obj->createNode("goods", array("id" => "food13"));
$newObj->setValue("name", "food13");
$newObj->setValue("price", 100);
echo htmlspecialchars($dom->getSaveXML());
// 8. 刪除商品
$obj = $dom->findNodeByPath("cat_food");
$obj->removeNode("goods_food12");
echo htmlspecialchars($dom->getSaveXML());
?>
getNode() 回傳節點物件後,再呼叫它自己的 getNode() 就能拿到子節點清單,一層層往下走,比 DOM 的 childNodes 直覺一些。
setValue() 的第二個參數可以是純值,也可以是含 value 與 attrs 的陣列——這是新增「帶屬性的子節點」的統一寫法。
findNodeByPath() 找不到時回傳非物件,因此判斷 is_object() 就能確認存在與否,不必改用例外處理。
由於是剛寫完,文件尚未整理,範例只涵蓋部分功能;想知道更多可以直接研究原始碼。執行範例時,結果頁面上也會附上各函式的使用說明。