Stdlib: DOMDocumentFragment — createDocumentFragment/appendChild missing (ext/dom/php_dom.c, phase 2 #3326)

[PurHur]

Category

stdlib · php-src-strict

Problem

DOMDocument::createDocumentFragment() and the DOMDocumentFragment class are missing (class_exists('DOMDocumentFragment') → false). Even after baseline #3326 (DOMDocument/DOMElement), workers need fragment nodes to batch-append subtrees without polluting the live document — standard in php-src ext/dom and required for config/HTML builders.

Depends on #3326 (DOMDocument baseline).

php-src reference

• php/php-src ext/dom/php_dom.c — dom_document_create_document_fragment, domdocumentfragment_class_entry
• php/php-src ext/dom/document.c — createDocumentFragment method table

Repro (failure today)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php bin/vm.php -r "var_export(class_exists(\"DOMDocumentFragment\")); echo PHP_EOL;"
php -r "var_export(class_exists(\"DOMDocumentFragment\")); echo PHP_EOL;"
'

Check	Zend (dom ext)	VM
class_exists('DOMDocumentFragment')	true	false

After #3326 lands, minimal behavior repro:

<?php
$doc = new DOMDocument();
$frag = $doc->createDocumentFragment();
$child = $doc->createElement('item');
$frag->appendChild($child);
$doc->documentElement->appendChild($frag);
echo $doc->saveXML();

Scope (PHP-in-PHP first)

Layer	Path
Classes	ext/dom/BuiltinClasses.php — register DOMDocumentFragment
VM	ext/dom/VmDom.php — fragment node type, appendChild delegation
Methods	ext/dom/DocumentCreateDocumentFragment.php
Tests	test/compliance/cases/stdlib/dom_document_fragment.phpt

Not in scope: full DOM Level 3 Load/Save (#3326 umbrella).

Done when

• class_exists('DOMDocumentFragment') true on VM
• createDocumentFragment() returns appendable fragment; subtree merges into document without extra wrapper element
• appendChild on fragment moves children per php-src (not alias bugs)
• ./script/ci-fast.sh --filter dom_document_fragment green

Verification

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter dom_document_fragment'

Related

• Stdlib: ext/dom — DOMDocument/DOMElement XML tree API (ext/dom parity) #3326 DOM baseline · Stdlib: dom_import_simplexml() / simplexml_import_dom() — DOM↔SimpleXML bridge missing (ext/dom, ext/simplexml) #6057 DOM↔SimpleXML bridge · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

claim: cursor-agent-lane-c — batch (issues #6317, #8834, #8846, #8960)

[PurHur]

Merged via #14374.

Verification:

• vendor/bin/phpunit --filter dom_document_fragment — VM + JIT green (2/2)
• class_exists('DOMDocumentFragment') → true on VM
• Fragment children merge into parent without wrapper; fragment empty after append