DIV CSS 佈局教程網

用 DOM 複製指定節點資料到新的 XML 檔
編輯:關於JavaScript     

(本文實作語言為 PHP 的 DOM 擴充,標題中的「js」應是原作者筆誤。JavaScript 在瀏覽器端無法寫入本機檔案,若要在 Node.js 環境做類似的事,概念可以對照參考。)

需求是:從一份 XML 中挑出指定名稱的節點,複製到一份全新的 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 類別的知識點:

  1. DOMDocument::getElementsByTagName(string $name) → 回傳 DOMNodeList
  2. DOMNodeList::item(int $index) → 取得 DOMNode
  3. DOMNode::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 簡短,也不會有索引錯位或命名空間遺失的問題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved