Класс DOMXPath

(PHP 5, PHP 7, PHP 8)

Введение

Позволяет использовать запросы XPath 1.0 в HTML- или XML-документах.

Обзор класса

class DOMXPath {
/* Свойства */
public readonly DOMDocument $document;
/* Методы */
public __construct(DOMDocument $document, bool $registerNodeNS = true)
public evaluate(string $expression, ?DOMNode $contextNode = null, bool $registerNodeNS = true): mixed
public query(string $expression, ?DOMNode $contextNode = null, bool $registerNodeNS = true): mixed
public static quote(string $str): string
public registerNamespace(string $prefix, string $namespace): bool
}

Свойства

document
Документ, связанный с объектом.
registerNodeNamespaces
Если установлено значение true, пространства имён регистрируются в узле.

Список изменений

Версия Описание
8.4.0 Теперь невозможно клонировать объект DOMXPath. Это приведёт к выбрасыванию исключения. До версии PHP 8.4.0 это приводило к появлению непригодного для использования объекта.
8.0.0 Добавлено свойство registerNodeNamespaces.

Содержание

  • DOMXPath::__construct — Создаёт новый объект класса DOMXPath
  • DOMXPath::evaluate — Вычисляет переданное выражение XPath и возвращает типизированный результат, если возможно
  • DOMXPath::query — Оценивает XPath-выражение
  • DOMXPath::quote — Берёт в кавычки строку для XPath-выражения
  • DOMXPath::registerNamespace — Регистрирует пространство имён с объектом DOMXPath
  • DOMXPath::registerPhpFunctions — Регистрация PHP-функций как функций XPath