DOMDocument::xinclude

(PHP 5, PHP 7, PHP 8)

DOMDocument::xinclude 在 DOMDocument 对象中替换 XIncludes

描述

public DOMDocument::xinclude(int $options = 0): int|false

此方法在 DOMDocument 对象中替换 » XIncludes

注意:

由于 libxml2 自动解析实体,如果包含的 XML 文件附加了 DTD,此方法将产生意外的结果。

参数

options

按位 ORlibxml 选项常量

返回值

返回文档中的 XIncludes 数量,如果某些处理失败则返回 -1,或者如果没有任何替换则返回 false

示例

示例 #1 DOMDocument::xinclude() 示例

<?php

$xml
= <<<EOD
<?xml version="1.0" ?>
<chapter xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Books of the other guy..</title>
<para>
<xi:include href="book.xml">
<xi:fallback>
<error>xinclude: book.xml not found</error>
</xi:fallback>
</xi:include>
</para>
</chapter>
EOD;

$dom = new DOMDocument;

// 让我们有一个不错的输出
$dom->preserveWhiteSpace = false;
$dom->formatOutput = true;

// 加载上面定义的 XML 字符串
$dom->loadXML($xml);

// 替换 xincludes
$dom->xinclude();

echo
$dom->saveXML();

?>

上面的示例将输出类似于以下内容

<?xml version="1.0"?>
<chapter xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Books of the other guy..</title>
  <para>
    <row xml:base="/home/didou/book.xml">
       <entry>The Grapes of Wrath</entry>
       <entry>John Steinbeck</entry>
       <entry>en</entry>
       <entry>0140186409</entry>
      </row>
    <row xml:base="/home/didou/book.xml">
       <entry>The Pearl</entry>
       <entry>John Steinbeck</entry>
       <entry>en</entry>
       <entry>014017737X</entry>
      </row>
    <row xml:base="/home/didou/book.xml">
       <entry>Samarcande</entry>
       <entry>Amine Maalouf</entry>
       <entry>fr</entry>
       <entry>2253051209</entry>
      </row>
  </para>
</chapter>

添加备注

用户贡献的备注 1 条备注

nicolas_rainardNOSPAM at yahoo dot fr
17 年前
如果您使用 loadXML() 方法而不是 load() 方法(例如,在加载和解析之前处理 XML 字符串),您将遇到 xinclude() 问题,因为解析器将不知道在哪里找到要包含的文件。
在 xinclude() 之前使用 chdir() 不会有帮助。

解决方法是根据 DOMDocument 对象的原始文件名设置 documentURI 属性,这样一切都会正常工作!

<?php

$xml
= file_get_contents($file);
$xml = do_something_with($xml);

$doc = new DOMDocument;
$doc->documentURI = $file;
$doc->loadXML($xml);
$doc->xinclude();

?>
To Top