Implement DOMNode::getRootNode()

ref: https://dom.spec.whatwg.org/#dom-node-getrootnode

Closes GH-11693.

Implement DOMElement::getAttributeNames()

ref: https://dom.spec.whatwg.org/#dom-element-getattributenames

Implement DOMNode::contains()

ref: https://dom.spec.whatwg.org/#dom-node-contains

Implement DOMDocument::adoptNode()

For the past 20 years this threw a "not yet implemented" exception. But
the function was actually there (albeit not documented) and could be called...

Implement DOMDocument::adoptNode()

For the past 20 years this threw a "not yet implemented" exception. But
the function was actually there (albeit not documented) and could be called...

Closes GH-11333.

show more ...

Fix return value in stub file for DOMNodeList::item

Not explicitly documenting the possibility of returning DOMElement causes
the Intelephense linter (a popular PHP linter with ~9 millio

Fix return value in stub file for DOMNodeList::item

Not explicitly documenting the possibility of returning DOMElement causes
the Intelephense linter (a popular PHP linter with ~9 million downloads:
https://marketplace.visualstudio.com/items?itemName=bmewburn.vscode-intelephense-client)
to think this code is bad:

$xp->query("whatever")->item(0)->getAttribute("foo");

DOMNode does not have getAttribute (while DOMElement does).
Documenting the DOMElement return type should fix Intelephense's linter.

Closes GH-11342.

show more ...

Change DOMCharacterData::appendData return type to true (#10690)

Rename @cname to @cvalue in stubs (#9043)

@cname currently refers to the constant name in C. However, it is not always a (constant) name, but sometimes a function invocation, so naming it as

Rename @cname to @cvalue in stubs (#9043)

@cname currently refers to the constant name in C. However, it is not always a (constant) name, but sometimes a function invocation, so naming it as @cvalue would be more appropriate.

show more ...

Declare ext/dom constants in stubs (#8676)

Add some stub related todo comments

Fix a few more classsynopsis generation issues

Closes GH-7480

Make a few unuseful DOMEntity properties readonly (#7406)

DOMCharacterData::$data and DOMAttr::$value are writable

Mark DOM classes as not serializable

Fix another DOMNameSpaceNode casing issue

Merge branch 'PHP-8.0'

* PHP-8.0:
dom_import_simplexml() cannot return null

dom_import_simplexml() cannot return null

Fix return type of DOMNodeList::item()

It can also return DOMNameSpaceNode :(

Declare tentative return types for ext/dom (#6985)

Throw DomException for DOM out-of-memory error conditions

A number of error conditions in DOM can only occur if libxml2 runs
out of memory, at least as far as I can see. In such cases we

Throw DomException for DOM out-of-memory error conditions

A number of error conditions in DOM can only occur if libxml2 runs
out of memory, at least as far as I can see. In such cases we
currently do a silent "return false", which violates the DOM spec,
and which code is very unlikely to handle sensibly.

Switch these to throw a DomException with INVALID_STATE_ERR type.
This error type is chosen because we use for similar checks
elsewhere, for example:
https://github.com/php/php-src/blob/a733b1ada7895f6fa5e349755a878cae9189e3f5/ext/dom/documentfragment.c#L45-L48

This changes some of the more obvious cases I spotted, but there are probably more.

Closes GH-7049.

show more ...

Actually add the tentative type marker...

Add minimial tentative types to dom

Just for implementations of Countable. These (no longer) suffer
from an overly broad return type.

DOMNamedNodeMap::count() cannot return false

DOMNodeList::count() cannot return false

Refactor the implementation to make this obvious, and make use
of early returns.

Declare typed properties in ext/dom

Closes GH-7013

Declare dynamic properties in ext/dom

Closes GH-6644