萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP DOM 操作 XML 完整教程:從基礎概念到增刪改查實戰

DOM 核心概念

DOM (Document Object Model) 將 XML 文檔解析為樹狀結構:每個元素、屬性、文本都是節點。PHP DOMDocument 類提供標準 API 操作此樹。

示例 XML 文件 (class.xml)

<?xml version="1.0" encoding="utf-8"?>
<class>
  <student info="美女">
    <name>小喬</name>
    <sex>女</sex>
    <age>20</age>
  </student>
  <student>
    <name>周瑜</name>
    <sex>男</sex>
    <age>25</age>
  </student>
</class>

核心類與方法速查

類/方法用途
new DOMDocument()創建文檔對象
$doc->load($file)從文件加載 XML
$doc->loadXML($string)從字符串加載
$doc->getElementsByTagName($name)獲取所有同名元素 (返回 DOMNodeList)
$nodeList->item($index)獲取指定索引節點 (返回 DOMElement)
$element->nodeValue獲取/設置元素文本內容
$element->getAttribute($name)獲取屬性值
$element->setAttribute($name, $value)設置屬性
$doc->createElement($name)創建新元素節點
$parent->appendChild($child)添加子節點
$parent->removeChild($child)移除子節點
$doc->save($file)保存到文件
$doc->saveXML()輸出 XML 字符串

操作一:查詢 (讀取)

<?php
$doc = new DOMDocument();
$doc->load('class.xml');

// 方式 1:層層查找
$students = $doc->getElementsByTagName('student');
$stu1 = $students->item(0);  // 第一個 student
$nameNode = $stu1->getElementsByTagName('name')->item(0);
echo $nameNode->nodeValue;  // 輸出: 小喬

// 方式 2:直接獲取所有 name (跨層級)
$names = $doc->getElementsByTagName('name');
echo $names->item(0)->nodeValue;  // 小喬
echo $names->item(1)->nodeValue;  // 周瑜

// 獲取屬性
$info = $stu1->getAttribute('info');  // 美女
?>

操作二:新增 (創建節點並掛載)

<?php
$doc = new DOMDocument();
$doc->load('class.xml');
$doc->formatOutput = true;  // 格式化輸出縮進

// 1. 獲取根節點
$root = $doc->getElementsByTagName('class')->item(0);

// 2. 創建 student 節點及屬性
$stu = $doc->createElement('student');
$stu->setAttribute('id', '大美女');

// 3. 創建子節點並設置文本
$name = $doc->createElement('name', '大喬');  // 直接在構造函數傳文本
$sex = $doc->createElement('sex', '女');
$age = $doc->createElement('age', '25');

// 4. 組裝樹結構
$stu->appendChild($name);
$stu->appendChild($sex);
$stu->appendChild($age);

// 5. 掛載到根節點
$root->appendChild($stu);

// 6. 保存
$doc->save('class.xml');  // 覆蓋原文件
// 或輸出字符串
// echo $doc->saveXML();
?>

操作三:修改 (更新內容/屬性)

<?php
$doc = new DOMDocument();
$doc->load('class.xml');

// 找到第二個 student 的 age
$ageNode = $doc->getElementsByTagName('age')->item(1);
$ageNode->nodeValue = '26';  // 直接修改文本

// 修改屬性
$stu = $doc->getElementsByTagName('student')->item(1);
$stu->setAttribute('info', '帥哥');

$doc->save('class.xml');

操作四:刪除

<?php
$doc = new DOMDocument();
$doc->load('class.xml');

// 刪除第三個 student (整個節點)
$students = $doc->getElementsByTagName('student');
$toDelete = $students->item(2);
$toDelete->parentNode->removeChild($toDelete);  // 必須通過父節點刪除

// 或刪除某 student 下的 age
$ages = $doc->getElementsByTagName('age');
$ageToDel = $ages->item(0);
$ageToDel->parentNode->removeChild($ageToDel);

$doc->save('class.xml');

進階:XPath 查詢 (強烈推薦複雜查詢)

<?php
$doc = new DOMDocument();
$doc->load('class.xml');
$xpath = new DOMXPath($doc);

// 查找 info="美女" 的 student 下的 name
$nodes = $xpath->query('//student[@info="美女"]/name');
foreach ($nodes as $node) {
    echo $node->nodeValue;  // 小喬
}

// 查找 age > 22 的 student
$nodes = $xpath->query('//student[age > 22]');
foreach ($nodes as $stu) {
    echo $stu->getElementsByTagName('name')->item(0)->nodeValue;  // 周瑜
}

編碼處理注意事項

  • XML 聲明 encoding="utf-8" 必須與文件實際編碼一致
  • PHP 源文件需保存為 UTF-8 無 BOM
  • load() 會自動處理編碼轉換,save() 保持原編碼
  • 若輸出中文亂碼,檢查 header('Content-Type: text/xml; charset=utf-8')

性能提示

  • 大文件 (>10MB) 考慮 XMLReader (流式拉取解析) 或 SimpleXML
  • 頻繁讀寫同一文件,加文件鎖 flock() 防止併發損壞
  • 生產環境建議緩存解析結果或遷移至數據庫

總結

PHP DOM 提供標準、完整的 XML 操作 API。核心模式:加載 → 查找節點 (getElementsByTagName/XPath) → 讀取/修改/創建/刪除 → 保存。掌握 DOMNodeList、DOMElement、DOMXPath 三大類協作,即可應對絕大多數 XML 處理場景。

copyright © 萬盛學電腦網 all rights reserved