PHP - SAX 解析器示例：初学者指南

你好，未来的 PHP 大师们！今天，我们将踏上一段激动人心的旅程，进入 PHP 中的 SAX 解析世界。如果你之前从未听说过 SAX，不用担心 - 在本教程结束时，你将能够像专业人士一样解析 XML！

PHP - SAX Parser Example

什么是 SAX 解析？

在我们深入研究代码之前，让我们先了解一下什么是 SAX 解析。SAX 代表“XML 的简单 API”。它是一种读取 XML 文档的方式，特别适用于处理大型文件或当你想要在读取时处理 XML，而不是将整个文档加载到内存中。

想象你正在阅读一本书。SAX 解析就像逐页阅读书籍，理解你正在阅读的每一页，而不是试图一次性记住整本书。酷吧？

在 PHP 中开始使用 SAX

PHP 通过内置的 XML 解析器使 SAX 解析变得轻而易举。让我们从一个简单的例子开始：

<?php
$parser = xml_parser_create();
xml_parse($parser, "<book><title>PHP 初学者指南</title></book>");
xml_parser_free($parser);
?>

在这段代码中，我们创建了一个解析器，解析了一个简单的 XML 字符串，然后释放了解析器。但这还做不了什么。要让我们的解析器变得有用，我们需要告诉它在遇到 XML 的不同部分时应该做什么。这就是我们的处理函数的作用！

XML 元素处理函数

xml_set_element_handler() 函数允许我们指定当解析器遇到元素的开始和结束时会发生什么。让我们看看它是如何工作的：

<?php
function start_element($parser, $element_name, $element_attrs) {
echo "开始元素：$element_name<br>";
}

function end_element($parser, $element_name) {
echo "结束元素：$element_name<br>";
}

$parser = xml_parser_create();
xml_set_element_handler($parser, "start_element", "end_element");

$xml = "<book><title>PHP 初学者指南</title><author>John Doe</author></book>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

这个脚本将输出：

开始元素：BOOK
开始元素：TITLE
结束元素：TITLE
开始元素：AUTHOR
结束元素：AUTHOR
结束元素：BOOK

如你所见，每当遇到一个开标签时，我们的 start_element 函数就会被调用，而 end_element 则在遇到闭标签时被调用。

字符数据处理函数

那么标签之间的文本呢？这就是 xml_set_character_data_handler() 的用武之地：

<?php
function char_data($parser, $data) {
echo "字符数据：" . trim($data) . "<br>";
}

$parser = xml_parser_create();
xml_set_character_data_handler($parser, "char_data");

$xml = "<book><title>PHP 初学者指南</title><author>John Doe</author></book>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

这将输出：

字符数据：PHP 初学者指南
字符数据：John Doe

处理指令处理函数

有时，XML 文档包含处理指令。这些是处理 XML 的应用程序的特殊指令。我们可以使用 xml_set_processing_instruction_handler() 来处理这些：

<?php
function pi_handler($parser, $target, $data) {
echo "处理指令 - 目标：$target，数据：$data<br>";
}

$parser = xml_parser_create();
xml_set_processing_instruction_handler($parser, "pi_handler");

$xml = "<?xml version='1.0'?><?php echo 'Hello, World!'; ?><root>一些内容</root>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

这将输出：

处理指令 - 目标：php，数据：echo 'Hello, World!'

默认处理函数

最后，xml_set_default_handler() 允许我们处理其他处理函数未捕获的任何 XML 数据：

<?php
function default_handler($parser, $data) {
echo "默认处理函数：" . htmlspecialchars($data) . "<br>";
}

$parser = xml_parser_create();
xml_set_default_handler($parser, "default_handler");

$xml = "<?xml version='1.0'?><root>一些内容</root>";
xml_parse($parser, $xml);
xml_parser_free($parser);
?>

这将输出：

默认处理函数：<?xml version='1.0'?>
默认处理函数：<root>一些内容</root>

把所有内容放在一起

现在我们已经看到了每个处理函数的使用，让我们将它们组合成一个更完整的例子：

<?php
function start_element($parser, $element_name, $element_attrs) {
echo "开始元素：$element_name<br>";
if (!empty($element_attrs)) {
echo "属性：";
print_r($element_attrs);
echo "<br>";
}
}

function end_element($parser, $element_name) {
echo "结束元素：$element_name<br>";
}

function char_data($parser, $data) {
if (trim($data) !== '') {
echo "字符数据：" . trim($data) . "<br>";
}
}

function pi_handler($parser, $target, $data) {
echo "处理指令 - 目标：$target，数据：$data<br>";
}

function default_handler($parser, $data) {
$data = trim($data);
if (!empty($data)) {
echo "默认处理函数：" . htmlspecialchars($data) . "<br>";
}
}

$parser = xml_parser_create();

xml_set_element_handler($parser, "start_element", "end_element");
xml_set_character_data_handler($parser, "char_data");
xml_set_processing_instruction_handler($parser, "pi_handler");
xml_set_default_handler($parser, "default_handler");

$xml = <<<XML
<?xml version='1.0'?>
<?php echo 'Hello, World!'; ?>
<library>
<book id="1">
<title>PHP 初学者指南</title>
<author>John Doe</author>
</book>
<book id="2">
<title>高级 PHP 技巧</title>
<author>Jane Smith</author>
</book>
</library>
XML;

xml_parse($parser, $xml);
xml_parser_free($parser);
?>

这个全面的例子展示了我们讨论过的所有处理函数。试着运行它并看看你会得到什么输出！

结论

恭喜你！你已经迈出了使用 PHP 进行 SAX 解析的第一步。记住，熟能生巧，所以不要害怕尝试不同的 XML 结构并观察你的解析器如何处理它们。

SAX 解析是你在 PHP 工具箱中的一个强大工具，尤其是在处理大型 XML 文档时。它允许你高效且即时地处理 XML，在某些情况下这可以节省很多时间。

继续编码，继续学习，最重要的是，享受乐趣！在你意识到之前，你将能够像经验丰富的专业人士一样解析 XML。下次见，快乐编码！ | 处理函数 | 用途 | |-----------|------| | xml_set_element_handler() | 处理 XML 元素的开始和结束 | | xml_set_character_data_handler() | 处理 XML 标签之间的文本数据 | | xml_set_processing_instruction_handler() | 处理 XML 处理指令 | | xml_set_default_handler() | 处理其他处理函数未捕获的任何 XML 数据 |

Credits: Image by storyset