PHP Conference Japan 2024

    DOMDocument::xinclude

    (PHP 5, PHP 7, PHP 8)

    DOMDocument::xinclude — 在DOMDocument对象中替换XInclude

    描述

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

    此方法替换DOMDocument对象中的» XInclude。

    注意:

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

    参数

    options

    按位OR libxml选项常量。

    返回值

    返回文档中XInclude的数量，如果某些处理失败则返回-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);

    // 替换xinclude
    $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 条注释

    8
    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