Name Date Size #Lines LOC

..06-Dec-2019-

RFCs/H05-Dec-2019-

tests/H05-Dec-2019-

LICENSEH A D05-Dec-20192.7 KiB5747

Makefile.amH A D05-Dec-20192.3 KiB5634

Makefile.fragH A D05-Dec-201978 21

OBJECTS2_HOWTOH A D05-Dec-20197.1 KiB196142

README.ZEND_MMH A D05-Dec-20191.3 KiB4429

README.ZEND_VMH A D05-Dec-20194 KiB10893

ZEND_CHANGESH A D05-Dec-201936.3 KiB1,167898

Zend.m4H A D05-Dec-201910.7 KiB469401

ZendCore.depH A D05-Dec-20195.2 KiB259213

acinclude.m4H A D05-Dec-20196.5 KiB231210

bench.phpH A D05-Dec-20197.3 KiB423347

build.mkH A D05-Dec-2019858 4421

buildconfH A D05-Dec-2019675 3325

configure.inH A D05-Dec-20193.3 KiB150121

headerH A D05-Dec-20191.1 KiB2018

micro_bench.phpH A D05-Dec-20196.4 KiB359307

zend.cH A D05-Dec-201943.3 KiB1,5381,222

zend.hH A D05-Dec-201912.1 KiB335241

zend.icoH A D05-Dec-20191.3 KiB

zend_API.cH A D05-Dec-2019124.4 KiB4,2543,434

zend_API.hH A D05-Dec-201955.5 KiB1,267978

zend_alloc.cH A D05-Dec-201984.5 KiB2,8682,383

zend_alloc.hH A D05-Dec-201918.8 KiB413232

zend_alloc_sizes.hH A D05-Dec-20192.6 KiB6541

zend_arena.hH A D05-Dec-20193.7 KiB12477

zend_ast.cH A D05-Dec-201948.6 KiB1,7341,559

zend_ast.hH A D05-Dec-20198.1 KiB278213

zend_bitset.hH A D05-Dec-20196.7 KiB257186

zend_build.hH A D05-Dec-20191.6 KiB4721

zend_builtin_functions.cH A D05-Dec-201979.7 KiB2,8902,234

zend_builtin_functions.hH A D05-Dec-20191.6 KiB407

zend_closures.cH A D05-Dec-201924.5 KiB746542

zend_closures.hH A D05-Dec-20192 KiB4913

zend_compile.cH A D05-Dec-2019240.6 KiB8,3616,647

zend_compile.hH A D05-Dec-201932.5 KiB1,046698

zend_config.nw.hH A D05-Dec-20192.4 KiB9024

zend_config.w32.hH A D05-Dec-20192.7 KiB9446

zend_constants.cH A D05-Dec-201916.7 KiB540425

zend_constants.hH A D05-Dec-20195.9 KiB9454

zend_default_classes.cH A D05-Dec-20191.7 KiB4715

zend_dtrace.cH A D05-Dec-20194 KiB11772

zend_dtrace.dH A D05-Dec-20192.1 KiB3813

zend_dtrace.hH A D05-Dec-20191.9 KiB4921

zend_errors.hH A D05-Dec-20192.1 KiB5320

zend_exceptions.cH A D05-Dec-201934.1 KiB1,081807

zend_exceptions.hH A D05-Dec-20193.8 KiB8632

zend_execute.cH A D05-Dec-201990.6 KiB3,0692,593

zend_execute.hH A D05-Dec-201913.9 KiB381282

zend_execute_API.cH A D05-Dec-201948.8 KiB1,7581,379

zend_extensions.cH A D05-Dec-20199.8 KiB331247

zend_extensions.hH A D05-Dec-20195.9 KiB16382

zend_float.cH A D05-Dec-20191.8 KiB5930

zend_float.hH A D05-Dec-201915.2 KiB421259

zend_gc.cH A D05-Dec-201929.8 KiB1,2321,014

zend_gc.hH A D05-Dec-20194.8 KiB162107

zend_generators.cH A D05-Dec-201938.2 KiB1,302929

zend_generators.hH A D05-Dec-20197.3 KiB14767

zend_globals.hH A D05-Dec-20197.1 KiB308183

