[php-src] master: Add UPGRADING.INTERNALS notes for stream functions

Author: Gina Peter Banyard (Girgias) Date: 2026-07-27T11:57:09+01:00 Commit: https://github.com/php/php-src/commit/f77523b538bd39c94144c5b8edb85e5230369d45 Raw diff: https://github.com/php/php-src/commit/f77523b538bd39c94144c5b8edb85e5230369d45.diff Add UPGRADING.INTERNALS notes for stream functions Changed paths: M UPGRADING.INTERNALS Diff: diff --git a/UPGRADING.INTERNALS b/UPGRADING.INTERNALS index 49f9e1317143..39f5d72e2701 100644 --- a/UPGRADING.INTERNALS +++ b/UPGRADING.INTERNALS @@ -83,6 +83,43 @@ PHP 8.6 INTERNALS UPGRADE NOTES . The php_error_docref1() and php_error_docref2() functions have been removed, instead rely on the error_include_args INI option to show the arguments to functions in a consistent manner. + . The following PHP stream functions prefixed with _ have been removed, + and the macro without it has become the canonical function name: + * _php_stream_cast() + * _php_stream_free_enclosed() + * _php_stream_free() + * _php_stream_seek() + * _php_stream_tell() + * _php_stream_read() + * _php_stream_write() + * _php_stream_fill_read_buffer() + * _php_stream_printf() + * _php_stream_eof() + * _php_stream_getc() + * _php_stream_putc() + * _php_stream_flush() + * _php_stream_sync() + * _php_stream_get_line() + * _php_stream_puts() + * _php_stream_stat() + * _php_stream_mkdir() + * _php_stream_rmdir() + * _php_stream_readdir() + * _php_stream_set_option() + * _php_stream_get_url_stream_wrappers_hash() + * _php_get_stream_filters_hash() + * _php_stream_mmap_unmap() + * _php_stream_mmap_unmap_ex() + * _php_stream_filter_prepend() + * _php_stream_filter_append() + * _php_stream_filter_flush() + . The PHP stream function _php_stream_stat_path() has been renamed to + php_stream_stat_path_ex() + . The PHP stream function _php_stream_scandir() was removed, + insted the PHP macro php_stream_scandir() is now a function as the + flags parameter was never used. + . The PHP stream function _php_stream_flush() was removed, + instead the PHP macro php_stream_flush() is now a proper function. - Changed: . Internal functions that return by reference are now expected to