Merge branch 'master' into immutable

* master: Remove unused variable makefile_am_files Classify object handlers are required/optional Add support for getting SKIP_TAGSTART and SKIP_WHITE options Remove some obsolete config_vars.mk occurrences Remove bsd_converted from .gitignore Remove configuration parser and scanners ignores Remove obsolete buildconf.stamp from .gitignore [ci skip] Add magicdata.patch exception to .gitignore Remove outdated ext/spl/examples items from .gitignore Remove unused test.inc in ext/iconv/tests
php · dstogov · Oct 15, 2018 · Oct 15, 2018 · Oct 16, 2018 · Oct 16, 2018
commit a06f0f3d3aba53e766046221ee44fb9720389ecc
diff --git a/UPGRADING.INTERNALS b/UPGRADING.INTERNALS
@@ -7,7 +7,8 @@ PHP 7.4 INTERNALS UPGRADE NOTES
   d. Removed zend_check_private()
   e. php_win32_error_to_msg() memory management
   f. get_properties_for() handler / Z_OBJDEBUG_P
-  g. Immutable classes and op_arrays
+  g. Required object handlers
+  h. Immutable classes and op_arrays
 
 2. Build system changes
   a. Abstract
@@ -99,7 +100,29 @@ PHP 7.4 INTERNALS UPGRADE NOTES
          // ...
          zend_release_properties(ht);
 
-  g. Opcache may make classes and op_arrays immutable. Such classes are marked
+  g. The following object handlers are now required (must be non-NULL):
+
+       * free_obj
+       * dtor_obj
+       * read_property
+       * write_property
+       * read_dimension
+       * write_dimension
+       * get_property_ptr_ptr
+       * has_property
+       * unset_property
+       * has_dimension
+       * unset_dimension
+       * get_properties
+       * get_method
+       * get_constructor
+       * get_class_name
+       * get_gc
+
+     It is recommended to initialize object handler structures by copying the
+     std object handlers and only overwriting those you want to change.
+
+  h. Opcache may make classes and op_arrays immutable. Such classes are marked
      by ZEND_ACC_IMMUTABLE flag, they are not going to be copied from opcache
      shard memory to process memory and must not be modified at all.
      Few related data structures were changed to allow addressing mutable data