php-src/Zend
2006-02-26 10:57:00 +00:00
..
RFCs this one is declined 2004-01-09 18:55:49 +00:00
tests fix leak in zend_strtod() on big doubles 2006-02-14 22:10:55 +00:00
acconfig.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
acinclude.m4 MFH: Allow bison 2.1. 2005-11-01 10:31:56 +00:00
bench.php Removed warnings 2005-08-02 12:11:55 +00:00
build.mk Add clean target which removes standard targets 1999-10-10 02:02:13 +00:00
buildconf Use libtool to build. 1999-10-04 15:20:12 +00:00
ChangeLog ChangeLog update 2005-08-06 05:37:51 +00:00
configure.in - Compile fix for systems without uint32_t typedef 2005-01-22 20:28:17 +00:00
flex.skl - added script encoding support to Zend Engine 2. 2003-08-11 05:24:42 +00:00
FlexLexer.h Replace macros which begin with an underscore through an appropiately 2000-07-03 00:55:36 +00:00
header - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
LICENSE - More -> 2006 changes 2006-01-05 02:34:02 +00:00
Makefile.am - MFH Move reflection to its own extension 2005-11-30 21:46:26 +00:00
Makefile.frag - Fix dependency 2005-01-25 10:39:49 +00:00
OBJECTS2_HOWTO - modifyable -> modifiable 2004-04-12 12:22:26 +00:00
README.ZEND_VM Nuked DOS EOLs 2005-08-03 13:29:00 +00:00
zend_alloc.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_alloc.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_API.c - MFH: Function deprecation flag 2006-02-25 18:25:45 +00:00
zend_API.h - MFH: Function deprecation flag 2006-02-25 18:25:45 +00:00
zend_arg_defs.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_builtin_functions.c MFH. 2006-02-07 00:33:13 +00:00
zend_builtin_functions.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
ZEND_CHANGES Add some information about array overloading 2004-08-30 18:48:52 +00:00
zend_compile.c Fix a bug where the default value for function argument could be an 2006-02-23 18:06:47 +00:00
zend_compile.h - MFH: Function deprecation flag 2006-02-25 18:25:45 +00:00
zend_config.nw.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_config.w32.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_constants.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_constants.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_default_classes.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_dynamic_array.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_dynamic_array.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_errors.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_exceptions.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_exceptions.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_execute_API.c - Warning fixes by Steph 2006-02-26 10:57:00 +00:00
zend_execute.c - Warning fixes by Steph 2006-02-26 10:57:00 +00:00
zend_execute.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_extensions.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_extensions.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_fast_cache.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_globals_macros.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_globals.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_hash.c init variables 2006-02-06 20:37:11 +00:00
zend_hash.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_highlight.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_highlight.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_indent.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_indent.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ini_parser.y - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ini_scanner.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ini_scanner.l Fixed bug #36046 (parse_ini_file() miscounts lines in multi-line values). 2006-01-17 19:56:25 +00:00
zend_ini.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ini.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_interfaces.c - Warning fixes by Steph 2006-02-26 10:57:00 +00:00
zend_interfaces.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_istdiostream.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_iterators.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_iterators.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_language_parser.y - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_language_scanner.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_language_scanner.l Fixed bug #36037 (heredoc adds extra line number) 2006-01-17 09:39:57 +00:00
zend_list.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_list.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_llist.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_llist.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_mm.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_mm.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_modules.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_multibyte.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_multibyte.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_multiply.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_object_handlers.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_object_handlers.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_objects_API.c Fixed bug #36006 (Problem with $this in __destruct()) 2006-01-16 10:12:36 +00:00
zend_objects_API.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_objects.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_objects.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_opcode.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_operators.c - MFH 2006-02-05 17:07:40 +00:00
zend_operators.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ptr_stack.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ptr_stack.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_qsort.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_qsort.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_sprintf.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_stack.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_stack.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_static_allocator.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_static_allocator.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_stream.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_stream.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_strtod.c fix leak in zend_strtod() on big doubles 2006-02-14 22:10:55 +00:00
zend_strtod.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ts_hash.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_ts_hash.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_types.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_variables.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_variables.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_vm_def.h - Warning fixes by Steph 2006-02-26 10:57:00 +00:00
zend_vm_execute.h - Warning fixes by Steph 2006-02-26 10:57:00 +00:00
zend_vm_execute.skl Fixed bug #35437 (Segfault or Invalid Opcode 137/1/4) 2005-12-01 12:50:58 +00:00
zend_vm_gen.php - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_vm_opcodes.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend_vm.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend.c - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
Zend.dsp - MFH Move reflection to its own extension 2005-11-30 21:46:26 +00:00
zend.h - Update copyright notices to 2006 2006-01-04 23:53:05 +00:00
zend.ico Zend Library 1999-04-07 18:10:10 +00:00
Zend.m4 reordered + added msg to configure output for PHP_ZEND_VM 2005-06-14 12:23:26 +00:00
ZendCore.dep - Rename modules.h to zend_modules.h 2001-02-26 18:18:34 +00:00
ZendTS.dsp - MFH Move reflection to its own extension 2005-11-30 21:46:26 +00:00

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 callls 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> & <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

Zend Engine II currently includes two executors during the build process, one
is the specialized version and the other is the old one non-specialized with
function handlers. By default Zend Engine II uses the specialized one but you
can switch to the old executor at runtime by calling zend_vm_use_old_executor().