Skip to content

Commit 0b74e59

Browse files
authored
Fix organization of UPGRADING.INTERNALS (#19635)
1 parent cb9af8d commit 0b74e59

File tree

1 file changed

+18
-23
lines changed

1 file changed

+18
-23
lines changed

UPGRADING.INTERNALS

Lines changed: 18 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ PHP 8.5 INTERNALS UPGRADE NOTES
1414
1. Internal API changes
1515
========================
1616

17-
- Core
1817
. PG(arg_separator).input and PG(arg_separator).output are now `zend_string*`
1918
instead of `char*`.
2019
. DL_LOAD now doesn't use RTLD_DEEPBIND deepbind anymore on platforms
@@ -34,16 +33,6 @@ PHP 8.5 INTERNALS UPGRADE NOTES
3433
pointer. If the error will be delayed until runtime, it is stored in the
3534
new `validation_error` field of the `zend_attribute` struct.
3635
RFC: https://wiki.php.net/rfc/delayedtargetvalidation_attribute
37-
38-
- Hash
39-
. Hash functions now use proper hash_spec_result enum for return values
40-
instead of using SUCCESS and FAILURE.
41-
42-
- Random
43-
. The handlers parameter of php_random_engine_common_init() has been
44-
removed. Use the default_object_handlers field on the CE instead.
45-
46-
- Zend
4736
. Added zend_safe_assign_to_variable_noref() function to safely assign
4837
a value to a non-reference zval.
4938
. Added zval_ptr_safe_dtor() to safely destroy a zval when a destructor
@@ -91,13 +80,6 @@ PHP 8.5 INTERNALS UPGRADE NOTES
9180
from the parent process after a fork().
9281
. HASH_KEY_IS_* constants have been moved in the zend_hash_key_type enum.
9382

94-
- standard
95-
. ext/standard/php_smart_string.h and ext/standard/php_smart_string_public.h
96-
were removed. Use the corresponding headers in Zend/ instead.
97-
98-
- URI
99-
. Internal API for URI handling was added via the php_uri_*() functions.
100-
10183
========================
10284
2. Build system changes
10385
========================
@@ -136,26 +118,34 @@ PHP 8.5 INTERNALS UPGRADE NOTES
136118
3. Module changes
137119
========================
138120

139-
- ext/gd
121+
- Gd:
140122
. The gdImageScale*() and gdImageRotate*() helpers are now internal in the
141123
bundled libgd, like they have been in external libgd as of gd-2.1.1.
142124

143-
- ext/json
125+
- Hash:
126+
. Hash functions now use proper hash_spec_result enum for return values
127+
instead of using SUCCESS and FAILURE.
128+
129+
- JSON:
144130
. php_json_encode_serializable_object() now assumes `EG(active)`,
145131
if not a bailout is caused. Therefore a minor BC break exists if the
146132
`PHP_JSON_PARTIAL_OUTPUT_ON_ERROR` option is in use.
147133
However, this situation is highly unlikely.
148134

149-
- ext/libxml
135+
- Libxml:
150136
. The refcount APIs now return an `unsigned int` instead of an `int`.
151137
. Removed php_libxml_xmlCheckUTF8(). Use xmlCheckUTF8() from libxml instead.
152138

153-
- ext/pdo
139+
- PDO:
154140
. Added `php_pdo_stmt_valid_db_obj_handle()` to check if the database object
155141
is still valid. This is useful when a GC cycle is collected and the
156142
database object can be destroyed prior to destroying the statement.
157143

158-
- ext/standard
144+
- Random:
145+
. The handlers parameter of php_random_engine_common_init() has been
146+
removed. Use the default_object_handlers field on the CE instead.
147+
148+
- Standard:
159149
. Added php_url_decode_ex() and php_raw_url_decode_ex() that unlike their
160150
non-ex counterparts do not work in-place.
161151
. The php_std_date() function has been removed. Use php_format_date() with
@@ -165,6 +155,11 @@ PHP 8.5 INTERNALS UPGRADE NOTES
165155
and image_type_to_extension() is now extensible using the internal APIs
166156
php_image_register_handler() and php_image_unregister_handler() in
167157
php_image.h.
158+
. ext/standard/php_smart_string.h and ext/standard/php_smart_string_public.h
159+
were removed. Use the corresponding headers in Zend/ instead.
160+
161+
- URI:
162+
. Internal API for URI handling was added via the php_uri_*() functions.
168163

169164
========================
170165
4. OpCode changes

0 commit comments

Comments
 (0)