zend_globals_macros.hH A D05-Dec-20192.7 KiB8036

zend_hash.cH A D05-Dec-201963.2 KiB2,4902,126

zend_hash.hH A D05-Dec-201932.2 KiB1,031794

zend_highlight.cH A D05-Dec-20195.9 KiB243187

zend_highlight.hH A D05-Dec-20192.3 KiB6124

zend_inheritance.cH A D05-Dec-201961.8 KiB1,7521,384

zend_inheritance.hH A D05-Dec-20191.9 KiB4913

zend_ini.cH A D05-Dec-201919 KiB754560

zend_ini.hH A D05-Dec-20199.4 KiB202135

zend_ini_parser.yH A D05-Dec-201911.5 KiB423312

zend_ini_scanner.cH A D05-Dec-201988.6 KiB3,9343,749

zend_ini_scanner.hH A D05-Dec-20191.9 KiB4814

zend_ini_scanner.lH A D05-Dec-201916.6 KiB663433

zend_ini_scanner_defs.hH A D05-Dec-2019224 1411

zend_interfaces.cH A D05-Dec-201917.4 KiB572414

zend_interfaces.hH A D05-Dec-20194.2 KiB9246

zend_istdiostream.hH A D05-Dec-20191.6 KiB4513

zend_iterators.cH A D05-Dec-20193 KiB10767

zend_iterators.hH A D05-Dec-20193.5 KiB9231

zend_language_parser.yH A D05-Dec-201947.1 KiB1,3741,160

zend_language_scanner.cH A D05-Dec-2019177.7 KiB7,7887,436

zend_language_scanner.hH A D05-Dec-20192.7 KiB8540

zend_language_scanner.lH A D05-Dec-201955.5 KiB2,3971,859

zend_language_scanner_defs.hH A D05-Dec-2019296 1613

zend_list.cH A D05-Dec-20198.5 KiB347255

zend_list.hH A D05-Dec-20193.2 KiB8438

zend_llist.cH A D05-Dec-20196.8 KiB320227

zend_llist.hH A D05-Dec-20193.8 KiB8747

zend_long.hH A D05-Dec-20194.3 KiB14198

zend_modules.hH A D05-Dec-20194.8 KiB14291

zend_multibyte.cH A D05-Dec-20197.3 KiB224159

zend_multibyte.hH A D05-Dec-20194.9 KiB9145

zend_multiply.hH A D05-Dec-20198.3 KiB303225

zend_object_handlers.cH A D05-Dec-201952.6 KiB1,7881,409

zend_object_handlers.hH A D05-Dec-20199.2 KiB20492

zend_objects.cH A D05-Dec-20198.1 KiB267199

zend_objects.hH A D05-Dec-20191.8 KiB4512

zend_objects_API.cH A D05-Dec-20197 KiB233159

zend_objects_API.hH A D05-Dec-20193.5 KiB10048

zend_opcode.cH A D05-Dec-201921.6 KiB760637

zend_operators.cH A D05-Dec-201976.8 KiB3,1322,615

zend_operators.hH A D05-Dec-201928.5 KiB853702

zend_portability.hH A D05-Dec-201913.4 KiB467359

zend_ptr_stack.cH A D05-Dec-20192.9 KiB12071

zend_ptr_stack.hH A D05-Dec-20194.2 KiB12876

zend_range_check.hH A D05-Dec-20193 KiB7632

zend_signal.cH A D05-Dec-201912.5 KiB449309

zend_signal.hH A D05-Dec-20194 KiB12372

zend_smart_str.cH A D05-Dec-20193.7 KiB12089

zend_smart_str.hH A D05-Dec-20194.5 KiB12388

zend_smart_str_public.hH A D05-Dec-20191.2 KiB287

zend_sort.cH A D05-Dec-201910.7 KiB386244

zend_sort.hH A D05-Dec-20191.7 KiB408

zend_sprintf.cH A D05-Dec-20191.6 KiB5116

zend_stack.cH A D05-Dec-20194 KiB175118

zend_stack.hH A D05-Dec-20192.4 KiB6024

zend_stream.cH A D05-Dec-201910.6 KiB357281

zend_stream.hH A D05-Dec-20193.2 KiB10164

