php-src/Zend
Tyson Andre 1e9a5c67ef Rename standard array function parameters to $array
This is targeting 8.0.

`$arg` seems like a poor choice of a name,
especially if the function were to have arguments added.

In many cases, the php.net documentation already has $array for these functions.
E.g. https://www.php.net/manual/en/function.array-intersect.php

I'd assume that since named arguments was added to 8.0 near the feature freeze,
PHP's maintainers had planned to make the names consistent
and gradually use the same name for  docs and implementation.
2020-08-11 19:11:59 -04:00
..
tests Rename standard array function parameters to $array 2020-08-11 19:11:59 -04: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 Drop the unneeded pointer casting 2020-08-03 02:05:14 +01: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 Accept zend_object* in zend_update_property 2020-08-07 16:40:27 +02:00
zend_API.h Accept zend_object* in zend_update_property 2020-08-07 16:40:27 +02:00
zend_arena.h
zend_ast.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_ast.h Implement named parameters 2020-07-31 15:53:36 +02:00
zend_attributes_arginfo.h Implement Attribute Amendments. 2020-06-29 10:45:51 +02:00
zend_attributes.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_attributes.h Implement named parameters 2020-07-31 15:53:36 +02:00
zend_attributes.stub.php Implement Attribute Amendments. 2020-06-29 10:45:51 +02:00
zend_bitset.h
zend_build.h
zend_builtin_functions_arginfo.h Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_builtin_functions.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_builtin_functions.h
zend_builtin_functions.stub.php Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_closures_arginfo.h Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_closures.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_closures.h Cleanup argument handling in ext/reflection 2020-07-24 17:47:42 +02:00
zend_closures.stub.php Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_compile.c Fix nullsafe operator on $this 2020-08-11 15:22:14 +02:00
zend_compile.h Implement named parameters 2020-07-31 15:53:36 +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 Review the usage of apostrophes in error messages 2020-07-10 21:05:28 +02:00
zend_constants.h Add support for deprecating constants 2020-01-17 10:05:06 +01:00
zend_cpuinfo.c
zend_cpuinfo.h Fix warnings of strict-prototypes 2020-07-23 00:59:00 +08:00
zend_default_classes.c Add Attributes 2020-06-04 18:19:49 +02:00
zend_dtrace.c Introduce error notification callbacks that are run independant of zend_error_cb 2020-07-17 15:08:11 +02:00
zend_dtrace.d
zend_dtrace.h Introduce error notification callbacks that are run independant of zend_error_cb 2020-07-17 15:08:11 +02:00
zend_errors.h Use clean shutdown on uncaught exception 2019-10-11 12:41:15 +02:00
zend_exceptions_arginfo.h Include stub hash in generated arginfo files 2020-06-24 09:55:19 +02:00
zend_exceptions.c Fixed bug #79948 2020-08-10 11:15:16 +02:00
zend_exceptions.h Accept zend_object* in zend_get_exception_base 2020-08-07 16:40:27 +02:00
zend_exceptions.stub.php Ensure Exception::getFile/getLine return type is correct 2020-05-28 14:19:47 +02:00
zend_execute_API.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_execute.c Merge branch 'PHP-7.4' 2020-08-10 10:13:34 +02:00
zend_execute.h Implement named parameters 2020-07-31 15:53:36 +02:00
zend_extensions.c
zend_extensions.h Update API version numbers 2020-08-04 22:25:28 +02: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 Change GC_COLLECTABLE flag into GC_NOT_COLLECTABLE to simplify GC_MAY_LEAK() check 2020-06-15 14:26:22 +03:00
zend_gc.h Change GC_COLLECTABLE flag into GC_NOT_COLLECTABLE to simplify GC_MAY_LEAK() check 2020-06-15 14:26:22 +03:00
zend_gdb.c
zend_gdb.h
zend_generators_arginfo.h Include stub hash in generated arginfo files 2020-06-24 09:55:19 +02:00
zend_generators.c Fixed bug #79927 2020-08-11 15:48:40 +02:00
zend_generators.h Remove generator iterator member 2020-06-30 18:26:29 +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 [RFC] Make string length for getTraceAsString() configurable 2020-07-25 09:50:57 -04:00
zend_hash.c Merge branch 'PHP-7.4' 2020-07-07 12:00:34 +02:00
zend_hash.h Don't leak attributes on internal classes 2020-06-05 10:29:49 +02:00
zend_highlight.c
zend_highlight.h
zend_inheritance.c Add common code for magic method assignment 2020-07-20 14:57:10 +02:00
zend_inheritance.h
zend_ini_parser.y Remove proto comments from C files 2020-07-06 21:13:34 +02:00
zend_ini_scanner.h
zend_ini_scanner.l Implement 'Saner Numeric Strings' RFC: 2020-07-29 02:51:09 +01:00
zend_ini.c Merge branch 'PHP-7.4' 2020-07-09 09:51:15 +01:00
zend_ini.h Add macro to get ini target address 2020-04-27 10:30:00 +02:00
zend_interfaces_arginfo.h Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_interfaces.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_interfaces.h Introduce InternalIterator 2020-06-24 15:31:41 +02:00
zend_interfaces.stub.php Add a few missing parameter types in stubs 2020-07-30 14:26:45 +02:00
zend_istdiostream.h
zend_iterators.c Add get_gc handle for object iterators 2020-07-01 15:17:22 +02:00
zend_iterators.h Add get_gc handle for object iterators 2020-07-01 15:17:22 +02:00
zend_language_parser.y Implement named parameters 2020-07-31 15:53:36 +02:00
zend_language_scanner.h Forbid use of <?= as a semi-reserved identifier 2020-06-19 09:29:58 +02:00
zend_language_scanner.l Fix ?-> in encaps vars without braces 2020-08-11 21:16:44 +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 Fix MSVC level 1 (severe) warnings 2020-06-05 11:17:05 +02:00
zend_llist.h Fix MSVC level 1 (severe) warnings 2020-06-05 11:17:05 +02:00
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 Update API version numbers 2020-08-04 22:25:28 +02:00
zend_multibyte.c
zend_multibyte.h
zend_multiply.h
zend_object_handlers.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_object_handlers.h Make cast_object handler required 2020-03-31 14:37:49 +02:00
zend_objects_API.c
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 Review the usage of apostrophes in error messages 2020-07-10 21:05:28 +02:00
zend_objects.h
zend_opcode.c Implement nullsafe ?-> operator 2020-07-24 10:05:03 +02:00
zend_operators.c Implement 'Saner Numeric Strings' RFC: 2020-07-29 02:51:09 +01:00
zend_operators.h Implement 'Saner Numeric Strings' RFC: 2020-07-29 02:51:09 +01:00
zend_portability.h Assume offsetof() exists 2020-06-30 15:55:50 +02:00
zend_ptr_stack.c
zend_ptr_stack.h
zend_range_check.h
zend_signal.c Remove proto comments from C files 2020-07-06 21:13:34 +02:00
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 Change GC_COLLECTABLE flag into GC_NOT_COLLECTABLE to simplify GC_MAY_LEAK() check 2020-06-15 14:26:22 +03: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 MAY_BE_INDIRECT inference 2020-06-18 18:54:32 +03:00
zend_types.h Add ZVAL_OBJ_COPY macro 2020-06-17 16:36:56 +02:00
zend_variables.c
zend_variables.h
zend_virtual_cwd.c Merge branch 'PHP-7.4' 2020-07-28 14:02:25 +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 Fix nullsafe operator on reference 2020-08-11 15:11:36 +02:00
zend_vm_execute.h SAVE_OPLINE in NULL_HANDLER 2020-08-11 15:14:50 +02:00
zend_vm_execute.skl Fix several mostly Windows related phpdbg bugs 2020-05-26 17:45:25 +02:00
zend_vm_gen.php SAVE_OPLINE in NULL_HANDLER 2020-08-11 15:14:50 +02:00
zend_vm_handlers.h Implement named parameters 2020-07-31 15:53:36 +02:00
zend_vm_opcodes.c Implement named parameters 2020-07-31 15:53:36 +02:00
zend_vm_opcodes.h Implement named parameters 2020-07-31 15:53:36 +02:00
zend_vm_trace_handlers.h
zend_vm_trace_lines.h A helper to trace executed source lines 2020-06-10 00:13:39 +03:00
zend_vm_trace_map.h Fixed typecast 2020-05-22 12:36:52 +03:00
zend_vm.h
zend_weakrefs_arginfo.h Fix WeakReference::create() stub 2020-07-16 20:46:45 +02:00
zend_weakrefs.c Fix warnings of strict-prototypes 2020-07-23 00:59:00 +08:00
zend_weakrefs.h Fix warnings of strict-prototypes 2020-07-23 00:59:00 +08:00
zend_weakrefs.stub.php Fix WeakReference::create() stub 2020-07-16 20:46:45 +02:00
zend.c Fixed bug #79948 2020-08-10 11:15:16 +02:00
zend.h Revert "Prepare for PHP 8.1" 2020-08-04 22:24:44 +02:00
Zend.m4 Clean up some unused code (and fix some comments) in build scripts 2020-06-19 22:04:52 +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