Stdlib: Dom\XPath missing — namespaced XPath after Dom\HTMLDocument/XMLDocument (ext/dom/php_dom.stub.php)

[PurHur]

Category

stdlib · php-src-strict · Dom living XPath · pillar 4 (DOM)

Problem

PHP 8.4 Dom\XPath is the living-standard equivalent of DOMXPath for Dom\HTMLDocument / Dom\XMLDocument. On PHP_COMPILER_PROFILE=8.4 the class is absent (Class "Dom\XPath" not found) while legacy DOMXPath already accepts living documents.

Repro	Zend 8.4+ (ext/dom)	VM PROFILE=8.4 (2026-07-19)
class_exists('Dom\\XPath')	true	false
new Dom\\XPath($htmlDoc)	Dom\XPath	fatal Class not found
$xp->query('//p')->item(0) on HTMLDocument	node	N/A

php-src reference

• php/php-src ext/dom/php_dom.stub.php — namespace Dom { final class XPath } (@implementation-alias of DOMXPath for most methods)
• php/php-src ext/dom/xpath.c — construct / query / evaluate

PHP implementation target

• Register Dom\XPath (+ Dom\NodeList for query/evaluate node-set returns) in ext/dom/DomLivingBuiltinClasses.php
• Living construct accepting Dom\Document (reject legacy DOMDocument with TypeError)
• Reuse VmDomXPath handlers; return Dom\NodeList for living XPath (keep DOMNodeList for legacy)
• PHP-in-PHP; no new runtime/*.c

Repro

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && PHP_COMPILER_PROFILE=8.4 php bin/vm.php test/repro/maintainer_gap_dom_xpath_living.php'

Done when

• class_exists('Dom\\XPath') true on PROFILE=8.4
• new Dom\\XPath(Dom\\HTMLDocument|XMLDocument) works; query/evaluate/registerNamespace/quote green
• Node-set results are Dom\\NodeList (not legacy DOMNodeList)
• Compliance .phpt under test/compliance/cases/dom/ or stdlib/
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: PHP Compiler Ext — DOM & XML — starting this run

Pillar 1 (this workspace): user_release_ready: yes (inventory OK 5810/5810, spine-coverage ok, north-star5-fast ok, vm-driver-probe ok).

Implementing Dom\XPath + Dom\NodeList on PROFILE=8.4.

[PurHur]

Merged via #20763

Verification (PROFILE=8.4, docker-exec):

• php bin/vm.php test/repro/maintainer_gap_dom_xpath_living.php → ok
• vendor/bin/phpunit test/compliance/VMTest.php --filter dom_xpath_living → OK (1 test)
• php script/bootstrap-inventory.php --check → OK 5819/5819
• spine-coverage sync → OK

Dom\XPath + Dom\NodeList registered on living documents; node-sets return Dom\NodeList; legacy DOMDocument construct TypeErrors.

[PurHur]

Merged via #20763

Verification

PHP_COMPILER_PROFILE=8.4 php bin/vm.php test/repro/maintainer_gap_dom_xpath_living.php
# => ok
vendor/bin/phpunit test/compliance/VMTest.php --filter dom_xpath_living
# => OK
php script/bootstrap-inventory.php --check  # OK 5819/5819
php script/check-selfhost-spine-coverage-sync.php  # OK

Notes

• Dom\XPath + Dom\NodeList on PROFILE=8.4; living query/evaluate return Dom\NodeList
• JIT Dom\XPath::query() deferred (WeakRef helper bootstrap) — skipped in JITTest