[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