zend_string.cH A D05-Dec-20197.6 KiB253187

zend_string.hH A D05-Dec-201913.5 KiB433305

zend_strtod.cH A D05-Dec-201990.4 KiB4,5543,916

zend_strtod.hH A D05-Dec-20191.8 KiB3914

zend_strtod_int.hH A D05-Dec-20193.4 KiB14895

zend_ts_hash.cH A D05-Dec-20198.6 KiB376274

zend_ts_hash.hH A D05-Dec-20196.5 KiB15789

zend_type_info.hH A D05-Dec-20193.1 KiB6933

zend_types.hH A D05-Dec-201931.5 KiB1,024798

zend_variables.cH A D05-Dec-20195.5 KiB222163

zend_variables.hH A D05-Dec-20195.3 KiB148101

zend_virtual_cwd.cH A D05-Dec-201950.1 KiB2,0871,673

zend_virtual_cwd.hH A D05-Dec-201912.5 KiB382289

zend_vm.hH A D05-Dec-20191.7 KiB3812

zend_vm_def.hH A D05-Dec-2019250 KiB8,7247,543

zend_vm_execute.hH A D05-Dec-20191.9 MiB62,99954,009

zend_vm_execute.sklH A D05-Dec-20192.1 KiB8567

zend_vm_gen.phpH A D05-Dec-201991 KiB2,5722,252

zend_vm_opcodes.cH A D05-Dec-20197.8 KiB410386

zend_vm_opcodes.hH A D05-Dec-201911.9 KiB259230

README.ZEND_MM

1Zend Memory Manager
2===================
3
4General:
5--------
6
7The goal of the new memory manager (available since PHP 5.2) is to reduce memory
8allocation overhead and speedup memory management.
9
10The new manager's "configure" has no "--disable-zend-memory-manager" option,
11but it has "--enable-malloc-mm" instead.  It is enabled by default in DEBUG
12build and disabled by default in RELEASE build. When enabled it allows selecting
13between malloc and emalloc at runtime so you can use internal and external memory
14debuggers without recompilation.
15
16Debugging:
17----------
18
19Normal:
20
21    $ sapi/cli/php -r 'leak();'
22
23Zend MM disabled:
24
25    $ USE_ZEND_ALLOC=0 valgrind --leak-check=full sapi/cli/php -r 'leak();'
26
27Shared extensions:
28------------------
29
30Since PHP 5.3.11 it is possible to prevent shared extensions from unloading so
31that valgrind can correctly track the memory leaks in shared extensions. For
32this there is the ZEND_DONT_UNLOAD_MODULES environment variable. If set, then
33DL_UNLOAD() is skipped during the shutdown of shared extensions.
34
35
36Tweaking:
37---------
38
39The Zend MM can be tweaked using ZEND_MM_MEM_TYPE and ZEND_MM_SEG_SIZE environment
40variables.  Default values are "malloc" and "256K". Dependent on target system you
41can also use "mmap_anon", "mmap_zero" and "win32" storage managers.
42
43	$ ZEND_MM_MEM_TYPE=mmap_anon ZEND_MM_SEG_SIZE=1M sapi/cli/php ..etc.
44

README.ZEND_VM

