告别繁琐的DOM操作：如何使用s9e/sweetdom优雅地处理XML和XSLT模板

可以通过一下地址学习composer：学习地址

最近在开发一个需要频繁操作xml文档，尤其是xslt模板的项目时，我遇到了一个让人头疼的问题。php原生的dom扩展虽然功能强大，但其api设计往往显得过于底层和繁琐。例如，创建一个新元素、将其插入到指定位置，或者执行一个xpath查询，都需要好几行代码，而且语法不够直观。

想象一下，当你需要动态地修改XSLT模板，比如在某个

xsl:template

xsl:if

xsl:value-of

1. 创建一个

   DOMDocument

   对象。
2. 使用

   createElementNS

   带着命名空间创建XSLT元素。
3. 设置元素的属性。
4. 找到目标父节点。
5. 使用

   appendChild

   或

   insertBefore

   将新元素插入。
6. 最后，再保存修改后的XML。

这个过程不仅代码量大，而且容易出错，尤其是在处理复杂的嵌套结构时，简直是噩梦。我常常感到，虽然PHP能够处理XML，但这种处理方式远非“优雅”。

幸运的是，我发现了

s9e/sweetdom

拥抱

s9e/sweetdom

：DOM操作的语法糖

s9e/sweetdom

DOMDocument

DOMElement

安装

s9e/sweetdom

composer require s9e/sweetdom

安装完成后，你就可以在项目中使用它了。

核心特性与实战应用

1. 简化XPath查询

s9e/sweetdom\Document

DOMDocument

evaluate

query

firstOf

DOMXPath

firstOf

null

use s9e\SweetDOM\Document;

$dom = new Document;
$dom->loadXML('');

// 直接在Document对象上执行XPath查询
var_dump($dom->firstOf('//x')->getAttribute('id'));
// 输出: string(1) "1"

// 甚至可以在Element对象上执行，以该元素作为上下文节点
var_dump($dom->firstOf('//x')->firstOf('x')->getAttribute('id'));
// 输出: string(1) "2"

这让XPath查询变得异常简洁和高效。

2. 专注于XSLT元素的创建

s9e/sweetdom\Document

$nodeCreator

createXslApplyTemplates

createXslIf

createXslValueOf

use s9e\SweetDOM\Document;

$dom = new Document;
// 创建一个 
$variable = $dom->nodeCreator->createXslVariable('myVar', "'hello'");

// 创建一个 
$ifElement = $dom->nodeCreator->createXslIf('$condition', 'This is true');

3. “魔法”方法：相对插入节点

这是

s9e/sweetdom

s9e/SweetDOM\Element

afterXslText

appendElement

beforeXslText

prependElement

让我们看一个修改XSLT模板的例子：

use s9e\SweetDOM\Document;

$xsl = '
    


							

								
								

									白果AI论文
									
论文AI生成学术工具，真实文献，免费不限次生成论文大纲 10 秒生成逻辑框架，10 分钟产出初稿，智能适配 80+学科。支持嵌入图表公式与合规文献引用
								
								下载 
							
						
';

$dom = new Document;
$dom->formatOutput       = true; // 格式化输出
$dom->preserveWhiteSpace = false; // 不保留空白节点
$dom->loadXML($xsl);

$span = $dom->firstOf('//span');

// 在元素之后插入一个
$span->afterXslText('afterXslText');
// 在元素内部末尾插入一个
$span->appendXslText('appendXslText');
// 在元素之前插入一个
$span->beforeXslText('beforeXslText');
// 在元素内部开头插入一个
$span->prependXslText('prependXslText');

// 找到
元素，并用替换它
$dom->firstOf('//br')->replaceWithXslText('replaceWithXslText');

echo $dom->saveXML($dom->documentElement);

输出结果：

  

    beforeXslText
    
      prependXslText
      replaceWithXslText
      appendXslText
    
    afterXslText
  

这个例子清晰地展示了

s9e/sweetdom

再看一个插入普通HTML元素的例子：

use s9e\SweetDOM\Document;

$dom = new Document;
$dom->formatOutput       = true;
$dom->preserveWhiteSpace = false;
$dom->loadXML('

');

$span = $dom->firstOf('//span');

// 在元素之后插入一个元素
$span->afterElement('i', 'afterElement');
// 在元素内部末尾插入一个元素
$span->appendElement('i', 'appendElement');
// 在元素之前插入一个元素
$span->beforeElement('i', 'beforeElement');
// 在元素内部开头插入一个元素
$span->prependElement('i', 'prependElement');

echo $dom->saveXML($dom->documentElement);

输出结果：

  beforeElement
  
    prependElement
    

    appendElement
  
  afterElement

4. 文档片段（Document Fragments）的应用

appendDocumentFragment

use s9e\SweetDOM\Document;

$dom = new Document;
$dom->loadXML('');

$x = $dom->firstOf('//x');
$x->appendDocumentFragment(
    // 回调函数会在片段被添加到DOM之前执行
    fn($fragment) => $fragment->appendXML('')
);

echo $dom->saveXML($x);

s9e/sweetdom

s9e/sweetdom

s9e/sweetdom

s9e/sweetdom