php-src/Zend
Nikita Popov aaae77f7f1 Make Exception::$trace typed array property
This is a private property, so we are allowed to add a type.
The new declaration of the property is:

    private array $trace = [];

This ensures that Exception::getTrace() does indeed return an array.

Userland code that was modifying the property through refleciton
may have to be adjusted to assign an array (instead of null,
for example).

Closes GH-5636.
2020-05-28 13:55:38 +02:00
..
tests Convert Exception::getMessage() result to string 2020-05-28 11:51:35 +02:00
bench.php Apply tidy formatting 2020-02-03 13:41:31 +01:00
LICENSE
Makefile.frag Clean up the generation of the parsers 2020-02-01 14:21:53 +01:00
micro_bench.php Apply tidy formatting 2020-02-03 13:41:31 +01:00
README.md
zend_alloc_sizes.h
zend_alloc.c Add crude memory limit to tracked alloc 2020-04-21 10:44:15 +02:00
zend_alloc.h fix cross compilation failure due to size_t typecast in define 2020-01-30 15:51:54 +01:00
zend_API.c Make Exception::$trace typed array property 2020-05-28 13:55:38 +02:00
zend_API.h Refactor ZPP API to use uint32_t as everywhere else 2020-05-22 17:13:42 +02:00
zend_arena.h
zend_ast.c Support catching exceptions without capturing them to variables 2020-05-26 15:12:18 +02:00
zend_ast.h Implement union types 2019-11-08 15:15:48 +01:00
zend_bitset.h
zend_build.h
zend_builtin_functions_arginfo.h Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_builtin_functions.c Add get_resource_id() function 2020-05-11 12:04:16 +02:00
zend_builtin_functions.h
zend_builtin_functions.stub.php Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_closures_arginfo.h Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_closures.c Generate method entries for Closure 2020-05-19 14:19:37 +02:00
zend_closures.h
zend_closures.stub.php Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_compile.c Fix variable type 2020-05-26 15:58:36 +02:00
zend_compile.h Avoid throw expression leaks 2020-04-27 15:22:05 +02:00
zend_config.w32.h Drop duplicate definitions of zend_isnan and friends 2019-12-08 14:55:26 +01:00
zend_constants.c Don't index NULL pointer when fetching non-existent constant 2020-01-28 11:20:57 +01:00
zend_constants.h Add support for deprecating constants 2020-01-17 10:05:06 +01:00
zend_cpuinfo.c
zend_cpuinfo.h
zend_default_classes.c
zend_dtrace.c
zend_dtrace.d
zend_dtrace.h
zend_errors.h Use clean shutdown on uncaught exception 2019-10-11 12:41:15 +02:00
zend_exceptions_arginfo.h Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_exceptions.c Make Exception::$trace typed array property 2020-05-28 13:55:38 +02:00
zend_exceptions.h add ValueError 2019-09-09 21:06:00 +01:00
zend_exceptions.stub.php Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_execute_API.c Keep trace number in EG(jit_trace_num) instead of EG(reserved)[zend_func_info_rid] 2020-05-25 17:05:26 +03:00
zend_execute.c Improve type error messages when an object is given 2020-05-26 19:06:19 +02:00
zend_execute.h Improve error message for deprecated methods 2020-05-14 17:23:31 +02:00
zend_extensions.c
zend_extensions.h Free two bits in fn_flags by merging ZEND_ACC_HEAP_RT_CACHE/ZEND_ACC_USER_ARG_INFO and ZEND_ACC_DONE_PASS_TWO/ZEND_ACC_ARENA_ALLOCATED that may be used only for user/internal functions 2019-09-02 14:05:28 +03:00
zend_float.c Revert "Fix #79595: zend_init_fpu() alters FPU precision" 2020-05-22 16:57:14 +02:00
zend_float.h Fix #79595: zend_init_fpu() alters FPU precision 2020-05-26 17:19:54 +02:00
zend_gc.c Add helper APIs for get_gc implementations 2020-04-27 10:48:22 +02:00
zend_gc.h Fix other typos in param name/code comments 2020-05-01 12:23:16 +02:00
zend_gdb.c
zend_gdb.h
zend_generators_arginfo.h Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_generators.c Merge branch 'PHP-7.4' 2020-05-15 11:05:00 +02:00
zend_generators.h Add helper APIs for get_gc implementations 2020-04-27 10:48:22 +02:00
zend_generators.stub.php Annotate internal functions with the mixed type 2020-05-25 17:30:57 +02:00
zend_globals_macros.h
zend_globals.h Keep trace number in EG(jit_trace_num) instead of EG(reserved)[zend_func_info_rid] 2020-05-25 17:05:26 +03:00
zend_hash.c Fix [-Wundef] warning in Zend folder 2020-05-12 22:01:51 +02:00
zend_hash.h Add zend_array_release() function 2020-05-06 11:27:20 +02:00
zend_highlight.c
zend_highlight.h
zend_inheritance.c Add support for the mixed type 2020-05-22 16:08:12 +02:00
zend_inheritance.h Merge branch 'PHP-7.4' 2019-09-12 16:41:45 +02:00
zend_ini_parser.y Merge branch 'PHP-7.4' 2020-05-14 14:16:22 +02:00
zend_ini_scanner.h
zend_ini_scanner.l Fixed bug #79244 (php crashes during parsing INI file). (Laruence) 2020-02-10 13:01:51 +08:00
zend_ini.c Add macro to get ini target address 2020-04-27 10:30:00 +02:00
zend_ini.h Add macro to get ini target address 2020-04-27 10:30:00 +02:00
zend_interfaces_arginfo.h Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_interfaces.c Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_interfaces.h Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_interfaces.stub.php Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_istdiostream.h
zend_iterators.c Fix [-Wmissing-field-initializers] compiler warning in zend_iterator 2020-02-10 11:46:19 +01:00
zend_iterators.h
zend_language_parser.y Support catching exceptions without capturing them to variables 2020-05-26 15:12:18 +02:00
zend_language_scanner.h Syntax errors caused by unclosed {, [, ( mention specific location 2020-04-14 11:22:23 +02:00
zend_language_scanner.l Syntax errors caused by unclosed {, [, ( mention specific location 2020-04-14 11:22:23 +02:00
zend_list.c Make zend_list_free return void 2020-04-15 11:01:12 +02:00
zend_list.h Make zend_list_free return void 2020-04-15 11:01:12 +02:00
zend_llist.c
zend_llist.h
zend_long.h Use supported printf format on Win64 2020-05-11 10:49:44 +02:00
zend_map_ptr.h Perform map ptr base arithmetic through uintptr_t 2020-01-28 11:24:04 +01:00
zend_modules.h Free two bits in fn_flags by merging ZEND_ACC_HEAP_RT_CACHE/ZEND_ACC_USER_ARG_INFO and ZEND_ACC_DONE_PASS_TWO/ZEND_ACC_ARENA_ALLOCATED that may be used only for user/internal functions 2019-09-02 14:05:28 +03:00
zend_multibyte.c
zend_multibyte.h
zend_multiply.h
zend_object_handlers.c Convert Exception::getMessage() result to string 2020-05-28 11:51:35 +02:00
zend_object_handlers.h Make cast_object handler required 2020-03-31 14:37:49 +02:00
zend_objects_API.c Remove delref in free_object_storage 2019-08-28 17:04:36 +02:00
zend_objects_API.h Use ZEND_TYPE_IS_SET() when checking for property types 2019-09-23 16:53:54 +02:00
zend_objects.c Merge branch 'PHP-7.4' 2019-10-25 16:32:14 +02:00
zend_objects.h
zend_opcode.c Fix [-Wjump-misses-init] in generated zend_opcode.c 2020-04-18 14:52:49 +02:00
zend_operators.c Use zend_zval_type_name() API where possible 2020-05-13 14:56:05 +02:00
zend_operators.h Fix [-Wundef] warning in Zend folder 2020-05-12 22:01:51 +02:00
zend_portability.h Revert "Revert "Merge branch 'PHP-7.4'"" 2020-05-20 14:11:42 +02:00
zend_ptr_stack.c
zend_ptr_stack.h
zend_range_check.h
zend_signal.c
zend_signal.h
zend_smart_str_public.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_smart_str.c Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_smart_str.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_smart_string_public.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_smart_string.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_sort.c Remove zend_qsort 2020-05-12 16:57:53 +02:00
zend_sort.h Remove zend_qsort 2020-05-12 16:57:53 +02:00
zend_stack.c
zend_stack.h
zend_stream.c Fix #79514: Memory leaks while including unexistent file 2020-04-24 18:14:53 +02:00
zend_stream.h
zend_string.c Add zend_string_concat2 API 2020-04-14 17:18:05 +02:00
zend_string.h Add support for the mixed type 2020-05-22 16:08:12 +02:00
zend_strtod_int.h Drop unnecessary stdint and inttypes header checks 2020-04-22 20:18:19 +02:00
zend_strtod.c Revert "Revert "Merge branch 'PHP-7.4'"" 2020-05-20 14:11:42 +02:00
zend_strtod.h
zend_ts_hash.c Use separate typedef for bucket comparison function 2020-03-04 12:46:06 +01:00
zend_ts_hash.h Use separate typedef for bucket comparison function 2020-03-04 12:46:06 +01:00
zend_type_info.h Add static return type 2020-02-17 11:51:09 +01:00
zend_types.h Add support for the mixed type 2020-05-22 16:08:12 +02:00
zend_variables.c
zend_variables.h
zend_virtual_cwd.c Merge branch 'PHP-7.4' 2020-04-27 09:32:02 +02:00
zend_virtual_cwd.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_vm_def.h Support catching exceptions without capturing them to variables 2020-05-26 15:12:18 +02:00
zend_vm_execute.h Support catching exceptions without capturing them to variables 2020-05-26 15:12:18 +02:00
zend_vm_execute.skl Revert "Revert "Merge branch 'PHP-7.4'"" 2020-05-20 14:11:42 +02:00
zend_vm_gen.php Prevent CGG reordering if hanlers order is defined by zend_vm_order.txt 2020-05-22 12:37:35 +03:00
zend_vm_handlers.h Revert "Fetch for read in nested property assignments" 2020-03-18 14:54:43 +01:00
zend_vm_opcodes.c Revert "Fetch for read in nested property assignments" 2020-03-18 14:54:43 +01:00
zend_vm_opcodes.h Throw Error when writing property of non-object 2019-09-27 10:11:47 +02:00
zend_vm_trace_handlers.h
zend_vm_trace_map.h Fixed typecast 2020-05-22 12:36:52 +03:00
zend_vm.h
zend_weakrefs_arginfo.h Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_weakrefs.c Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend_weakrefs.h Remove mention of PHP major version in Copyright headers 2019-09-25 14:51:43 +02:00
zend_weakrefs.stub.php Generate method entries from stubs for Zend classes 2020-04-26 11:13:14 +02:00
zend.c Fixed bug #97599 (coredump in set_error_handler) 2020-05-15 15:36:00 +08:00
zend.h Adjust zend_write_func signature 2020-04-15 11:01:12 +02:00
Zend.m4 Add -Wextra compiler warnings and exclude the trigger happy ones 2020-04-14 22:22:35 +02:00

Zend Engine

Zend memory manager

General

The goal of the new memory manager (available since PHP 5.2) is to reduce memory allocation overhead and speedup memory management.

Debugging

Normal:

sapi/cli/php -r 'leak();'

Zend MM disabled:

USE_ZEND_ALLOC=0 valgrind --leak-check=full sapi/cli/php -r 'leak();'

Shared extensions

Since PHP 5.3.11 it is possible to prevent shared extensions from unloading so that valgrind can correctly track the memory leaks in shared extensions. For this there is the ZEND_DONT_UNLOAD_MODULES environment variable. If set, then DL_UNLOAD() is skipped during the shutdown of shared extensions.

ZEND_VM

ZEND_VM architecture allows specializing opcode handlers according to op_type fields and using different execution methods (call threading, switch threading and direct threading). As a result ZE2 got more than 20% speedup on raw PHP code execution (with specialized executor and direct threading execution method). As in most PHP applications raw execution speed isn't the limiting factor but system calls and database calls are, your mileage with this patch will vary.

Most parts of the old zend_execute.c go into zend_vm_def.h. Here you can find opcode handlers and helpers. The typical opcode handler template looks like this:

ZEND_VM_HANDLER(<OPCODE-NUMBER>, <OPCODE>, <OP1_TYPES>, <OP2_TYPES>)
{
    <HANDLER'S CODE>
}

<OPCODE-NUMBER> is a opcode number (0, 1, ...) <OPCODE> is an opcode name (ZEN_NOP, ZEND_ADD, :) <OP1_TYPES> and <OP2_TYPES> are masks for allowed operand op_types. Specializer will generate code only for defined combination of types. You can use any combination of the following op_types UNUSED, CONST, VAR, TMP and CV also you can use ANY mask to disable specialization according operand's op_type. <HANDLER'S CODE> is a handler's code itself. For most handlers it stills the same as in old zend_execute.c, but now it uses macros to access opcode operands and some internal executor data.

You can see the conformity of new macros to old code in the following list:

EXECUTE_DATA
    execute_data
ZEND_VM_DISPATCH_TO_HANDLER(<OP>)
    return <OP>_helper(ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
ZEND_VM_DISPATCH_TO_HELPER(<NAME>)
    return <NAME>(ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
ZEND_VM_DISPATCH_TO_HELPER_EX(<NAME>,<PARAM>,<VAL>)
    return <NAME>(<VAL>, ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
ZEND_VM_CONTINUE()
    return 0
ZEND_VM_NEXT_OPCODE()
    NEXT_OPCODE()
ZEND_VM_SET_OPCODE(<TARGET>
    SET_OPCODE(<TARGET>
ZEND_VM_INC_OPCODE()
    INC_OPCOD()
ZEND_VM_RETURN_FROM_EXECUTE_LOOP()
    RETURN_FROM_EXECUTE_LOOP()
ZEND_VM_C_LABEL(<LABEL>):
    <LABEL>:
ZEND_VM_C_GOTO(<LABEL>)
    goto <LABEL>
OP<X>_TYPE
    opline->op<X>.op_type
GET_OP<X>_ZVAL_PTR(<TYPE>)
    get_zval_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
GET_OP<X>_ZVAL_PTR_PTR(<TYPE>)
    get_zval_ptr_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
GET_OP<X>_OBJ_ZVAL_PTR(<TYPE>)
    get_obj_zval_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
GET_OP<X>_OBJ_ZVAL_PTR_PTR(<TYPE>)
    get_obj_zval_ptr_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
IS_OP<X>_TMP_FREE()
    IS_TMP_FREE(free_op<X>)
FREE_OP<X>()
    FREE_OP(free_op<X>)
FREE_OP<X>_IF_VAR()
    FREE_VAR(free_op<X>)
FREE_OP<X>_VAR_PTR()
    FREE_VAR_PTR(free_op<X>)

Executor's helpers can be defined without parameters or with one parameter. This is done with the following constructs:

ZEND_VM_HELPER(<HELPER-NAME>, <OP1_TYPES>, <OP2_TYPES>)
{
    <HELPER'S CODE>
}

ZEND_VM_HELPER_EX(<HELPER-NAME>, <OP1_TYPES>, <OP2_TYPES>, <PARAM_SPEC>)
{
    <HELPER'S CODE>
}

Executor's code is generated by PHP script zend_vm_gen.php it uses zend_vm_def.h and zend_vm_execute.skl as input and produces zend_vm_opcodes.h and zend_vm_execute.h. The first file is a list of opcode definitions. It is included from zend_compile.h. The second one is an executor code itself. It is included from zend_execute.c.

zend_vm_gen.php can produce different kind of executors. You can select different opcode threading model using --with-vm-kind=CALL|SWITCH|GOTO. You can disable opcode specialization using --without-specializer. You can include or exclude old executor together with specialized one using --without-old-executor. At last you can debug executor using original zend_vm_def.h or generated file zend_vm_execute.h. Debugging with original file requires --with-lines option. By default ZE2 uses the following command to generate executor:

php zend_vm_gen.php --with-vm-kind=CALL