diff options
| -rwxr-xr-x | UPGRADING | 31 | ||||
| -rw-r--r-- | UPGRADING.INTERNALS | 50 |
2 files changed, 43 insertions, 38 deletions
@@ -29,37 +29,6 @@ PHP 5.5 UPGRADE NOTES - php_logo_guid(), php_egg_logo_guid(), php_real_logo_guid() and zend_logo_guid() have been removed - Removal of Logo GUIDs -- extensions can't override zend_execute() any more, they should override - zend_execute_ex() instead. The EG(current_execute_data) is already - initialized in zend_execute_ex(), so for compatibility extensions - may need to use EG(current_execute_data)->prev_execute_data instead. -- removed EG(arg_types_stack), EX(fbc), EX(called_scope), EX(current_object) -- added op_array->nested_calls. It's calculated at compile time. -- added EX(call_slots). It is an array to store information about syntaticaly - nested calls (e.g. foo(bar())). It's preallocated together with execute_data. -- added EX(call) - pointer to a current calling function. Actually an - element of EX(call_slots) -- opcodes INIT_METHOD_CALL, ZEND_INIT_STATIC_METHOD_CALL, - ZEND_INIT_FCALL_BY_NAME, ZEND_INIT_NS_FCALL_BY_NAME use result.num as - an index in EX(call_slots) -- opcode ZEND_NEW uses extended_vallue as an index in EX(call_slots) -- opcoes ZEND_DO_FCALL and ZEND_DO_FCALL_BY_NAME use op2.num as - an index in EX(call_slots) -- added op_array->used_stack. It's calculated at compile time and the - corresponding stack space is preallocated together with execute_data. - ZEND_SEND* and ZEND_DO_FCALL* don't need to check for stack overflow - anymore. -- Removed execute_data->Ts field. The VM temporary variables always allocated - immediately before execute_data structure. Now they are accessed by offset - from the execute_data base pointer (instead of execute_data->Ts). Compiler - stores new offsets in op_array->opcodes[*].op?.num. You can use macros - EX_TMP_VAR() and EX_TMP_VAR_NUM() to access temp_variable by offset or - number. You can convert number to offset using EX_TMP_VAR_NUM(0, num) or - offset to number (EX_TMP_VAR_NUM(0,0)-EX_TMP_VAR(0,offset)). -- Removed execute_data->CVs field. The VM compiled variables always allocated - immediately after execute_data structure. Now they are accessed by offset - from the execute_data base pointer (instead of execute_data->CVs). You can - use macros EX_CV_NUM() to access compiled variables by number. ======================================== 2. New Features diff --git a/UPGRADING.INTERNALS b/UPGRADING.INTERNALS index 56243d1f81..bdc2a43ab9 100644 --- a/UPGRADING.INTERNALS +++ b/UPGRADING.INTERNALS @@ -3,9 +3,11 @@ $Id$ UPGRADE NOTES - PHP X.Y 1. Internal API changes - a. Streams pooling API - b. Lowercasing and locales - c. zend_qsort_r + a. Executor changes + b. Streams pooling API + c. Lowercasing and locales + d. zend_qsort_r + e. get_current_key 2. Build system changes a. Unix build system changes @@ -16,7 +18,41 @@ UPGRADE NOTES - PHP X.Y 1. Internal API changes ======================== - a. Streams pooling API + a. Executor changes + + * extensions can't override zend_execute() any more, they should override + zend_execute_ex() instead. The EG(current_execute_data) is already + initialized in zend_execute_ex(), so for compatibility extensions + may need to use EG(current_execute_data)->prev_execute_data instead. + * removed EG(arg_types_stack), EX(fbc), EX(called_scope), EX(current_object) + * added op_array->nested_calls. It's calculated at compile time. + * added EX(call_slots). It is an array to store information about syntaticaly + nested calls (e.g. foo(bar())). It's preallocated together with execute_data. + * added EX(call) - pointer to a current calling function. Actually an + element of EX(call_slots) + * opcodes INIT_METHOD_CALL, ZEND_INIT_STATIC_METHOD_CALL, + ZEND_INIT_FCALL_BY_NAME, ZEND_INIT_NS_FCALL_BY_NAME use result.num as + an index in EX(call_slots) + * opcode ZEND_NEW uses extended_vallue as an index in EX(call_slots) + * opcoes ZEND_DO_FCALL and ZEND_DO_FCALL_BY_NAME use op2.num as + an index in EX(call_slots) + * added op_array->used_stack. It's calculated at compile time and the + corresponding stack space is preallocated together with execute_data. + ZEND_SEND* and ZEND_DO_FCALL* don't need to check for stack overflow + anymore. + * Removed execute_data->Ts field. The VM temporary variables always allocated + immediately before execute_data structure. Now they are accessed by offset + from the execute_data base pointer (instead of execute_data->Ts). Compiler + stores new offsets in op_array->opcodes[*].op?.num. You can use macros + EX_TMP_VAR() and EX_TMP_VAR_NUM() to access temp_variable by offset or + number. You can convert number to offset using EX_TMP_VAR_NUM(0, num) or + offset to number (EX_TMP_VAR_NUM(0,0)-EX_TMP_VAR(0,offset)). + * Removed execute_data->CVs field. The VM compiled variables always allocated + immediately after execute_data structure. Now they are accessed by offset + from the execute_data base pointer (instead of execute_data->CVs). You can + use macros EX_CV_NUM() to access compiled variables by number. + + b. Streams pooling API The streams pooling API has been removed. The following functions no longer exist: @@ -28,7 +64,7 @@ PHPAPI int php_stream_context_set_link(php_stream_context *context, PHPAPI int php_stream_context_del_link(php_stream_context *context, php_stream *stream); - b. Lowercasing and locales + c. Lowercasing and locales The lowercasing functions in zend_operators.c were split into those that do lowercasing according to locale rules and those that do ASCII lowercasing. @@ -54,7 +90,7 @@ such as strcasecmp, will be using locale rules. Two new functions - zend_binary_strncasecmp_l and zend_binary_strcasecmp_l - added as locale-based counterparts to zend_binary_strcasecmp and zend_binary_strncasecmp. - c. zend_qsort_r + d. zend_qsort_r Added the function zend_qsort_r(): @@ -64,7 +100,7 @@ void zend_qsort_r(void *base, size_t nmemb, size_t siz, compare_r_func_t compare The extra argument it has (relatively to zend_qsort()) is passed to the comparison function. - d. get_current_key + e. get_current_key The signature of the get_current_key iteration handler has been changed to: |