php-src/UPGRADING.INTERNALS at master · php-generics/php-src · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
PHP 8.6 INTERNALS UPGRADE NOTES

1. Internal API changes

2. Build system changes

3. Module changes

4. OpCode changes

5. SAPI changes

========================
1. Internal API changes
========================

  . ZSTR_INIT_LITERAL(), zend_string_starts_with_literal(), and
    zend_string_starts_with_literal_ci() now support strings containing NUL
    bytes. Passing non-literal char* is no longer supported.
  . The misnamed ZVAL_IS_NULL() has been removed. Use Z_ISNULL() instead.
  . New zend_class_entry.ce_flags2 and zend_function.fn_flags2 fields were
    added, given the primary flags were running out of bits.
  . The zval_is_true() alias of zend_is_true() has been removed. Call
    zend_is_true() directly instead.
  . The _zval_get_*() compatibility macros for PHP 7.2 have been removed
    call the variant without the leading underscore instead.
    Affected: _zval_get_long, _zval_get_double, _zval_get_string,
    _zval_get_long_func, _zval_get_double_func, _zval_get_string_func
  . CHECK_ZVAL_NULL_PATH() and CHECK_NULL_PATH() have been removed, use
    zend_str_has_nul_byte(Z_STR_P(...)) and zend_char_has_nul_byte()
    respectively.
  . ZEND_LTOA() (and ZEND_LTOA_BUF_LEN) has been removed, as it was
    unsafe. Directly use ZEND_LONG_FMT with a function from the
    printf family.
  . The zval_dtor() alias of zval_ptr_dtor_nogc() has been removed.
    Call zval_ptr_dtor_nogc() directly instead.
  . The internal zend_copy_parameters_array() function is no longer exposed.
  . The zend_make_callable() function has been removed, if a callable zval
    needs to be obtained use the zend_get_callable_zval_from_fcc() function
    instead. If this was used to store a callable, then an FCC should be
    stored instead.
  . The zend_active_function{_ex}() functions now return a const zend_function
    pointer.
  . The zend_get_call_trampoline_func() API now takes the __call or
    __callStatic zend_function* instead of a CE and a boolean argument.
  . The zend_set_hash_symbol() API has been removed.
  . Added zend_hash_str_lookup().
  . The WRONG_PARAM_COUNT and ZEND_WRONG_PARAM_COUNT() macros have been
    removed. Call zend_wrong_param_count(); followed by RETURN_THROWS();
    instead.
  . PHP_HAVE_STREAMS macro removed from <php.h>.
  . zend_function.arg_info is now always a zend_arg_info*. Before, it was a
    zend_internal_arg_info on internal functions, unless the
    ZEND_ACC_USER_ARG_INFO flag was set.
  . Added zend_ast_call_get_args() to fetch the argument node from any call
    node.
  . The zend_exception_save() and zend_exception_restore() functions were
    removed.
  . Internal functions that return by reference are now expected to
    automatically unwrap references when the result of the call is stored in an
    IS_TMP_VAR variable. This may be achieved by calling the
    zend_return_unwrap_ref() function.
  . The php_math_round_mode_from_enum() function now takes a
    zend_enum_RoundingMode parameter.
  . Added Z_PARAM_ENUM().
  . Added zend_enum_fetch_case_id().
  . ZEND_INI_GET_ADDR() is now a void* pointer instead of a char* pointer. This
    more correctly represents the generic nature of the returned pointer and
    allows to remove explicit casts, but possibly breaks pointer arithmetic
    performed on the result.
  . The zend_dval_to_lval_cap() function no longer takes a second
    zend_string* parameter.
  . EG(in_autoload) was renamed to EG(autoload_current_classnames) and no
    longer is a pointer, but a directly embedded HashTable struct.
  . Added a C23_ENUM() helper macro to define forward-compatible fixed-size
    enums.

========================
2. Build system changes
========================

- Abstract:
  . Minimum required PHP version found on the host system for running scripts
    like build/gen_stub.php during development has been updated from 7.4 to 8.1.
  . build/gen_stub.php may now generate a _decl.h file in addition to
    the _arginfo.h file, if the stub declares enums and is annotated with
    @generate-c-enums. For each enum the file will contain a C enum. Enum
    values can be compared to the result of
    zend_enum_fetch_case_id(zend_object*).

- Unix build system changes:
  . Symbol HAVE_ST_BLOCKS has been removed from php_config.h (use
    HAVE_STRUCT_STAT_ST_BLOCKS).

========================
3. Module changes
========================

- ext/mbstring:
  . Added GB18030-2022 to default encoding list for zh-CN.

- ext/mysqlnd:
  . Dropped session_options parameter from all methods in mysqlnd_auth.
    The same information is present in conn->options and should be used
    instead.

- ext/session:
  . php_session_flush() now returns a bool rather than a zend_result.
  . The mod_user_names global has been removed.
  . The mod_user_uses_object_methods_as_handlers global has been added,
    it indicates whether the session handlers are methods of an object or not.
  . Removed session_adapt_url().
  . PS_OPEN_ARGS is now defined as
    `void **mod_data, zend_string *save_path, zend_string *session_name`
    rather than
    `void **mod_data, const char *save_path, const char *session_name`
  . PS_FUNCS() now includes the PS_VALIDATE_SID_FUNC()
  . PS_MOD() now requires that the PS_CREATE_SID_FUNC() and
    PS_VALIDATE_SID_FUNC() functions are defined.
  . PS_FUNCS_SID() and PS_MOD_SID() have been removed.
    Either use PS_FUNCS()/PS_MOD() or PS_FUNCS_UPDATE_TIMESTAMP()/
    PS_MOD_UPDATE_TIMESTAMP() if timestamp support exists.

- ext/standard:
  . _php_error_log() now has a formal return type of zend_result.
  . _php_error_log() now accepts zend_string* values instead of char*.
  . _php_error_log_ex() has been removed.
  . php_mail()'s extra_cmd parameter is now a zend_string*.

- ext/xml:
  . Removed the XML_ExpatVersion() libxml compatibility wrapper,
    as it was unused.
  . Removed the XML_GetCurrentByteCount() libxml compatibility wrapper,
    as it was unused and could return the wrong result.

========================
4. OpCode changes
========================

- Added ZEND_TYPE_ASSERT to check a value's type against the parameter
  type of a function, throwing a TypeError on failure as if the function
  was called. Used in optimizations that elide function calls.

========================
5. SAPI changes
========================