Edit Report a Bug

    DOMXPath::registerPhpFunctions

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

    DOMXPath::registerPhpFunctions — Регистрация PHP-функций как функций XPath

    Описание

    public DOMXPath::registerPhpFunctions(string|array|null $restrict = null): void

    Этот метод позволяет использовать PHP-функции в выражениях XPath.

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

    restrict

    Используйте этот параметр, чтобы разрешить использование только определённых функций в выражениях XPath.

    Этот параметр может иметь тип string (имя функции) или 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

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

    • DOMXPath::registerNamespace() - Регистрирует пространство имён с объектом DOMXPath
    • DOMXPath::query() - Выполняет заданное выражение XPath
    • DOMXPath::evaluate() - Вычисляет переданное выражение XPath и возвращает типизированный результат, если возможно

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top