[php-src] master: Amend UPGRADING for recent deprecations and engine API changes

Author: Gina Peter Banyard (Girgias) Date: 2026-08-10T18:57:44+01:00 Commit: https://github.com/php/php-src/commit/34f5a729d3acffec08160f59a155c2c638d5cfe2 Raw diff: https://github.com/php/php-src/commit/34f5a729d3acffec08160f59a155c2c638d5cfe2.diff Amend UPGRADING for recent deprecations and engine API changes Changed paths: M UPGRADING M UPGRADING.INTERNALS Diff: diff --git a/UPGRADING b/UPGRADING index e4669740b35f..ad7f51bdeb24 100644 --- a/UPGRADING +++ b/UPGRADING @@ -447,6 +447,15 @@ PHP 8.6 UPGRADE NOTES RFC: https://wiki.php.net/rfc/deprecate-return-value-from-construct . Making __construct() and __destruct() a Generator is now deprecated. RFC: https://wiki.php.net/rfc/deprecate-return-value-from-construct + . Naming a function readonly is now deprecated. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_the_possibility_to_name_a_function_readonly + . Passing a 3rd argument to define() is now deprecated. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_define_with_case_insensitive_being_specified + +- BZ2 + . Passing an object for the Bzip2 {de}compression stream filter is now + deprecated. Use get_object_vars() on the object instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#passing_objects_as_parameters_to_the_bzip2decompress_and_bzip2compress_stream_filters - GMP . The shift (<<, >>) and exponentiation (**) operators on GMP objects now @@ -457,12 +466,62 @@ PHP 8.6 UPGRADE NOTES . Mbregex has been deprecated, because the underlying Oniguruma library is no longer maintained. RFC: https://wiki.php.net/rfc/eol-oniguruma + . Passing objects to mb_convert_variables() is now deprecated + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#passing_objects_for_vars_parameter_of_mb_convert_variables + +- SPL: + . The spl_classes() function is now deprecated, use + ReflectionExtension::getClassNames() instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_spl_classes + . The spl_object_hash() function is now deprecated, use spl_object_id() + instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_spl_object_hash + . The following ArrayIterator methods are now deprecated: + * ArrayIterator::getFlags() + * ArrayIterator::setFlags() + * ArrayIterator::asort() + * ArrayIterator::ksort() + * ArrayIterator::uasort() + * ArrayIterator::uksort() + * ArrayIterator::natsort() + * ArrayIterator::natcasesort() + * ArrayIterator::unserialize() + * ArrayIterator::serialize() + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_arrayiterator_methods_that_inherit_arrayobject_implementation - Standard: . Using more than 16 filters in a php://filter URL without configuring the "filter.max_filter_count" stream context option now emits an E_DEPRECATED warning. Use stream_filter_append() or configure this option explicitly. RFC: https://wiki.php.net/rfc/limit-maximum-number-of-filter-chains + . Passing an object to array_walk{_recursive} is now deprecated. Use + get_object_vars() on the object instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#passing_objects_for_array_parameter_of_array_walk_and_array_walk_recursive + . The is_double() function is now deprecated, use is_float() instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_is_double + . The is_long() and is_integer() functions are now deprecated, use is_int() + instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_is_integer + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_is_long + . The doubleval() function is now deprecated, use floatval() instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_doubleval + . The strcoll() function is now deprecated, use Collator::compare() instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_strcoll + . The SORT_LOCALE_STRING constant for the family of sort functions is now + deprecated, use one of the following functions instead: + * Collator::sort() + * Collator::asort() + * Collator::sort() + * Collator::sortWithSortKeys() + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#deprecate_sort_locale_string_flag_for_sort_functions + +- Zlib + . Passing an object for the zlib deflate and inflate stream filter is now + deprecated. Use get_object_vars() on the object instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#passing_objects_as_parameters_to_the_zlibinflate_and_zlibdeflate_stream_filters + . Passing an object to the $option argument to deflate_init and inflate_init + is now deprecated. Use get_object_vars() on the object instead. + RFC: https://wiki.php.net/rfc/deprecations_php_8_6#passing_objects_for_options_parameter_of_deflate_init_and_inflate_init ======================================== 5. Changed Functions diff --git a/UPGRADING.INTERNALS b/UPGRADING.INTERNALS index 3c0d3b4f80fa..4be8421dd7b1 100644 --- a/UPGRADING.INTERNALS +++ b/UPGRADING.INTERNALS @@ -134,6 +134,8 @@ PHP 8.6 INTERNALS UPGRADE NOTES . The PHP stream function _php_stream_flush() was removed, instead the PHP macro php_stream_flush() is now a proper function. . The zend_save_error_handling() function was removed. + . The zend_parse_parameter() function has been removed, use one fo the + zend_parse_arg_TYPE() APIs instead. - Changed: . Internal functions that return by reference are now expected to