PHP DOM操作核心是围绕DOMDocument构建加载→查询→修改→输出流程，需理解节点树结构与操作边界，而非死记API。
PHP 的 DOM 操作不是“学 API 列表”，而是围绕 DOMDocument 构建一套可落地的 HTML/XML 处理流程：加载 → 查询 → 修改 → 输出。掌握它不靠背函数，而在于理解节点树结构和操作边界。
先搞清 DOMDocument 加载 HTML 时的真实行为
很多人一上来就用 loadHTML() 却发现结果多出 <html><body> 标签，或中文乱码、属性丢失——这不是 bug，是默认行为。
-
loadHTML()会自动补全不完整 HTML（比如只传<div>test</div>，它会包上<html><body>...</body></html>），若你只想处理片段，后续得手动剥离$dom->documentElement->firstChild->nextSibling等路径，很易错 - 必须在
loadHTML()前调用libxml_use_internal_errors(true)，否则 malformed HTML（如未闭合标签、属性无引号）会直接报 Warning 并中断脚本 - 编码问题常源于没设
mb_internal_encoding('UTF-8')或没在 HTML 字符串开头注入<meta charset="utf-8">；loadHTML()默认按 ISO-8859-1 解析，中文字段直接变乱码
querySelector 类语法？PHP 里没有，得靠 DOMXPath 或 getElementsByTagName
前端开发者容易误以为 PHP 有 querySelector()，实际上 DOM 扩展不支持 CSS 选择器。你要找 <input name="email">，不能写 $dom->querySelector('input[name="email"]') —— 这会报 Fatal error。
- 最常用且可靠的方案是组合
DOMXPath：$xpath = new DOMXPath($dom);<br>$node = $xpath->query('//input[@name="email"]')->item(0);注意query()返回DOMNodeList，必须用->item(0)取单个节点，否则后续调用getAttribute()会失败 - 简单场景可用
$dom->getElementsByTagName('div')，但它只认标签名，无法带属性过滤；getElementsByClassName()在 PHP DOM 中根本不存在（那是浏览器 JS 的 API） - XPath 表达式里属性值含变量时，务必用
sprintf()拼接并转义单/双引号，避免 XPath 注入，例如：sprintf('//a[@href="%s"]', addslashes($url))
修改节点内容时，nodeValue 和 textContent 的区别很关键
想把 <p>Hello</p> 改成 <p>Hi</p>，用 $p->nodeValue = 'Hi' 是对的；但若原节点含子元素（如 <p>Hello <strong>world</strong></p>），再设 nodeValue 会**清空全部子节点**，只剩纯文本。
立即学习“PHP免费学习笔记（深入）”；
- 安全替换文本内容：优先用
$p->textContent = 'Hi'，它保留结构只改文字；但注意textContent是只读属性（PHP 8.0+ 才可写），低版本只能删子节点再appendChild($dom->createTextNode()) - 插入新 HTML 字符串（如
<span class="mark">new</span>）不能直接赋值，得用$fragment = $dom->createDocumentFragment(); $fragment->appendXML($html); $p->appendChild($fragment); - 删除节点前，必须确保它有父节点：
if ($node->parentNode) { $node->parentNode->removeChild($node); }，否则removeChild()报错
输出时别漏掉 saveHTML() 的参数控制
直接 echo $dom->saveHTML() 会输出整个补全后的文档（含 <html>），但你往往只要其中一段，比如只导出 <table> 内容。
-
saveHTML()接受一个DOMNode参数：$dom->saveHTML($tableNode)，就能只输出该节点及其子树，不带多余包装 - 若需去除自动添加的
<html><body>，可在加载后定位到真实内容节点：$body = $dom->getElementsByTagName('body')->item(0); echo $dom->saveHTML($body); - 输出前建议调用
$dom->normalizeDocument()，它会合并相邻文本节点、清理空格，避免生成冗余空白字符
DOM 操作真正的复杂点不在语法，而在节点所有权和生命周期：一个节点从 A 文档移到 B 文档后，就不再属于 A；appendChild() 会自动从原父节点 detach；cloneNode(true) 才能深拷贝带子树的节点——这些隐式行为不踩几次坑很难记住。
