« SimpleXMLElement::nextSimpleXMLElement::rewind »PHP ManualSimpleXMLElement

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

Loading...

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

Chapter 1
Chapter 2

Зверніть увагу на те, як у прикладі XML-документу встановлюється простір імен з префіксом chap. Уявіть, що цей документ (або інший схожий) використав префікс c у минулому для того самого простору імен. Так як він змінився, запит XPath більше не поверне правильних результатів і запит доведеться змінювати. Використання registerXPathNamespace дозволяє уникнути майбутніх модифікацій запитів, навіть якщо постачальник змінить префікс простору імен.

Дивіться також