[ci skip] Be more specific about ext-dom incompatibilities in UPGRADING (#14024)

The previous text was put there before I decided to add the new classes.
Therefore the only new feature that can affect BC is
compareDocumentPosition(). Only when the declaration is incompatible can
the user experience errors.
This commit is contained in:
Niels Dossche 2024-04-20 23:21:40 +02:00 committed by GitHub
parent 23640542dc
commit 7428a92c5b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -31,11 +31,10 @@ PHP 8.4 UPGRADE NOTES
. The type of PHP_DEBUG and PHP_ZTS constants changed to bool. . The type of PHP_DEBUG and PHP_ZTS constants changed to bool.
- DOM: - DOM:
. New methods and constants were added to some DOM classes. If you inherit . Added DOMNode::compareDocumentPosition() and DOMNode::DOCUMENT_POSITION_*
from these and you happen to have a method or property with the same name, constants.
you might encounter errors if the declaration is incompatible. If you have a method or constant with the same name, you might encounter errors
Consult sections 2. New Features and 6. New Functions for a list of if the declaration is incompatible.
newly implemented methods and constants.
. Some DOM methods previously returned false or a PHP_ERR DOMException if a new . Some DOM methods previously returned false or a PHP_ERR DOMException if a new
node could not be allocated. They consistently throw an INVALID_STATE_ERR node could not be allocated. They consistently throw an INVALID_STATE_ERR
DOMException now. This situation is extremely unlikely though and probably DOMException now. This situation is extremely unlikely though and probably