SimpleXMLElement::registerXPathNamespace

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    SimpleXMLElement::registerXPathNamespace — Создаёт префикс/пространство имён контекста для следующего запроса XPath

    Описание

    public SimpleXMLElement::registerXPathNamespace(string $prefix, string $namespace): bool

    Создаёт префикс/пространство имён контекста для следующего запроса XPath. В частности это необходимо, если поставщик данного XML-документа изменяет префикс пространства имён. registerXPathNamespace создаст префикс для связанного пространства имён, позволяя получить доступ к узлам в этом пространстве имён без необходимости изменения кода, учитывающего новые префиксы, предоставленные поставщиком.

    Список параметров

    prefix

    Префикс используемого пространства имён в запросе XPath для получения пространства имён в namespace.

    namespace

    Используемое пространство имён для запроса XPath. Оно должно соответствовать пространству имён в используемом XML-документе или запрос XPath, использующий prefix не даст никаких результатов.

    Возвращаемые значения

    Функция возвращает true в случае успешного выполнения или false, если возникла ошибка.

    Примеры

    Пример #1 Установка префикса пространства имён для использования в запросе XPath

    <?php

    $xml     = <<<EOD
    <book xmlns:chap="http://example.org/chapter-title">
    <title>My Book</title>
    <chapter id="1">
    <chap:title>Chapter 1</chap:title>
    <para>Donec velit. Nullam eget tellus vitae tortor gravida scelerisque.
    In orci lorem, cursus imperdiet, ultricies non, hendrerit et, orci.
    Nulla facilisi. Nullam velit nisl, laoreet id, condimentum ut,
    ultricies id, mauris.</para>
    </chapter>
    <chapter id="2">
    <chap:title>Chapter 2</chap:title>
    <para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin
    gravida. Phasellus tincidunt massa vel urna. Proin adipiscing quam
    vitae odio. Sed dictum. Ut tincidunt lorem ac lorem. Duis eros
    tellus, pharetra id, faucibus eu, dapibus dictum, odio.</para>
    </chapter>
    </book>
    EOD;

    $sxe = new SimpleXMLElement($xml);

    $sxe->registerXPathNamespace('c', 'http://example.org/chapter-title');
    $result = $sxe->xpath('//c:title');

    foreach (    $result as $title) {
    echo     $title . "\n";
    }

    ?>

    Результат выполнения приведённого примера: 

    Chapter 1
Chapter 2

    Обратите внимание, на то, как в примере XML-документу устанавливается пространство имён с префиксом chap. Представьте, что этот документ (или другой похожий) использовал префикс c в прошлом для одного и того же пространства имён. Так как он изменился, запрос XPath больше не вернёт правильных результатов, и запрос придётся изменять. Использование registerXPathNamespace позволяет избежать будущих модификаций запросов, даже если поставщик изменит префикс пространства имён.

    Смотрите также

    Улучшение страницы

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 1 note

    up
    5
    Lea Hayes
    13 years ago
    Looks like you have to use registerXPathNamespace for each node when using XPath:

    <?php
    $xml     = simplexml_load_file($filename);

    $xml->registerXPathNamespace('test', 'http://example.com');

    $shopping_element = $xml->xpath('test:shopping-list');

    // Breaks with out the following line:

    $shopping_element->registerXPathNamespace('test', 'http://example.com');

    $fruit = $shopping_element->xpath('test:fruit');
    ?>
    ＋Добавить
    To Top