這篇筆記源於一個真實的專案需求:由於我們的專案資料量太少,得向隔壁的 web search 團隊借調資料,而對方只提供了一個 XML 介面。因此我們得把 XML 資料轉成 HTML 呈現給使用者。因為專案本身以 PHP 打造,我便放棄了用 JS 讀取 XML 的路子,繼續沿用 PHP。以前沒做過這類嘗試,於是翻了不少網路資料,也對照了 PHP 官方手冊,最後發現:在 PHP 4 環境下,用 parser 函數是比較好的選擇(當然也能用 DOM,但那需要重新設定伺服器;PHP 5 對 DOM 的支援才比較完善)。
雖然是頭一回接觸,問題很快就解決了。不過在摸索的過程中我發現,網路上這類資料雖多卻良莠不齊,很多描述不夠細緻,還是以官方操作手冊最靠得住。
parser 是 PHP 內建、專門用來處理 XML 的解析器,它的運作由三個事件組成:起始標籤、讀取資料、結束標籤。也就是說,處理 XML 時每遇到起始標籤、資料與結束標籤,函數就會做出相應動作,逐步完成 XML 資料的轉換。
PHP 針對 XML 解析提供了下列事件處理函數:
xml_set_element_handler(),處理元素的開始與結束xml_set_character_data_handler(),處理字元資料xml_set_external_entity_ref_handler()xml_set_unparsed_entity_decl_handler()xml_set_processing_instruction_handler()xml_set_notation_decl_handler()xml_set_default_handler(),處理其餘未指定的事件下面用 parser 函數讀取一份 XML 資料,示範如何把 <name> 與 <position> 兩個欄位取出來顯示:
<?php
$parser = xml_parser_create(); // 建立一個 parser
xml_set_element_handler($parser, "startElement", "endElement"); // 設定標籤觸發的函數
xml_set_character_data_handler($parser, "characterData"); // 設定資料讀取的函數
$xml_file = "1.xml"; // 指定要讀取的 XML 檔,也可以是網址
$filehandler = fopen($xml_file, "r"); // 開啟檔案
while ($data = fread($filehandler, 4096)) {
xml_parse($parser, $data, feof($filehandler)); // 每次取出 4096 位元組處理
}
fclose($filehandler);
xml_parser_free($parser); // 關閉並釋放 parser
$name = false;
$position = false;
function startElement($parser_instance, $element_name, $attrs){ // 起始標籤事件
global $name, $position;
if($element_name == "NAME"){
$name = true; $position = false; echo "名字:";
}
if($element_name == "POSITION"){
$name = false; $position = true; echo "職位:";
}
}
function characterData($parser_instance, $xml_data){ // 讀取資料事件
global $name, $position;
if($position) echo $xml_data."<br>";
if($name) echo $xml_data."<br>";
}
function endElement($parser_instance, $element_name){ // 結束標籤事件
global $name, $position;
$name = false; $position = false;
}
?>
<?xml version="1.0"?>
<employees>
<employee>
<name>張三</name>
<position age="45">經理</position>
</employee>
<employee>
<name>李四</name>
<position age="45">助理</position>
</employee>
</employees>
名字:張三 職位:經理 名字:李四 職位:助理
可以看到,parser 透過旗標變數(flag)標記「目前正讀到哪個欄位」,就能在遇到資料時精準地把值放進對應位置。這種事件導向的寫法,是 PHP 4 時代處理 XML 相當實用的方案。