(本文實作語言為 PHP 的 DOM 擴充,標題中的「js」應是原作者筆誤。JavaScript 在瀏覽器端無法寫入本機檔案,若要在 Node.js 環境做類似的事,概念可以對照參考。)
需求是:從一份 XML 中挑出指定名稱的節點,複製到一份全新的 XML 檔案裡,並可選擇一併複製某個屬性。
<?xml version="1.0" encoding="utf-8"?>
<article>
<item>
<title name="t1"></title>
<content>content1</content>
<pubdate>2009-10-11</pubdate>
</item>
<item>
<title name="t2">title2</title>
<content>content2</content>
<pubdate>2009-11-11</pubdate>
</item>
</article>
這個實作用到三個 DOM 類別的知識點:
DOMDocument::getElementsByTagName(string $name) → 回傳 DOMNodeListDOMNodeList::item(int $index) → 取得 DOMNodeDOMNode::cloneNode(bool $deep) → 複製節點,$deep 為 true 時連子節點一起複製<?php
if (!function_exists('l')) {
function l() {
echo '<br />********************************<br />';
}
}
if (!function_exists('cp_xml')) {
/**
* 複製指定節點元素資訊到新 XML 檔中
* @param $dom : 來源 XML 的 DOM 物件
* @param $newdom : 新 XML 的 DOM 物件
* @param $node : 指定複製的節點元素名
* @param $file : 新生成的 XML 檔名
* @param $attribute : 指定複製的節點屬性名(可選)
* @return void
*/
function cp_xml($dom, $newdom, $node, $file, $attribute = '') {
$contents = $dom->getElementsByTagName($node);
$clone = array();
$attr = array();
// 第一趟:取出所有目標節點並複製
for ($i = 0; $i < $contents->length; $i++) {
$node = $contents->item($i);
if ($node->hasAttributes() && !empty($attribute)) {
$attr[] = $node->getAttribute($attribute);
}
$clone[] = $node->cloneNode(true); // true = 深複製,含子節點
}
// 建立新文件的根節點
$root = $newdom->createElement('root');
$newdom->appendChild($root);
// 第二趟:把複製的節點逐一掛到新文件
for ($i = 0; $i < count($clone); $i++) {
$title = $newdom->createElement($clone[$i]->nodeName, $clone[$i]->nodeValue);
$root->appendChild($title);
if (count($attr) > 0 && !empty($attribute)) {
$aname = $newdom->createAttribute($attribute); // 建立屬性節點
$title->appendChild($aname);
$aval = $newdom->createTextNode($attr[$i]); // 屬性的文字值
$aname->appendChild($aval);
}
}
$newdom->save($file);
}
}
?>
<?php
if (file_exists("test10_12.xml")) {
// 實例一:複製 content 節點
$dom = new DOMDocument();
$newdom = new DOMDocument('1.0', 'utf-8');
$dom->load("test10_12.xml");
cp_xml($dom, $newdom, 'content', '11_1.xml');
// 實例二:複製 title 節點並保留 name 屬性
$dom = new DOMDocument();
$newdom = new DOMDocument('1.0', 'utf-8');
$dom->load("test10_12.xml");
cp_xml($dom, $newdom, 'title', '11_2.xml', $attribute = 'name');
}
?>
用 function_exists 包裹定義是為了避免在包含檔被重複載入時出現「函式重複定義」的致命錯誤。這在把工具函式放進共用 include 檔時是很實際的防護。
跨文件操作必須用 createElement 而非直接搬節點。DOM 的規則是「節點不能同時屬於兩個文件」,所以 cloneNode 之後仍需用新文件的 createElement 重建。PHP 有 DOMDocument::importNode() 可以專門處理這件事,比手動重建更完整(會保留命名空間等資訊)。
屬性處理有個邏輯瑕疵:if ($node->hasAttributes() && !empty($attribute)) 代表「節點沒有屬性時不記錄,但 $attr 陣列的索引會與 $clone 錯位」。第二趟迴圈用 $attr[$i] 取值時就可能取到別人的屬性。正確做法是不管有沒有屬性都 push 一個值(沒有就 push 空字串),維持索引對齊。
変數遮蔽:第一趟迴圈裡把參數 $node 重新賦值成目前的節點,迴圈結束後 $node 已不再是原本的節點名稱字串。目前沒出錯是因為後續沒再用到,但這是容易埋雷的寫法,建議改用 $current 這類獨立變數名。
用 XPath 可以直接篩選並複製,不必自己寫迴圈:
$dom = new DOMDocument();
$dom->load('test10_12.xml');
$xpath = new DOMXPath($dom);
$nodes = $xpath->query('//title'); // 或用 '//item/title' 更精確
$new = new DOMDocument('1.0', 'utf-8');
$root = $new->appendChild($new->createElement('root'));
foreach ($nodes as $n) {
$root->appendChild($new->importNode($n, true)); // 一次搞定節點與屬性
}
$new->save('11_2.xml');
importNode($n, true) 會把節點連同所有屬性與子節點完整搬過來,比手動 createElement + createAttribute 簡短,也不會有索引錯位或命名空間遺失的問題。