PHP - Manual: DOMXPath::evaluate

2024-11-12

DOMXPath::evaluate

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

DOMXPath::evaluate — Evaluates the given XPath expression and returns a typed result if possible

说明

public DOMXPath::evaluate(string $expression, ?DOMNode $contextNode = null, bool $registerNodeNS = true): mixed

Executes the given XPath expression and returns a typed result if possible.

参数

expression: The XPath expression to execute.
contextNode: The optional contextNode can be specified for doing relative XPath queries. By default, the queries are relative to the root element.
registerNodeNS: The optional registerNodeNS can be specified to disable automatic registration of the context node.

返回值

Returns a typed result if possible or a DOMNodeList containing all nodes matching the given XPath expression.

If the expression is malformed or the contextNode is invalid, DOMXPath::evaluate() returns false.

范例

示例 #1 Getting the count of all the english books


<?php

$doc = new DOMDocument;

$doc->load('book.xml');

$xpath = new DOMXPath($doc);

$tbody = $doc->getElementsByTagName('tbody')->item(0);

// our query is relative to the tbody node
$query = 'count(row/entry[. = "en"])';

$entries = $xpath->evaluate($query, $tbody);
echo "There are $entries english books\n";

?>

以上例程会输出：

There are 2 english books

参见

DOMXPath::query() - Evaluates the given XPath expression

add a note

User Contributed Notes 5 notes

down

daniel at danielnorton dot com ¶

10 years ago


Note that this method does not provide any means to distinguish between a successful result that returns FALSE and an error.

For example, this will succeed and return FALSE:

<?php $xpath->evaluate("1 = 0"); ?>

One workaround when you know you are expecting a Boolean is to wrap the result with string(). e.g.

<?php $xpath->evaluate("string(1 = 0)"); ?>

This will return a string "false" on success, or the Boolean FALSE on error.

down

Damien Bezborodov ¶

11 years ago


If your expression returns a node set, you will get a DOMNodeList instead of a typed result. Instead, try modifying your expression from "//node[1]" to "string(//node[1])".

down

yuriucsal at NOSPAM dot yahoo dot com dot br ¶

17 years ago


this class can substitute the method evaluate while it is not validated. Made for Yuri Bastos and Jo�o Gilberto Magalh�es. 


<?php


    class XPtahQuery

    {

        // function returns a DOMNodeList from a relative xPath

        public static function selectNodes($pNode, $xPath) 

        {


            $pos = strpos(self::getFullXpath($pNode),"/",1);

            $xPathQuery = substr(self::getFullXpath($pNode),$pos);//to paste  /#document[1]/

            $xPathQueryFull = $xPathQuery. $xPath;

            $domXPath = new DOMXPath($pNode->ownerDocument);

            $rNodeList = $domXPath->query($xPathQueryFull);


                return $rNodeList;

        }

        // function returns a DOMNode from a xPath from other DOMNode

        public static function selectSingleNode($pNode, $xPath) 

        {


            $pos = strpos(self::getFullXpath($pNode),"/",1);

            $xPathQuery = substr(self::getFullXpath($pNode),$pos);//to paste  /#document[1]/

            $xPathQueryFull = $xPathQuery. $xPath;

            $domXPath = new DOMXPath($pNode->ownerDocument);

            $rNode = $domXPath->query($xPathQueryFull)->item(0);


                return $rNode;

        }

        //utilitaries functions off selectSingleNode

        private function getNodePos($pNode, $nodeName)

        {

            if($pNode == null)

                {

                        return 0;

            }

            else

            {

                $var = 0;

                    if ($pNode->previousSibling != null)

                    {

                    if ($pNode->previousSibling->nodeName == $nodeName)

                    {

                        $var = 1;

                    }

                    }

                    return self::getNodePos($pNode->previousSibling, $nodeName) + $var;

            }

        }

        //utilitaries functions off selectSingleNode

        private function getFullXpath($pNode)

        {

            if($pNode == null)

                {

                        return "";

            }

            else

            {


                return self::getFullXpath($pNode->parentNode) . "/" . $pNode->nodeName . "[" .strval(self::getNodePos($pNode, $pNode->nodeName)+1) . "]";//+1 to get the real xPath index


            }

        }

    }

?>

down

aazaharov81 at gmail dot com ¶

7 years ago


To query DOMNodes by their HTML classes, use such snippet
<?php

// CssClassXPathSelector
function ccxs($class) {
    return '[contains(concat(" ", normalize-space(@class), " "), " ' . $class . ' ")]';
}

// then just
$domitems = $this->xpath("//*[@id='searchResultsRows']//a" . ccxs('listing_row'));
?>

down

danny at webdevelopers dot eu ¶

2 years ago


The only way how to distinguish FALSE returned value from syntax error FALSE is to re-run the XPath expression wrapped in string() function. If must return empty string. If it returns FALSE again then it is an error.

<?php

        $ret=$this->xp->evaluate($eval, $context);

        // Error detection: DOMXPath::evaluate() returns FALSE on error 
        // so does DOMXPath::evaluate("boolean(/nothing)") 
        // @workaround webdevelopers.eu
        if ($ret === false && $this->xp->evaluate("string($eval)", $context) === false) { 
            throw new Exception("Invalid XPath expression ".json_encode($eval), 3491);
        }
?>

add a note

官方地址：https://www.php.net/manual/en/domxpath.evaluate.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL 数据库面试 C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet ADORecordSet对象 adodb手册 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 opcache预加载 Composer的Packagist资源 mysql面试题 [鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式 PHP7添加redis扩展 PHP mkdir()写出来的权限与mode值不符合 Packagist / Composer 中国全量镜像 [原创]诡异的php-fpm超时问题 php中几种注释规范利用php soap实现web service

略微加速

PHP官方手册 - 互联网笔记

DOMXPath::evaluate

说明

参数

返回值

范例

参见

User Contributed Notes 5 notes