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 позволяет избежать будущих модификаций запросов, даже если поставщик изменит префикс пространства имён.

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

SimpleXMLElement::xpath() - Запускает запрос XPath к XML-данным
SimpleXMLElement::getDocNamespaces() - Возвращает пространства имён, объявленные в документе
SimpleXMLElement::getNamespaces() - Возвращает пространства имён, используемые в документе

Нашли ошибку?

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

＋Добавить

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

down

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');

?>

＋Добавить