php-src/Zend
2005-02-11 22:26:45 +00:00
..
RFCs this one is declined 2004-01-09 18:55:49 +00:00
tests Fixed bug #30407 (Strange behaviour of default arguments) 2005-02-10 11:45:24 +00:00
acconfig.h explicitly including sys/select.h as NetWare LibC sys/types.h does not include sys/select.h implicitly as other LibC 2004-10-08 07:43:41 +00:00
acinclude.m4 - Added AC_ZEND_C_BIGENDIAN macro (as requested by Andi) 2005-01-10 01:33:29 +00:00
bench.php - Move bench.php to Zend/ 2004-09-29 17:08:46 +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-02-11 01:37:02 +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 - Added missing header sections. 2005-01-10 14:57:36 +00:00
LICENSE Bump year. 2002-12-31 15:59:15 +00:00
Makefile.am - Add entry for zend_strtod.c in belief that this is still active. 2004-11-04 00:13:08 +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 --without-lines changed to --with-lines 2004-10-28 06:48:59 +00:00
zend_alloc.c - Fix leak report for 0 byte allocations (Dmitry) 2004-08-27 16:49:14 +00:00
zend_alloc.h - Added missing defines. 2004-08-11 06:11:07 +00:00
zend_API.c added some missing zend_[declare|update]_property_...() convenience 2005-02-04 20:24:21 +00:00
zend_API.h added some missing zend_[declare|update]_property_...() convenience 2005-02-04 20:24:21 +00:00
zend_arg_defs.c - Added missing header sections. 2005-01-10 14:57:36 +00:00
zend_builtin_functions.c Fix debug_trace with eval (patch from Antony Dovgal) 2005-02-01 19:05:56 +00:00
zend_builtin_functions.h wrap ZEND_API prototypes into BEGIN_EXTERN_C/END_EXTERN_C 2004-02-18 22:44:40 +00:00
ZEND_CHANGES Add some information about array overloading 2004-08-30 18:48:52 +00:00
zend_compile.c - Cleanup foreach handling 2005-02-11 22:26:45 +00:00
zend_compile.h - Cleanup foreach handling 2005-02-11 22:26:45 +00:00
zend_config.nw.h explicitly including sys/select.h as NetWare LibC sys/types.h does not include sys/select.h implicitly as other LibC 2004-10-08 07:43:41 +00:00
zend_config.w32.h - Windows support strcoll too. 2004-09-15 12:28:55 +00:00
zend_constants.c - Revert the weird change of ZEND_STRS() macro and use the correct 2005-01-20 02:02:09 +00:00
zend_constants.h - Fixed a 64bit issue (for zend_builtin_functions.c, module_number is an int). 2004-03-04 11:02:05 +00:00
zend_default_classes.c Centralize exceptions code in zend_exceptions.[ch]. 2004-02-12 10:38:14 +00:00
zend_dynamic_array.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_dynamic_array.h - Fix prototype 2004-07-15 19:41:22 +00:00
zend_errors.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_exceptions.c Fixed bug #30904 (segfault when recording soapclient into session). 2004-12-07 07:46:12 +00:00
zend_exceptions.h - Add new class ErrorException to encapsulate errors in exceptions 2004-07-15 22:21:36 +00:00
zend_execute_API.c Fix #31720 Invalid object callbacks not caught in array_walk() (patch from Antony Dovgal) 2005-02-02 10:36:02 +00:00
zend_execute.c - Two new API calls for Derick (retreive CV name and value) by Dmitry 2005-01-22 02:29:18 +00:00
zend_execute.h - Two new API calls for Derick (retreive CV name and value) by Dmitry 2005-01-22 02:29:18 +00:00
zend_extensions.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_extensions.h - Bump API version 2004-10-30 19:27:42 +00:00
zend_fast_cache.h - Improve performance by inlining zend_ptr_stack_n_push(). var_args can 2004-07-30 20:16:40 +00:00
zend_globals_macros.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_globals.h - Fixed bug #30630: Added a BSD based strtod function that is 2004-11-03 23:13:32 +00:00
zend_hash.c - Increase performance of *sort() and some internal sort operations. 2004-07-29 19:18:46 +00:00
zend_hash.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_highlight.c Fixed bug #31371 (highlight_file() trims new line after heredoc). 2005-01-02 23:53:43 +00:00
zend_highlight.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_indent.c - Fixed bug #28930 (PHP sources pick wrong header files generated by bison) 2004-12-30 15:18:24 +00:00
zend_indent.h wrap ZEND_API prototypes into BEGIN_EXTERN_C/END_EXTERN_C 2004-02-18 22:44:40 +00:00
zend_ini_parser.y - Fix memleak 2005-01-19 00:55:56 +00:00
zend_ini_scanner.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_ini_scanner.l Correct fix for #28804 2005-02-06 23:51:59 +00:00
zend_ini.c - Fixed bug #30630: Added a BSD based strtod function that is 2004-11-03 23:13:32 +00:00
zend_ini.h export INI parser 2004-07-19 16:32:24 +00:00
zend_interfaces.c - Bugfix #26229 (getIterator() segfaults when it returns arrays or scalars) 2005-01-25 10:40:51 +00:00
zend_interfaces.h - no unneccessary retval initialization 2004-04-27 15:38:07 +00:00
zend_istdiostream.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_iterators.c Add count_elements handler for overloaded objects. 2004-05-04 15:03:28 +00:00
zend_iterators.h - no unneccessary retval initialization 2004-04-27 15:38:07 +00:00
zend_language_parser.y - Cleanup foreach handling 2005-02-11 22:26:45 +00:00
zend_language_scanner.h Nuke compile warning by using the LANG_SCNG macro instead 2004-01-17 00:26:12 +00:00
zend_language_scanner.l - Fixed bug #31444 (Memory leak in zend_language_scanner.c) 2005-01-17 17:20:56 +00:00
zend_list.c MFB: - Fix bug #26753 (zend_fetch_list_dtor_id() does not check NULL strings) 2004-02-17 22:04:05 +00:00
zend_list.h Change FETCH_RESOURCE to return false on error instead of null, for 2004-02-11 11:52:33 +00:00
zend_llist.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_llist.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_mm.c Handle out of memory/bad size situation gracefully, without getting into loop 2004-03-04 09:18:05 +00:00
zend_mm.h - Disable zend_mm for 5.0.0 2004-07-05 17:06:41 +00:00
zend_modules.h - Bump API version 2004-10-30 19:27:42 +00:00
zend_multibyte.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_multibyte.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_multiply.h Readd x86 implementation 2004-03-17 22:23:15 +00:00
zend_object_handlers.c Fixed bugs #29767 and #31683 (__get and __set methods must not modify property name). 2005-02-02 07:19:22 +00:00
zend_object_handlers.h - Change zend_object_handlers->get_method() to allow aggregation for internal classes 2004-10-30 19:11:37 +00:00
zend_objects_API.c fix crash when dtor is fialing on shutdown 2004-09-17 10:13:52 +00:00
zend_objects_API.h fix crash when dtor is fialing on shutdown 2004-09-17 10:13:52 +00:00
zend_objects.c Simplify/Optmize magic method calls (__get/__set/__call/__clone/__destruct) 2004-09-28 22:55:22 +00:00
zend_objects.h wrap ZEND_API prototypes into BEGIN_EXTERN_C/END_EXTERN_C 2004-02-18 22:44:40 +00:00
zend_opcode.c - Commit the variable fetch optimization. 2004-10-04 19:54:35 +00:00
zend_operators.c - Added "G" modifier to ini setting number format. 2004-12-13 09:09:06 +00:00
zend_operators.h Fixed bug #30726 (-.1 like numbers are not being handled correctly). 2005-01-18 00:29:43 +00:00
zend_ptr_stack.c - More ptr_stack optimizations and cleanups 2004-07-30 21:00:37 +00:00
zend_ptr_stack.h - More ptr_stack optimizations and cleanups 2004-07-30 21:00:37 +00:00
zend_qsort.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_qsort.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_reflection_api.c - Add ReclectionClass:hasProperty(), ReflectionClass::hasConstant() 2005-01-31 22:56:01 +00:00
zend_reflection_api.h - publish reflection_class_factory() as zend_reflection_class_factory() 2004-09-28 19:06:15 +00:00
zend_sprintf.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_stack.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_stack.h wrap ZEND_API prototypes into BEGIN_EXTERN_C/END_EXTERN_C 2004-02-18 22:44:40 +00:00
zend_static_allocator.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_static_allocator.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_stream.c - Fix warning 2004-09-27 09:03:40 +00:00
zend_stream.h export zend stream functions for zend extensions under windows 2004-06-25 12:55:11 +00:00
zend_strtod.c - Fixed bug #31920 (zend_strtod.c error: conflicting types for 'int8_t') 2005-02-10 22:19:32 +00:00
zend_strtod.h Make zend_strtod compile on windows 2004-11-04 02:04:39 +00:00
zend_ts_hash.c - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_ts_hash.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_types.h - Happy new year and PHP 5 for rest of the files too.. 2004-01-08 17:33:29 +00:00
zend_variables.c - Use zval_ctor_func() for wrapper and update the prototype to void 2004-09-27 07:04:36 +00:00
zend_variables.h - Use zval_ctor_func() for wrapper and update the prototype to void 2004-09-27 07:04:36 +00:00
zend_vm_def.h Fixed bug #30407 (Strange behaviour of default arguments) 2005-02-10 11:45:24 +00:00
zend_vm_execute.h Fixed bug #30407 (Strange behaviour of default arguments) 2005-02-10 11:45:24 +00:00
zend_vm_execute.skl - Fix typo 2004-10-28 01:19:33 +00:00
zend_vm_gen.php - Added missing header sections. 2005-01-10 14:57:36 +00:00
zend_vm_opcodes.h - Added missing header sections. 2005-01-10 14:57:36 +00:00
zend_vm.h - Commit new VM 2004-10-22 21:42:14 +00:00
zend.c MFB: - Rationalize code a bit 2005-01-09 16:18:39 +00:00
Zend.dsp Added zend_strtod.* to the build 2004-11-04 02:05:36 +00:00
zend.h Fixed bugs #29767 and #31683 (__get and __set methods must not modify property name). 2005-02-02 07:19:22 +00:00
zend.ico Zend Library 1999-04-07 18:10:10 +00:00
Zend.m4 - Compile fix for systems without uint32_t typedef 2005-01-22 20:28:17 +00:00
ZendCore.dep - Rename modules.h to zend_modules.h 2001-02-26 18:18:34 +00:00
ZendTS.dsp Added zend_strtod.* to the build 2004-11-04 02:05:36 +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().