text: /*
     +----------------------------------------------------------------------+
     | Zend Engine                                                          |
     +----------------------------------------------------------------------+
     | Copyright (c) 1998-2016 Zend Technologies Ltd. (http://www.zend.com) |
     +----------------------------------------------------------------------+
     | This source file is subject to version 2.00 of the Zend license,     |
     | that is bundled with this package in the file LICENSE, and is        |
     | available through the world-wide-web at the following url:           |
     | http://www.zend.com/license/2_00.txt.                                |
     | If you did not receive a copy of the Zend license and are unable to  |
     | obtain it through the world-wide-web, please send a note to          |
     | license@zend.com so we can mail you a copy immediately.              |
     +----------------------------------------------------------------------+
     | Authors: Andi Gutmans <andi@zend.com>                                |
     |          Zeev Suraski <zeev@zend.com>                                |
     +----------------------------------------------------------------------+
  */
  
  /* $Id$ */
  
  #ifndef ZEND_COMPILE_H
  #define ZEND_COMPILE_H
  
  #include "zend.h"
  #include "zend_ast.h"
  
  #ifdef HAVE_STDARG_H
  # include <stdarg.h>
  #endif
  
  #include "zend_llist.h"
  
  #define DEBUG_ZEND 0
  
  #define FREE_PNODE(znode)	zval_dtor(&znode->u.constant);
  
  #define SET_UNUSED(op)  op ## _type = IS_UNUSED
  
  #define INC_BPC(op_array)	if (op_array->fn_flags & ZEND_ACC_INTERACTIVE) { (CG(context).backpatch_count++); }
  #define DEC_BPC(op_array)	if (op_array->fn_flags & ZEND_ACC_INTERACTIVE) { (CG(context).backpatch_count--); }
  #define HANDLE_INTERACTIVE()  if (CG(active_op_array)->fn_flags & ZEND_ACC_INTERACTIVE) { execute_new_code(TSRMLS_C); }
  #define DO_TICKS()            if (Z_LVAL(CG(declarables).ticks)) { zend_do_ticks(TSRMLS_C); }
  
  #define RESET_DOC_COMMENT()        \
      {                              \
          if (CG(doc_comment)) {     \
            efree(CG(doc_comment));  \
            CG(doc_comment) = NULL;  \
          }                          \
          CG(doc_comment_len) = 0;   \
      }
  
  typedef struct _zend_op_array zend_op_array;
  typedef struct _zend_op zend_op;
  
  typedef struct _zend_compiler_context {
  	zend_uint  opcodes_size;
  	int        vars_size;
  	int        literals_size;
  	int        current_brk_cont;
  	int        backpatch_count;
  	int        nested_calls;
  	int        used_stack;
  	int        in_finally;
  	HashTable *labels;/* 用来保存goto的标记 */
  } zend_compiler_context;
  
  typedef struct _zend_literal {
  	zval       constant;
  	zend_ulong hash_value;
  	zend_uint  cache_slot;
  } zend_literal;
  
  #define Z_HASH_P(zv) \
  	(((zend_literal*)(zv))->hash_value)
  
  typedef union _znode_op {
  	zend_uint      constant;
  	zend_uint      var;
  	zend_uint      num;
  	zend_ulong     hash;
  	zend_uint      opline_num; /*  Needs to be signed */
  	zend_op       *jmp_addr;
  	zval          *zv;
  	zend_literal  *literal;
  	void          *ptr;        /* Used for passing pointers from the compile to execution phase, currently used for traits */
  } znode_op;
  
  typedef struct _znode { /* used only during compilation */
  	int op_type;
  	union {
  		znode_op op;
  		zval constant; /* replaced by literal/zv */
  		zend_op_array *op_array;
  		zend_ast *ast;
  	} u;
  	zend_uint EA;      /* extended attributes */
  } znode;
  
  typedef struct _zend_execute_data zend_execute_data;
  
  #define ZEND_OPCODE_HANDLER_ARGS zend_execute_data *execute_data TSRMLS_DC
  #define ZEND_OPCODE_HANDLER_ARGS_PASSTHRU execute_data TSRMLS_CC
  
  typedef int (*user_opcode_handler_t) (ZEND_OPCODE_HANDLER_ARGS);
  typedef int (ZEND_FASTCALL *opcode_handler_t) (ZEND_OPCODE_HANDLER_ARGS);
  
  extern ZEND_API opcode_handler_t *zend_opcode_handlers;
  
  struct _zend_op {
  	opcode_handler_t handler;
  	znode_op op1;
  	znode_op op2;
  	znode_op result;
  	ulong extended_value;
  	uint lineno;
  	zend_uchar opcode;
  	zend_uchar op1_type;
  	zend_uchar op2_type;
  	zend_uchar result_type;
  };
  
  
  typedef struct _zend_brk_cont_element {
  	int start;
  	int cont;
  	int brk;
  	int parent;
  } zend_brk_cont_element;
  
  typedef struct _zend_label {/* goto标签的结构 */
  	int brk_cont;
  	zend_uint opline_num;/* 标记opline的坐标,当goto的时候会移动到该坐标执行 */
  } zend_label;
  
  typedef struct _zend_try_catch_element {
  	zend_uint try_op;
  	zend_uint catch_op;  /* ketchup! */
  	zend_uint finally_op;
  	zend_uint finally_end;
  } zend_try_catch_element;
  
  #if SIZEOF_LONG == 8
  #define THIS_HASHVAL 210728972157UL
  #else
  #define THIS_HASHVAL 275574653UL
  #endif
  
  /* method flags (types) */
  #define ZEND_ACC_STATIC			0x01
  #define ZEND_ACC_ABSTRACT		0x02
  #define ZEND_ACC_FINAL			0x04
  #define ZEND_ACC_IMPLEMENTED_ABSTRACT		0x08
  
  /* class flags (types) */
  /* ZEND_ACC_IMPLICIT_ABSTRACT_CLASS is used for abstract classes (since it is set by any abstract method even interfaces MAY have it set, too). */
  /* ZEND_ACC_EXPLICIT_ABSTRACT_CLASS denotes that a class was explicitly defined as abstract by using the keyword. */
  #define ZEND_ACC_IMPLICIT_ABSTRACT_CLASS	0x10/* 内含抽象方法的类标记 如果类中含有abstract抽象方法则将类标记这个值 */
  #define ZEND_ACC_EXPLICIT_ABSTRACT_CLASS	0x20/* 明确为抽象类 如果类名前含有abstract则类会标记这个值 */
  #define ZEND_ACC_FINAL_CLASS	            0x40/* 如果类名前含有final则类会标记这个值 */
  #define ZEND_ACC_INTERFACE		            0x80/* 如果类为接口则类会标记这个值 */
  #define ZEND_ACC_TRAIT						0x120/* 如果类是trait则会标记这个值 */
  
  /* op_array flags */
  #define ZEND_ACC_INTERACTIVE				0x10
  
  /* method flags (visibility) */
  /* The order of those must be kept - public < protected < private */
  #define ZEND_ACC_PUBLIC		0x100
  #define ZEND_ACC_PROTECTED	0x200
  #define ZEND_ACC_PRIVATE	0x400
  #define ZEND_ACC_PPP_MASK  (ZEND_ACC_PUBLIC | ZEND_ACC_PROTECTED | ZEND_ACC_PRIVATE)
  
  #define ZEND_ACC_CHANGED	0x800
  #define ZEND_ACC_IMPLICIT_PUBLIC	0x1000
  
  /* method flags (special method detection) */
  #define ZEND_ACC_CTOR		0x2000
  #define ZEND_ACC_DTOR		0x4000
  #define ZEND_ACC_CLONE		0x8000
  
  /* method flag (bc only), any method that has this flag can be used statically and non statically. */
  #define ZEND_ACC_ALLOW_STATIC	0x10000
  
  /* shadow of parent's private method/property */
  #define ZEND_ACC_SHADOW 0x20000
  
  /* deprecation flag */
  #define ZEND_ACC_DEPRECATED 0x40000
  
  /* class implement interface(s) flag */
  #define ZEND_ACC_IMPLEMENT_INTERFACES 0x80000
  #define ZEND_ACC_IMPLEMENT_TRAITS	  0x400000
  
  /* class constants updated */
  #define ZEND_ACC_CONSTANTS_UPDATED	  0x100000
  
  /* user class has methods with static variables */
  #define ZEND_HAS_STATIC_IN_METHODS    0x800000
  
  
  #define ZEND_ACC_CLOSURE              0x100000
  #define ZEND_ACC_GENERATOR            0x800000
  
  /* function flag for internal user call handlers __call, __callstatic */
  #define ZEND_ACC_CALL_VIA_HANDLER     0x200000
  
  /* disable inline caching */
  #define ZEND_ACC_NEVER_CACHE          0x400000
  
  #define ZEND_ACC_VARIADIC				0x1000000
  
  #define ZEND_ACC_RETURN_REFERENCE		0x4000000 /* 引用函数标志 function &name(){} */
  #define ZEND_ACC_DONE_PASS_TWO			0x8000000
  
  /* function has arguments with type hinting */
  #define ZEND_ACC_HAS_TYPE_HINTS			0x10000000
  
  char *zend_visibility_string(zend_uint fn_flags);
  
  
  typedef struct _zend_property_info {/* 属性信息结构体 */
  	zend_uint flags;/* 属性类型或者可见性标志 */
  	const char *name;/* 属性名 */
  	int name_length;/* 属性名长度 */
  	ulong h;/* 属性名的hash值 */
  	int offset;
  	const char *doc_comment;/* 属性的注释 */
  	int doc_comment_len;
  	zend_class_entry *ce;/* 所属类的指针地址 */
  } zend_property_info;/* 属性信息结构体 */
  
  
  typedef struct _zend_arg_info { /* 函数或方法的参数结构体 */
  	const char *name;/* 参数名称值 */
  	zend_uint name_len;/* 参数名称值的长度 */
  	const char *class_name;/* 类名 */
  	zend_uint class_name_len;/* 类名长度 */
  	zend_uchar type_hint;/* 参数提示类型(无,IS_ARRAY,IS_CALLABLE,IS_OBJECT) */
  	zend_uchar pass_by_reference;/*　是否引用传递 */
  	zend_bool allow_null;/* 是否允许为NULL　*/
  	zend_bool is_variadic;/* 是否为变长参数 */
  } zend_arg_info;/* 函数或方法的参数结构体 */
  
  /* the following structure repeats the layout of zend_arg_info,
   * but its fields have different meaning. It's used as the first element of
   * arg_info array to define properties of internal functions.
   */
  typedef struct _zend_internal_function_info {
  	const char *_name;
  	zend_uint _name_len;
  	const char *_class_name;
  	zend_uint required_num_args;
  	zend_uchar _type_hint;
  	zend_bool return_reference;
  	zend_bool _allow_null;
  	zend_bool _is_variadic;
  } zend_internal_function_info;
  
  typedef struct _zend_compiled_variable {
  	const char *name;
  	int name_len;
  	ulong hash_value;
  } zend_compiled_variable;
  
  struct _zend_op_array {/* 用户自定义的函数，以及用户定义的类的方法，都是一个zend_op_array结构 */
  	/* Common elements */
  	zend_uchar type;
  	const char *function_name;/* 如果是全局代码或是eval部分的代码，那么此字段为空 */
  	zend_class_entry *scope;/* 如果是类方法的op_array 此值为所属类 否则为NULL */
  	zend_uint fn_flags;
  	union _zend_function *prototype;
  	zend_uint num_args;
  	zend_uint required_num_args;
  	zend_arg_info *arg_info;
  	/* END of common elements */
  
  	zend_uint *refcount;
  
  	zend_op *opcodes;/* 这是一个zend_op的数组，这个数组保存的就是此编译过程中生成的op */
  	zend_uint last;
  
  	zend_compiled_variable *vars;
  	int last_var;
  
  	zend_uint T;/* 临时变量数和临时变量的索引 这个值在zend_compile.c的get_temporary_variable()函数中获取和自增 */
  
  	zend_uint nested_calls;
  	zend_uint used_stack;
  
  	zend_brk_cont_element *brk_cont_array;
  	int last_brk_cont;
  
  	zend_try_catch_element *try_catch_array;
  	int last_try_catch;
  	zend_bool has_finally_block;
  
  	/* static variables support */
  	HashTable *static_variables;
  
  	zend_uint this_var;
  
  	const char *filename;
  	zend_uint line_start;
  	zend_uint line_end;
  	const char *doc_comment;
  	zend_uint doc_comment_len;
  	zend_uint early_binding; /* the linked list of delayed declarations */
  
  	zend_literal *literals;
  	int last_literal;
  
  	void **run_time_cache;
  	int  last_cache_slot;
  
  	void *reserved[ZEND_MAX_RESERVED_RESOURCES];
  };
  
  
  #define ZEND_RETURN_VALUE				0
  #define ZEND_RETURN_REFERENCE			1
  
  typedef struct _zend_internal_function {
  	/* Common elements */
  	zend_uchar type;
  	const char * function_name;
  	zend_class_entry *scope;
  	zend_uint fn_flags;
  	union _zend_function *prototype;
  	zend_uint num_args;
  	zend_uint required_num_args;
  	zend_arg_info *arg_info;
  	/* END of common elements */
  
  	void (*handler)(INTERNAL_FUNCTION_PARAMETERS);
  	struct _zend_module_entry *module;
  } zend_internal_function;
  
  #define ZEND_FN_SCOPE_NAME(function)  ((function) && (function)->common.scope ? (function)->common.scope->name : "")
  
  typedef union _zend_function {
  	zend_uchar type;	/* 函数类型 例如ZEND_USER_FUNCTION用户自定义的函数 MUST be the first element of this struct! */
  
  	struct {
  		zend_uchar type;  /* never used */
  		const char *function_name; /* 函数名称 */
  		zend_class_entry *scope; /* 函数所在的类作用域 */
  		zend_uint fn_flags; /* 作为方法时的访问类型等，如ZEND_ACC_STATIC等 */
  		union _zend_function *prototype; /* 函数原型 */
  		zend_uint num_args; /* 参数数目 */
  		zend_uint required_num_args; /* 需要的参数数目 */
  		zend_arg_info *arg_info; /* 参数信息指针 */
  	} common;
  
  	zend_op_array op_array; /* 函数中的操作 */
  	zend_internal_function internal_function;
  } zend_function;
  
  
  typedef struct _zend_function_state {
  	zend_function *function;
  	void **arguments;
  } zend_function_state;
  
  typedef struct _zend_function_call_entry {
  	zend_function *fbc;
  	zend_uint arg_num;
  	zend_bool uses_argument_unpacking;
  } zend_function_call_entry;
  
  typedef struct _zend_switch_entry {
  	znode cond;
  	int default_case;
  	int control_var;
  } zend_switch_entry;
  
  
  typedef struct _list_llist_element {
  	znode var;
  	zend_llist dimensions;
  	znode value;
  } list_llist_element;
  
  union _temp_variable;
  
  typedef struct _call_slot {
  	zend_function     *fbc;
  	zval              *object;
  	zend_class_entry  *called_scope;
  	zend_uint          num_additional_args;
  	zend_bool          is_ctor_call;
  	zend_bool          is_ctor_result_used;
  } call_slot;
  
  struct _zend_execute_data {
  	struct _zend_op *opline;
  	zend_function_state function_state;
  	zend_op_array *op_array;
  	zval *object;
  	HashTable *symbol_table;/* 全局符号表 保存了在顶层作用域中的变量 */
  	struct _zend_execute_data *prev_execute_data;
  	zval *old_error_reporting;
  	zend_bool nested;/* 是否嵌套 */
  	zval **original_return_value;
  	zend_class_entry *current_scope;
  	zend_class_entry *current_called_scope;
  	zval *current_this;
  	struct _zend_op *fast_ret; /* used by FAST_CALL/FAST_RET (finally keyword) */
  	zval *delayed_exception;
  	call_slot *call_slots;
  	call_slot *call;
  };
  
  #define EX(element) execute_data.element
  
  #define EX_TMP_VAR(ex, n)	   ((temp_variable*)(((char*)(ex)) + ((int)(n))))
  #define EX_TMP_VAR_NUM(ex, n)  (EX_TMP_VAR(ex, 0) - (1 + (n)))
  
  #define EX_CV_NUM(ex, n)       (((zval***)(((char*)(ex))+ZEND_MM_ALIGNED_SIZE(sizeof(zend_execute_data))))+(n))
  
  
  #define IS_CONST	(1<<0) /* 0  常量类型 例如 $a = 12345; 这里的12345就是常量类型 */
  #define IS_TMP_VAR	(1<<1) /* 2  临时变量 例如 $a = 1+2; 这里的1+2会产生一个临时变量然后赋值给$a */
  #define IS_VAR		(1<<2) /* 4  函数调用的中间变量 例如 $a = myfunction(); myfunction()会通过中间变量的结果传递给$a */
  #define IS_UNUSED	(1<<3) /* 8  未设置变量类型 有些opcode中op2不需要值 */
  #define IS_CV		(1<<4) /* 16 Compiled variable 编译变量类型 例如 $a = 123; $b = $a; 这里的$a,$b就是这种类型 */
  
  #define EXT_TYPE_UNUSED	(1<<5) /* 排除IS_UNUSED类型的类型 */
  
  #include "zend_globals.h"
  
  BEGIN_EXTERN_C()
  
  void init_compiler(TSRMLS_D);
  void shutdown_compiler(TSRMLS_D);
  void zend_init_compiler_data_structures(TSRMLS_D);
  void zend_init_compiler_context(TSRMLS_D);
  
  extern ZEND_API zend_op_array *(*zend_compile_file)(zend_file_handle *file_handle, int type TSRMLS_DC);
  extern ZEND_API zend_op_array *(*zend_compile_string)(zval *source_string, char *filename TSRMLS_DC);
  
  ZEND_API int lex_scan(zval *zendlval TSRMLS_DC);
  void startup_scanner(TSRMLS_D);
  void shutdown_scanner(TSRMLS_D);
  
  ZEND_API char *zend_set_compiled_filename(const char *new_compiled_filename TSRMLS_DC);
  ZEND_API void zend_restore_compiled_filename(char *original_compiled_filename TSRMLS_DC);
  ZEND_API char *zend_get_compiled_filename(TSRMLS_D);
  ZEND_API int zend_get_compiled_lineno(TSRMLS_D);
  ZEND_API size_t zend_get_scanned_file_offset(TSRMLS_D);
  
  void zend_resolve_non_class_name(znode *element_name, zend_bool *check_namespace, zend_bool case_sensitive, HashTable *current_import_sub TSRMLS_DC);
  void zend_resolve_function_name(znode *element_name, zend_bool *check_namespace TSRMLS_DC);
  void zend_resolve_const_name(znode *element_name, zend_bool *check_namespace TSRMLS_DC);
  void zend_resolve_class_name(znode *class_name TSRMLS_DC);
  ZEND_API const char* zend_get_compiled_variable_name(const zend_op_array *op_array, zend_uint var, int* name_len);
  
  #ifdef ZTS
  const char *zend_get_zendtext(TSRMLS_D);
  int zend_get_zendleng(TSRMLS_D);
  #endif
  
  
  /* parser-driven code generators */
  void zend_do_binary_op(zend_uchar op, znode *result, const znode *op1, const znode *op2 TSRMLS_DC);
  void zend_do_unary_op(zend_uchar op, znode *result, const znode *op1 TSRMLS_DC);
  void zend_do_binary_assign_op(zend_uchar op, znode *result, const znode *op1, const znode *op2 TSRMLS_DC);
  void zend_do_assign(znode *result, znode *variable, znode *value TSRMLS_DC);
  void zend_do_assign_ref(znode *result, const znode *lvar, const znode *rvar TSRMLS_DC);
  void fetch_simple_variable(znode *result, znode *varname, int bp TSRMLS_DC);
  void fetch_simple_variable_ex(znode *result, znode *varname, int bp, zend_uchar op TSRMLS_DC);
  void zend_do_indirect_references(znode *result, const znode *num_references, znode *variable TSRMLS_DC);
  void zend_do_fetch_static_variable(znode *varname, const znode *static_assignment, int fetch_type TSRMLS_DC);
  void zend_do_fetch_global_variable(znode *varname, const znode *static_assignment, int fetch_type TSRMLS_DC);
  
  void fetch_array_begin(znode *result, znode *varname, znode *first_dim TSRMLS_DC);
  void fetch_array_dim(znode *result, const znode *parent, const znode *dim TSRMLS_DC);
  void fetch_string_offset(znode *result, const znode *parent, const znode *offset TSRMLS_DC);
  void zend_do_fetch_static_member(znode *result, znode *class_znode TSRMLS_DC);
  void zend_do_print(znode *result, const znode *arg TSRMLS_DC);
  void zend_do_echo(const znode *arg TSRMLS_DC);
  typedef int (*unary_op_type)(zval *, zval * TSRMLS_DC);
  typedef int (*binary_op_type)(zval *, zval *, zval * TSRMLS_DC);
  ZEND_API unary_op_type get_unary_op(int opcode);
  ZEND_API binary_op_type get_binary_op(int opcode);
  
  void zend_do_while_cond(const znode *expr, znode *close_bracket_token TSRMLS_DC);
  void zend_do_while_end(const znode *while_token, const znode *close_bracket_token TSRMLS_DC);
  void zend_do_do_while_begin(TSRMLS_D);
  void zend_do_do_while_end(const znode *do_token, const znode *expr_open_bracket, const znode *expr TSRMLS_DC);
  
  
  void zend_do_if_cond(const znode *cond, znode *closing_bracket_token TSRMLS_DC);
  void zend_do_if_after_statement(const znode *closing_bracket_token, unsigned char initialize TSRMLS_DC);
  void zend_do_if_end(TSRMLS_D);
  
  void zend_do_for_cond(const znode *expr, znode *second_semicolon_token TSRMLS_DC);
  void zend_do_for_before_statement(const znode *cond_start, const znode *second_semicolon_token TSRMLS_DC);
  void zend_do_for_end(const znode *second_semicolon_token TSRMLS_DC);
  
  void zend_do_pre_incdec(znode *result, const znode *op1, zend_uchar op TSRMLS_DC);
  void zend_do_post_incdec(znode *result, const znode *op1, zend_uchar op TSRMLS_DC);
  
  void zend_do_begin_variable_parse(TSRMLS_D);
  void zend_do_end_variable_parse(znode *variable, int type, int arg_offset TSRMLS_DC);
  
  void zend_check_writable_variable(const znode *variable);
  
  void zend_do_free(znode *op1 TSRMLS_DC);
  
  void zend_do_add_string(znode *result, const znode *op1, znode *op2 TSRMLS_DC);
  void zend_do_add_variable(znode *result, const znode *op1, const znode *op2 TSRMLS_DC);
  
  int zend_do_verify_access_types(const znode *current_access_type, const znode *new_modifier);
  void zend_do_begin_function_declaration(znode *function_token, znode *function_name, int is_method, int return_reference, znode *fn_flags_znode TSRMLS_DC);
  void zend_do_end_function_declaration(const znode *function_token TSRMLS_DC);
  void zend_do_receive_param(zend_uchar op, znode *varname, const znode *initialization, znode *class_type, zend_bool pass_by_reference, zend_bool is_variadic TSRMLS_DC);
  int zend_do_begin_function_call(znode *function_name, zend_bool check_namespace TSRMLS_DC);
  void zend_do_begin_method_call(znode *left_bracket TSRMLS_DC);
  void zend_do_clone(znode *result, const znode *expr TSRMLS_DC);
  void zend_do_begin_dynamic_function_call(znode *function_name, int prefix_len TSRMLS_DC);
  void zend_do_fetch_class(znode *result, znode *class_name TSRMLS_DC);
  void zend_do_build_full_name(znode *result, znode *prefix, znode *name, int is_class_member TSRMLS_DC);
  int zend_do_begin_class_member_function_call(znode *class_name, znode *method_name TSRMLS_DC);
  void zend_do_end_function_call(znode *function_name, znode *result, int is_method, int is_dynamic_fcall TSRMLS_DC);
  void zend_do_return(znode *expr, int do_end_vparse TSRMLS_DC);
  void zend_do_yield(znode *result, znode *value, const znode *key, zend_bool is_variable TSRMLS_DC);
  void zend_do_handle_exception(TSRMLS_D);
  
  void zend_do_begin_lambda_function_declaration(znode *result, znode *function_token, int return_reference, int is_static TSRMLS_DC);
  void zend_do_fetch_lexical_variable(znode *varname, zend_bool is_ref TSRMLS_DC);
  
  void zend_do_try(znode *try_token TSRMLS_DC);
  void zend_do_begin_catch(znode *try_token, znode *catch_class, znode *catch_var, znode *first_catch TSRMLS_DC);
  void zend_do_bind_catch(znode *try_token, znode *catch_token TSRMLS_DC);
  void zend_do_end_catch(znode *catch_token TSRMLS_DC);
  void zend_do_finally(znode *finally_token TSRMLS_DC);
  void zend_do_end_finally(znode *try_token, znode* catch_token, znode *finally_token TSRMLS_DC);
  void zend_do_throw(const znode *expr TSRMLS_DC);
  
  ZEND_API int do_bind_function(const zend_op_array *op_array, zend_op *opline, HashTable *function_table, zend_bool compile_time);
  ZEND_API zend_class_entry *do_bind_class(const zend_op_array *op_array, const zend_op *opline, HashTable *class_table, zend_bool compile_time TSRMLS_DC);
  ZEND_API zend_class_entry *do_bind_inherited_class(const zend_op_array *op_array, const zend_op *opline, HashTable *class_table, zend_class_entry *parent_ce, zend_bool compile_time TSRMLS_DC);
  ZEND_API void zend_do_inherit_interfaces(zend_class_entry *ce, const zend_class_entry *iface TSRMLS_DC);
  ZEND_API void zend_do_implement_interface(zend_class_entry *ce, zend_class_entry *iface TSRMLS_DC);
  void zend_do_implements_interface(znode *interface_znode TSRMLS_DC);
  
  /* Trait related functions */
  void zend_do_use_trait(znode *trait_znode TSRMLS_DC);
  void zend_prepare_reference(znode *result, znode *class_name, znode *method_name TSRMLS_DC);
  void zend_add_trait_precedence(znode *method_reference, znode *trait_list TSRMLS_DC);
  void zend_add_trait_alias(znode *method_reference, znode *modifiers, znode *alias TSRMLS_DC);
  
  ZEND_API void zend_do_implement_trait(zend_class_entry *ce, zend_class_entry *trait TSRMLS_DC);
  ZEND_API void zend_do_bind_traits(zend_class_entry *ce TSRMLS_DC);
  
  ZEND_API void zend_do_inheritance(zend_class_entry *ce, zend_class_entry *parent_ce TSRMLS_DC);
  void zend_do_early_binding(TSRMLS_D);
  ZEND_API void zend_do_delayed_early_binding(const zend_op_array *op_array TSRMLS_DC);
  
  void zend_do_pass_param(znode *param, zend_uchar op TSRMLS_DC);
  void zend_do_unpack_params(znode *params TSRMLS_DC);
  
  
  void zend_do_boolean_or_begin(znode *expr1, znode *op_token TSRMLS_DC);
  void zend_do_boolean_or_end(znode *result, const znode *expr1, const znode *expr2, znode *op_token TSRMLS_DC);
  void zend_do_boolean_and_begin(znode *expr1, znode *op_token TSRMLS_DC);
  void zend_do_boolean_and_end(znode *result, const znode *expr1, const znode *expr2, const znode *op_token TSRMLS_DC);
  
  void zend_do_brk_cont(zend_uchar op, const znode *expr TSRMLS_DC);
  
  void zend_do_switch_cond(const znode *cond TSRMLS_DC);
  void zend_do_switch_end(const znode *case_list TSRMLS_DC);
  void zend_do_case_before_statement(const znode *case_list, znode *case_token, const znode *case_expr TSRMLS_DC);
  void zend_do_case_after_statement(znode *result, const znode *case_token TSRMLS_DC);
  void zend_do_default_before_statement(const znode *case_list, znode *default_token TSRMLS_DC);
  
  void zend_do_begin_class_declaration(const znode *class_token, znode *class_name, const znode *parent_class_name TSRMLS_DC);
  void zend_do_end_class_declaration(const znode *class_token, const znode *parent_token TSRMLS_DC);
  void zend_do_declare_property(const znode *var_name, const znode *value, zend_uint access_type TSRMLS_DC);
  void zend_do_declare_class_constant(znode *var_name, const znode *value TSRMLS_DC);
  
  void zend_do_fetch_property(znode *result, znode *object, const znode *property TSRMLS_DC);
  
  void zend_do_halt_compiler_register(TSRMLS_D);
  
  void zend_do_push_object(const znode *object TSRMLS_DC);
  void zend_do_pop_object(znode *object TSRMLS_DC);
  
  
  void zend_do_begin_new_object(znode *new_token, znode *class_type TSRMLS_DC);
  void zend_do_end_new_object(znode *result, const znode *new_token TSRMLS_DC);
  
  void zend_do_fetch_constant(znode *result, znode *constant_container, znode *constant_name, int mode, zend_bool check_namespace TSRMLS_DC);
  
  void zend_do_shell_exec(znode *result, const znode *cmd TSRMLS_DC);
  
  void zend_do_init_array(znode *result, const znode *expr, const znode *offset, zend_bool is_ref TSRMLS_DC);
  void zend_do_add_array_element(znode *result, const znode *expr, const znode *offset, zend_bool is_ref TSRMLS_DC);
  void zend_do_add_static_array_element(zval *result, zval *offset, const zval *expr);
  void zend_do_list_init(TSRMLS_D);
  void zend_do_list_end(znode *result, znode *expr TSRMLS_DC);
  void zend_do_add_list_element(const znode *element TSRMLS_DC);
  void zend_do_new_list_begin(TSRMLS_D);
  void zend_do_new_list_end(TSRMLS_D);
  
  /* Functions for a null terminated pointer list, used for traits parsing and compilation */
  void zend_init_list(void *result, void *item TSRMLS_DC);
  void zend_add_to_list(void *result, void *item TSRMLS_DC);
  
  
  void zend_do_cast(znode *result, const znode *expr, int type TSRMLS_DC);
  void zend_do_include_or_eval(int type, znode *result, const znode *op1 TSRMLS_DC);
  
  void zend_do_unset(const znode *variable TSRMLS_DC);
  void zend_do_isset_or_isempty(int type, znode *result, znode *variable TSRMLS_DC);
  
  void zend_do_instanceof(znode *result, const znode *expr, const znode *class_znode, int type TSRMLS_DC);
  
  void zend_do_foreach_begin(znode *foreach_token, znode *open_brackets_token, znode *array, znode *as_token, int variable TSRMLS_DC);
  void zend_do_foreach_cont(znode *foreach_token, const znode *open_brackets_token, const znode *as_token, znode *value, znode *key TSRMLS_DC);
  void zend_do_foreach_end(const znode *foreach_token, const znode *as_token TSRMLS_DC);
  
  void zend_do_declare_begin(TSRMLS_D);
  void zend_do_declare_stmt(znode *var, znode *val TSRMLS_DC);
  void zend_do_declare_end(const znode *declare_token TSRMLS_DC);
  
  void zend_do_exit(znode *result, const znode *message TSRMLS_DC);
  
  void zend_do_begin_silence(znode *strudel_token TSRMLS_DC);
  void zend_do_end_silence(const znode *strudel_token TSRMLS_DC);
  
  void zend_do_jmp_set(const znode *value, znode *jmp_token, znode *colon_token TSRMLS_DC);
  void zend_do_jmp_set_else(znode *result, const znode *false_value, const znode *jmp_token, const znode *colon_token TSRMLS_DC);
  
  void zend_do_begin_qm_op(const znode *cond, znode *qm_token TSRMLS_DC);
  void zend_do_qm_true(const znode *true_value, znode *qm_token, znode *colon_token TSRMLS_DC);
  void zend_do_qm_false(znode *result, const znode *false_value, const znode *qm_token, const znode *colon_token TSRMLS_DC);
  
  void zend_do_extended_info(TSRMLS_D);
  void zend_do_extended_fcall_begin(TSRMLS_D);
  void zend_do_extended_fcall_end(TSRMLS_D);
  
  void zend_do_ticks(TSRMLS_D);
  
  void zend_do_abstract_method(const znode *function_name, znode *modifiers, const znode *body TSRMLS_DC);
  
  void zend_do_declare_constant(znode *name, znode *value TSRMLS_DC);
  void zend_do_build_namespace_name(znode *result, znode *prefix, znode *name TSRMLS_DC);
  void zend_do_begin_namespace(const znode *name, zend_bool with_brackets TSRMLS_DC);
  void zend_do_end_namespace(TSRMLS_D);
  void zend_verify_namespace(TSRMLS_D);
  void zend_do_use(znode *name, znode *new_name TSRMLS_DC);
  void zend_do_use_non_class(znode *ns_name, znode *new_name, int is_function, zend_bool case_sensitive, HashTable *current_import_sub, HashTable *lookup_table TSRMLS_DC);
  void zend_do_use_function(znode *name, znode *new_name TSRMLS_DC);
  void zend_do_use_const(znode *name, znode *new_name TSRMLS_DC);
  void zend_do_end_compilation(TSRMLS_D);
  void zend_do_constant_expression(znode *result, zend_ast *ast TSRMLS_DC);
  
  void zend_do_resolve_class_name(znode *result, znode *class_name, int is_static TSRMLS_DC);
  
  void zend_do_label(znode *label TSRMLS_DC);
  void zend_do_goto(const znode *label TSRMLS_DC);
  void zend_resolve_goto_label(zend_op_array *op_array, zend_op *opline, int pass2 TSRMLS_DC);
  void zend_release_labels(int temporary TSRMLS_DC);
  
  ZEND_API void function_add_ref(zend_function *function);
  
  #define INITIAL_OP_ARRAY_SIZE 64
  #define INITIAL_INTERACTIVE_OP_ARRAY_SIZE 8192
  
  
  /* helper functions in zend_language_scanner.l */
  ZEND_API zend_op_array *compile_file(zend_file_handle *file_handle, int type TSRMLS_DC);
  ZEND_API zend_op_array *compile_string(zval *source_string, char *filename TSRMLS_DC);
  ZEND_API zend_op_array *compile_filename(int type, zval *filename TSRMLS_DC);
  ZEND_API int zend_execute_scripts(int type TSRMLS_DC, zval **retval, int file_count, ...);
  ZEND_API int open_file_for_scanning(zend_file_handle *file_handle TSRMLS_DC);
  ZEND_API void init_op_array(zend_op_array *op_array, zend_uchar type, int initial_ops_size TSRMLS_DC);
  ZEND_API void destroy_op_array(zend_op_array *op_array TSRMLS_DC);
  ZEND_API void zend_destroy_file_handle(zend_file_handle *file_handle TSRMLS_DC);
  ZEND_API int zend_cleanup_class_data(zend_class_entry **pce TSRMLS_DC);
  ZEND_API int zend_cleanup_user_class_data(zend_class_entry **pce TSRMLS_DC);
  ZEND_API void zend_cleanup_internal_class_data(zend_class_entry *ce TSRMLS_DC);
  ZEND_API void zend_cleanup_internal_classes(TSRMLS_D);
  ZEND_API int zend_cleanup_function_data(zend_function *function TSRMLS_DC);
  ZEND_API int zend_cleanup_function_data_full(zend_function *function TSRMLS_DC);
  ZEND_API int clean_non_persistent_function_full(zend_function *function TSRMLS_DC);
  ZEND_API int clean_non_persistent_class_full(zend_class_entry **ce TSRMLS_DC);
  
  ZEND_API void destroy_zend_function(zend_function *function TSRMLS_DC);
  ZEND_API void zend_function_dtor(zend_function *function);
  ZEND_API void destroy_zend_class(zend_class_entry **pce);
  void zend_class_add_ref(zend_class_entry **ce);
  
  ZEND_API void zend_mangle_property_name(char **dest, int *dest_length, const char *src1, int src1_length, const char *src2, int src2_length, int internal);
  #define zend_unmangle_property_name(mangled_property, mangled_property_len, class_name, prop_name) \
          zend_unmangle_property_name_ex(mangled_property, mangled_property_len, class_name, prop_name, NULL)
  ZEND_API int zend_unmangle_property_name_ex(const char *mangled_property, int mangled_property_len, const char **class_name, const char **prop_name, int *prop_len);
  
  #define ZEND_FUNCTION_DTOR (void (*)(void *)) zend_function_dtor
  #define ZEND_CLASS_DTOR (void (*)(void *)) destroy_zend_class
  
  zend_op *get_next_op(zend_op_array *op_array TSRMLS_DC);
  void init_op(zend_op *op TSRMLS_DC);
  int get_next_op_number(zend_op_array *op_array);
  int print_class(zend_class_entry *class_entry TSRMLS_DC);
  void print_op_array(zend_op_array *op_array, int optimizations);
  ZEND_API int pass_two(zend_op_array *op_array TSRMLS_DC);
  zend_brk_cont_element *get_next_brk_cont_element(zend_op_array *op_array);
  void zend_do_first_catch(znode *open_parentheses TSRMLS_DC);
  void zend_initialize_try_catch_element(znode *catch_token TSRMLS_DC);
  void zend_do_mark_last_catch(const znode *first_catch, const znode *last_additional_catch TSRMLS_DC);
  ZEND_API zend_bool zend_is_compiling(TSRMLS_D);
  ZEND_API char *zend_make_compiled_string_description(const char *name TSRMLS_DC);
  ZEND_API void zend_initialize_class_data(zend_class_entry *ce, zend_bool nullify_handlers TSRMLS_DC);
  int zend_get_class_fetch_type(const char *class_name, uint class_name_len);
  
  typedef zend_bool (*zend_auto_global_callback)(const char *name, uint name_len TSRMLS_DC);
  typedef struct _zend_auto_global {/* 用于储存 _POST,_GET,_COOKIE,_SERVER,_ENV,_REQUEST,_FILES,GLOBALS的结构 */
  	const char *name;/* 自动全局变量名称 例如 _POST */
  	uint name_len;
  	zend_auto_global_callback auto_global_callback;
  	zend_bool jit;
  	zend_bool armed;
  } zend_auto_global;
  
  ZEND_API int zend_register_auto_global(const char *name, uint name_len, zend_bool jit, zend_auto_global_callback auto_global_callback TSRMLS_DC);
  ZEND_API void zend_activate_auto_globals(TSRMLS_D);
  ZEND_API zend_bool zend_is_auto_global(const char *name, uint name_len TSRMLS_DC);
  ZEND_API zend_bool zend_is_auto_global_quick(const char *name, uint name_len, ulong hashval TSRMLS_DC);
  ZEND_API size_t zend_dirname(char *path, size_t len);
  
  int zendlex(znode *zendlval TSRMLS_DC);
  
  int zend_add_literal(zend_op_array *op_array, const zval *zv TSRMLS_DC);
  
  /* BEGIN: OPCODES */
  
  #include "zend_vm_opcodes.h"
  
  #define ZEND_OP_DATA				137
  
  /* END: OPCODES */
  
  /* class fetches */
  #define ZEND_FETCH_CLASS_DEFAULT	0
  #define ZEND_FETCH_CLASS_SELF		1
  #define ZEND_FETCH_CLASS_PARENT		2
  #define ZEND_FETCH_CLASS_MAIN		3	/* unused */
  #define ZEND_FETCH_CLASS_GLOBAL		4	/* unused */
  #define ZEND_FETCH_CLASS_AUTO		5
  #define ZEND_FETCH_CLASS_INTERFACE	6
  #define ZEND_FETCH_CLASS_STATIC		7
  #define ZEND_FETCH_CLASS_TRAIT		14
  #define ZEND_FETCH_CLASS_MASK        0x0f
  #define ZEND_FETCH_CLASS_NO_AUTOLOAD 0x80
  #define ZEND_FETCH_CLASS_SILENT      0x0100
  
  /* variable parsing type (compile-time) */
  #define ZEND_PARSED_MEMBER				(1<<0)
  #define ZEND_PARSED_METHOD_CALL			(1<<1)
  #define ZEND_PARSED_STATIC_MEMBER		(1<<2)
  #define ZEND_PARSED_FUNCTION_CALL		(1<<3)
  #define ZEND_PARSED_VARIABLE			(1<<4)
  #define ZEND_PARSED_REFERENCE_VARIABLE	(1<<5)
  #define ZEND_PARSED_NEW					(1<<6)
  #define ZEND_PARSED_LIST_EXPR			(1<<7)
  
  
  /* unset types */
  #define ZEND_UNSET_REG 0
  
  /* var status for backpatching */
  #define BP_VAR_R			0
  #define BP_VAR_W			1
  #define BP_VAR_RW			2
  #define BP_VAR_IS			3
  #define BP_VAR_NA			4	/* if not applicable */
  #define BP_VAR_FUNC_ARG		5
  #define BP_VAR_UNSET		6
  
  
  #define ZEND_INTERNAL_FUNCTION				1 /* 内置函数 */
  #define ZEND_USER_FUNCTION					2 /* 用户函数 全局代码，用户函数的_zend_op_array结构的type */
  #define ZEND_OVERLOADED_FUNCTION			3
  #define	ZEND_EVAL_CODE						4 /* eval函数的_zend_op_array结构的type */
  #define ZEND_OVERLOADED_FUNCTION_TEMPORARY	5
  
  #define ZEND_INTERNAL_CLASS         1
  #define ZEND_USER_CLASS             2
  
  #define ZEND_EVAL				(1<<0)
  #define ZEND_INCLUDE			(1<<1)
  #define ZEND_INCLUDE_ONCE		(1<<2)
  #define ZEND_REQUIRE			(1<<3)
  #define ZEND_REQUIRE_ONCE		(1<<4)
  
  #define ZEND_CT	(1<<0)
  #define ZEND_RT (1<<1)
  
  /* global/local fetches */
  #define ZEND_FETCH_GLOBAL			0x00000000
  #define ZEND_FETCH_LOCAL			0x10000000
  #define ZEND_FETCH_STATIC			0x20000000
  #define ZEND_FETCH_STATIC_MEMBER	0x30000000
  #define ZEND_FETCH_GLOBAL_LOCK		0x40000000
  #define ZEND_FETCH_LEXICAL			0x50000000
  
  #define ZEND_FETCH_TYPE_MASK		0x70000000
  
  #define ZEND_FETCH_STANDARD		    0x00000000
  #define ZEND_FETCH_ADD_LOCK		    0x08000000
  #define ZEND_FETCH_MAKE_REF		    0x04000000
  
  #define ZEND_ISSET				    0x02000000
  #define ZEND_ISEMPTY			    0x01000000
  #define ZEND_ISSET_ISEMPTY_MASK	    (ZEND_ISSET | ZEND_ISEMPTY)
  #define ZEND_QUICK_SET			    0x00800000
  
  #define ZEND_FETCH_ARG_MASK         0x000fffff
  
  #define ZEND_FE_FETCH_BYREF	1
  #define ZEND_FE_FETCH_WITH_KEY	2
  
  #define ZEND_FE_RESET_VARIABLE 		(1<<0)
  #define ZEND_FE_RESET_REFERENCE		(1<<1)
  #define EXT_TYPE_FREE_ON_RETURN		(1<<2)
  
  #define ZEND_MEMBER_FUNC_CALL	1<<0
  
  #define ZEND_ARG_SEND_BY_REF (1<<0)
  #define ZEND_ARG_COMPILE_TIME_BOUND (1<<1)
  #define ZEND_ARG_SEND_FUNCTION (1<<2)
  #define ZEND_ARG_SEND_SILENT   (1<<3)
  
  #define ZEND_SEND_BY_VAL     0
  #define ZEND_SEND_BY_REF     1
  #define ZEND_SEND_PREFER_REF 2
  
  #define CHECK_ARG_SEND_TYPE(zf, arg_num, m) \
  	((zf)->common.arg_info && \
  	(arg_num <= (zf)->common.num_args \
  		? ((zf)->common.arg_info[arg_num-1].pass_by_reference & (m)) \
  		: ((zf)->common.fn_flags & ZEND_ACC_VARIADIC) \
  			? ((zf)->common.arg_info[(zf)->common.num_args-1].pass_by_reference & (m)) : 0))
  
  #define ARG_MUST_BE_SENT_BY_REF(zf, arg_num) \
  	CHECK_ARG_SEND_TYPE(zf, arg_num, ZEND_SEND_BY_REF)
  
  #define ARG_SHOULD_BE_SENT_BY_REF(zf, arg_num) \
  	CHECK_ARG_SEND_TYPE(zf, arg_num, ZEND_SEND_BY_REF|ZEND_SEND_PREFER_REF)
  
  #define ARG_MAY_BE_SENT_BY_REF(zf, arg_num) \
  	CHECK_ARG_SEND_TYPE(zf, arg_num, ZEND_SEND_PREFER_REF)
  
  #define ZEND_RETURN_VAL 0
  #define ZEND_RETURN_REF 1
  
  
  #define ZEND_RETURNS_FUNCTION 1<<0
  #define ZEND_RETURNS_NEW      1<<1
  #define ZEND_RETURNS_VALUE    1<<2
  
  #define ZEND_FAST_RET_TO_CATCH		1
  #define ZEND_FAST_RET_TO_FINALLY	2
  
  #define ZEND_FAST_CALL_FROM_CATCH	1
  #define ZEND_FAST_CALL_FROM_FINALLY	2
  
  END_EXTERN_C()
  
  #define ZEND_CLONE_FUNC_NAME		"__clone"
  #define ZEND_CONSTRUCTOR_FUNC_NAME	"__construct"
  #define ZEND_DESTRUCTOR_FUNC_NAME	"__destruct"
  #define ZEND_GET_FUNC_NAME          "__get"
  #define ZEND_SET_FUNC_NAME          "__set"
  #define ZEND_UNSET_FUNC_NAME        "__unset"
  #define ZEND_ISSET_FUNC_NAME        "__isset"
  #define ZEND_CALL_FUNC_NAME         "__call"
  #define ZEND_CALLSTATIC_FUNC_NAME   "__callstatic"
  #define ZEND_TOSTRING_FUNC_NAME     "__tostring"
  #define ZEND_AUTOLOAD_FUNC_NAME     "__autoload"
  #define ZEND_INVOKE_FUNC_NAME       "__invoke"
  #define ZEND_DEBUGINFO_FUNC_NAME    "__debuginfo"
  
  /* The following constants may be combined in CG(compiler_options)
   * to change the default compiler behavior */
  
  /* generate extended debug information */
  #define ZEND_COMPILE_EXTENDED_INFO				(1<<0)
  
  /* call op_array handler of extendions */
  #define ZEND_COMPILE_HANDLE_OP_ARRAY            (1<<1)
  
  /* generate ZEND_DO_FCALL_BY_NAME for internal functions instead of ZEND_DO_FCALL */
  #define ZEND_COMPILE_IGNORE_INTERNAL_FUNCTIONS	(1<<2)
  
  /* don't perform early binding for classes inherited form internal ones;
   * in namespaces assume that internal class that doesn't exist at compile-time
   * may apper in run-time */
  #define ZEND_COMPILE_IGNORE_INTERNAL_CLASSES	(1<<3)
  
  /* generate ZEND_DECLARE_INHERITED_CLASS_DELAYED opcode to delay early binding */
  #define ZEND_COMPILE_DELAYED_BINDING			(1<<4)
  
  /* disable constant substitution at compile-time */
  #define ZEND_COMPILE_NO_CONSTANT_SUBSTITUTION	(1<<5)
  
  /* The default value for CG(compiler_options) */
  #define ZEND_COMPILE_DEFAULT					ZEND_COMPILE_HANDLE_OP_ARRAY
  
  /* The default value for CG(compiler_options) during eval() */
  #define ZEND_COMPILE_DEFAULT_FOR_EVAL			0
  
  #endif /* ZEND_COMPILE_H */
  
  /*
   * Local variables:
   * tab-width: 4
   * c-basic-offset: 4
   * indent-tabs-mode: t
   * End:
   */
  