(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DOMXPath::registerPhpFunctions — Регистрация PHP-функций как функций XPath
Этот метод позволяет использовать PHP-функции в выражениях XPath.
restrictИспользуйте этот параметр, чтобы разрешить использование только определённых функций в выражениях XPath.
Параметр может быть одним из следующих типов: строка (string) (имя функции), индексированный массив (array) имён функций или ассоциативный массив (array), ключами которого являются имена функций, а значениями – замыкание (callable).
Функция не возвращает значения после выполнения.
| Версия | Описание |
|---|---|
| 8.4.0 |
Теперь можно использовать замыкание (callable)
для callback-функций при использовании параметра restrict
с записями в виде массива (array).
|
В следующих примерах используется файл book.xml, который содержит следующее:
Пример #1 book.xml
<?xml version="1.0" encoding="UTF-8"?> <books> <book> <title>PHP Basics</title> <author>Jim Smith</author> <author>Jane Smith</author> </book> <book> <title>PHP Secrets</title> <author>Jenny Smythe</author> </book> <book> <title>XML basics</title> <author>Joe Black</author> </book> </books>
Пример #2 DOMXPath::registerPHPFunctions() с php:functionString
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
// Регистрация PHP: пространство имён (обязательно)
$xpath->registerNamespace("php", "http://php.net/xpath");
// Регистрация функций PHP (без ограничений)
$xpath->registerPHPFunctions();
// Вызов функции substr для названия книги
$nodes = $xpath->query('//book[php:functionString("substr", title, 0, 3) = "PHP"]');
echo "Найдены {$nodes->length} книги, начинающиеся с 'PHP':\n";
foreach ($nodes as $node) {
$title = $node->getElementsByTagName("title")->item(0)->nodeValue;
$author = $node->getElementsByTagName("author")->item(0)->nodeValue;
echo "$title автора $author\n";
}
?>Вывод приведённого примера будет похож на:
Найдены 2 книги, начинающиеся с 'PHP': PHP Basics автора Jim Smith PHP Secrets автора Jenny Smythe
Пример #3 DOMXPath::registerPHPFunctions() с php:function
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
// Регистрация PHP: пространство имён (обязательно)
$xpath->registerNamespace("php", "http://php.net/xpath");
// Регистрация PHP-функций (только has_multiple)
$xpath->registerPHPFunctions("has_multiple");
function has_multiple($nodes) {
// Возвращает true, если более одного автора
return count($nodes) > 1;
}
// Фильтрация книг с двумя и более авторами
$books = $xpath->query('//book[php:function("has_multiple", author)]');
echo "Книги с двумя и более авторами:\n";
foreach ($books as $book) {
echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
}
?>Вывод приведённого примера будет похож на:
Книги с двумя и более авторами: PHP Basics
Пример #4 Пример использования метода DOMXPath::registerPHPFunctions() с замыканием (callable)
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
// Регистрация PHP: пространство имён (обязательно)
$xpath->registerNamespace("php", "http://php.net/xpath");
// Регистрация PHP-функций (только has_multiple)
$xpath->registerPHPFunctions(["has_multiple" => fn ($nodes) => count($nodes) > 1]);
// Фильтрация книг с двумя и более авторами
$books = $xpath->query('//book[php:function("has_multiple", author)]');
echo "Книги с двумя и более авторами:\n";
foreach ($books as $book) {
echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
}
?>Вывод приведённого примера будет похож на:
Книги с двумя и более авторами: PHP Basics