### 3.2.2 内部函数 上一节已经提过，内部函数指的是由内核、扩展提供的C语言编写的function，这类函数不需要经历opcode的编译过程，所以效率上要高于PHP用户自定义的函数，调用时与普通的C程序没有差异。 Zend引擎中定义了很多内部函数供用户在PHP中使用，比如：define、defined、strlen、method_exists、class_exists、function_exists......等等，除了Zend引擎中定义的内部函数，PHP扩展中也提供了大量内部函数，我们也可以灵活的通过扩展自行定制。 #### 3.2.2.1 内部函数结构 上一节介绍`zend_function`为union，其中`internal_function`就是内部函数用到的，具体结构： ```c //zend_complie.h typedef struct _zend_internal_function { /* Common elements */ zend_uchar type; zend_uchar arg_flags[3]; /* bitset of arg_info.pass_by_reference */ uint32_t fn_flags; zend_string* function_name; zend_class_entry *scope; zend_function *prototype; uint32_t num_args; uint32_t required_num_args; zend_internal_arg_info *arg_info; /* END of common elements */ void (*handler)(INTERNAL_FUNCTION_PARAMETERS); //函数指针，展开：void (*handler)(zend_execute_data *execute_data, zval *return_value) struct _zend_module_entry *module; void *reserved[ZEND_MAX_RESERVED_RESOURCES]; } zend_internal_function; ``` `zend_internal_function`头部是一个与`zend_op_array`完全相同的common结构。 下面看下如何定义一个内部函数。 #### 3.2.2.2 定义与注册 内部函数与用户自定义函数冲突，用户无法在PHP代码中覆盖内部函数，执行PHP脚本时会提示error错误。 内部函数的定义非常简单，我们只需要创建一个普通的C函数，然后创建一个`zend_internal_function`结构添加到 __EG(function_table)__ (也可能是CG(function_table),取决于在哪一阶段注册)中即可使用，内部函数 __通常__ 情况下是在php_module_startup阶段注册的，这里之所以说通常是按照标准的扩展定义，除了扩展提供的方式我们可以在任何阶段自由定义内部函数，当然并不建议这样做。下面我们先不讨论扩展标准的定义方式，我们先自己尝试下如何注册一个内部函数。 根据`zend_internal_function`的结构我们知道需要定义一个handler： ```c void qp_test(INTERNAL_FUNCTION_PARAMETERS) { printf("call internal function 'qp_test'\n"); } ``` 然后创建一个内部函数结构(我们在扩展PHP_MINIT_FUNCTION方法中注册，也可以在其他位置)： ```c PHP_MINIT_FUNCTION(xxxxxx) { zend_string *lowercase_name; zend_function *reg_function; //函数名转小写，因为php的函数不区分大小写 lowercase_name = zend_string_alloc(7, 1); zend_str_tolower_copy(ZSTR_VAL(lowercase_name), "qp_test", 7); lowercase_name = zend_new_interned_string(lowercase_name); reg_function = malloc(sizeof(zend_internal_function)); reg_function->internal_function.type = ZEND_INTERNAL_FUNCTION; //定义类型为内部函数 reg_function->internal_function.function_name = lowercase_name; reg_function->internal_function.handler = qp_test; zend_hash_add_ptr(CG(function_table), lowercase_name, reg_function); //注册到CG(function_table)符号表中 } ``` 接着编译、安装扩展，测试： ```php qp_test(); ``` 结果输出： `call internal function 'qp_test'` 这样一个内部函数就定义完成了。这里有一个地方需要注意的我们把这个函数注册到 __CG(function_table)__ 中去了，而不是 __EG(function_table)__ ，这是因为在`php_request_startup`阶段会把 __CG(function_table)__ 赋值给 __EG(function_table)__ 。 上面的过程看着比较简单，但是在实际应用中不要这样做，PHP提供给我们一套标准的定义方式，接下来看下如何在扩展中按照官方方式提供一个内部函数。 首先也是定义C函数，这个通过`PHP_FUNCTION`宏定义： ```c PHP_FUNCTION(qp_test) { printf("call internal function 'qp_test'\n"); } ``` 然后是注册过程，这个只需要我们将所有的函数数组添加到扩展结构`zend_module_entry.functions`即可，扩展加载过程中会自动进行函数注册(见1.2节)，不需要我们干预： ```c const zend_function_entry xxxx_functions[] = { PHP_FE(qp_test, NULL) PHP_FE_END }; zend_module_entry xxxx_module_entry = { STANDARD_MODULE_HEADER, "扩展名称", xxxx_functions, PHP_MINIT(timeout), PHP_MSHUTDOWN(timeout), PHP_RINIT(timeout), /* Replace with NULL if there's nothing to do at request start */ PHP_RSHUTDOWN(timeout), /* Replace with NULL if there's nothing to do at request end */ PHP_MINFO(timeout), PHP_TIMEOUT_VERSION, STANDARD_MODULE_PROPERTIES }; ``` 关于更多扩展中函数相关的用法会在后面扩展开发一章中详细介绍，这里不再展开。