1ZEND_VM
2=======
3
4ZEND_VM architecture allows specializing opcode handlers according to op_type
5fields and using different execution methods (call threading, switch threading
6and direct threading). As a result ZE2 got more than 20% speedup on raw PHP
7code execution (with specialized executor and direct threading execution
8method). As in most PHP applications raw execution speed isn't the limiting
9factor but system calls and database calls are, your mileage with this patch
10will vary.
11
12Most parts of the old zend_execute.c go into zend_vm_def.h. Here you can
13find opcode handlers and helpers. The typical opcode handler template looks
14like this:
15
16ZEND_VM_HANDLER(<OPCODE-NUMBER>, <OPCODE>, <OP1_TYPES>, <OP2_TYPES>)
17{
18	<HANDLER'S CODE>
19}
20
21<OPCODE-NUMBER> is a opcode number (0, 1, ...)
22<OPCODE> is an opcode name (ZEN_NOP, ZEND_ADD, :)
23<OP1_TYPES> & <OP2_TYPES> are masks for allowed operand op_types. Specializer
24will generate code only for defined combination of types. You can use any
25combination of the following op_types UNUSED, CONST, VAR, TMP and  CV also
26you can use ANY mask to disable specialization according operand's op_type.
27<HANDLER'S CODE> is a handler's code itself. For most handlers it stills the
28same as in old zend_execute.c, but now it uses macros to access opcode operands
29and some internal executor data.
30
31You can see the conformity of new macros to old code in the following list:
32
33EXECUTE_DATA
34	execute_data
35ZEND_VM_DISPATCH_TO_HANDLER(<OP>)
36	return <OP>_helper(ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
37ZEND_VM_DISPATCH_TO_HELPER(<NAME>)
38	return <NAME>(ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
39ZEND_VM_DISPATCH_TO_HELPER_EX(<NAME>,<PARAM>,<VAL>)
40	return <NAME>(<VAL>, ZEND_OPCODE_HANDLER_ARGS_PASSTHRU)
41ZEND_VM_CONTINUE()
42	return 0
43ZEND_VM_NEXT_OPCODE()
44	NEXT_OPCODE()
45ZEND_VM_SET_OPCODE(<TARGET>
46	SET_OPCODE(<TARGET>
47ZEND_VM_INC_OPCODE()
48	INC_OPCOD()
49ZEND_VM_RETURN_FROM_EXECUTE_LOOP()
50	RETURN_FROM_EXECUTE_LOOP()
51ZEND_VM_C_LABEL(<LABEL>):
52	<LABEL>:
53ZEND_VM_C_GOTO(<LABEL>)
54	goto <LABEL>
55OP<X>_TYPE
56	opline->op<X>.op_type
57GET_OP<X>_ZVAL_PTR(<TYPE>)
58	get_zval_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
59GET_OP<X>_ZVAL_PTR_PTR(<TYPE>)
60	get_zval_ptr_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
61GET_OP<X>_OBJ_ZVAL_PTR(<TYPE>)
62	get_obj_zval_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
63GET_OP<X>_OBJ_ZVAL_PTR_PTR(<TYPE>)
64	get_obj_zval_ptr_ptr(&opline->op<X>, EX(Ts), &free_op<X>, <TYPE>)
65IS_OP<X>_TMP_FREE()
66	IS_TMP_FREE(free_op<X>)
67FREE_OP<X>()
68	FREE_OP(free_op<X>)
69FREE_OP<X>_IF_VAR()
70	FREE_VAR(free_op<X>)
71FREE_OP<X>_VAR_PTR()
72	FREE_VAR_PTR(free_op<X>)
73
74
75Executor's helpers can be defined without parameters or with one parameter.
76This is done with the following constructs:
77
78ZEND_VM_HELPER(<HELPER-NAME>, <OP1_TYPES>, <OP2_TYPES>)
79{
80	<HELPER'S CODE>
81}
82
83ZEND_VM_HELPER_EX(<HELPER-NAME>, <OP1_TYPES>, <OP2_TYPES>, <PARAM_SPEC>)
84{
85	<HELPER'S CODE>
86}
87
88Executor's code is generated by PHP script zend_vm_gen.php it uses zend_vm_def.h
89and zend_vm_execute.skl as input and produces zend_vm_opcodes.h and
90zend_vm_execute.h. The first file is a list of opcode definitions. It is
91included from zend_compile.h. The second one is an executor code itself. It is
92included from zend_execute.c.
93
94zend_vm_gen.php can produce different kind of executors. You can select
95different opcode threading model using --with-vm-kind=CALL|SWITCH|GOTO. You can
96disable opcode specialization using --without-specializer. You can include or
97exclude old executor together with specialized one using --without-old-executor.
98At last you can debug executor using original zend_vm_def.h or generated file
99zend_vm_execute.h. Debugging with original file requires --with-lines
100option. By default ZE2 uses the following command to generate executor:
101
102$ php zend_vm_gen.php --with-vm-kind=CALL
103
104Zend Engine II currently includes two executors during the build process, one
105is the specialized version and the other is the old one non-specialized with
106function handlers. By default Zend Engine II uses the specialized one but you
107can switch to the old executor at runtime by calling zend_vm_use_old_executor().
108