前言
php cli main 函数
configure & make 默认构建目标为 php-cli,相关代码在 sapi/cli 目录下,php_cli.c 文件中能够找到 main(入口)函数,大概流程如下:
命令行参数处理
cli_sapi_module 初始化
sapi_module->startup
do_cli or do_cli_server
清理工作
sapi_module_struct
C 语言系统编程常用手法,通过 struct 中声明 函数指针 类型的字段来实现类似面向对象中抽象类的概念,在 main/SAPI.h 文件中可以找到该结构体的定义,这里只列出部分字段(下同):
struct _sapi_module_struct {
char *name;
char *pretty_name;
int (*startup)(struct _sapi_module_struct *sapi_module);
int (*shutdown)(struct _sapi_module_struct *sapi_module);
...
char *ini_entries;
const zend_function_entry *additional_functions;
unsigned int (*input_filter_init)(void);
}
cli_sapi_module
cli_sapi_module 是一个静态全局变量,定义在 php_cli.c 中,你可以将它理解成是 sapi_module_struct "类" 的一个 "实例",结构体中 "挂载" 了 cli 特定的实现函数:
/* {{{ sapi_module_struct cli_sapi_module
*/
static sapi_module_struct cli_sapi_module = {
"cli", /* name */
"Command Line Interface", /* pretty name */
...
php_cli_startup, /* startup */
php_module_shutdown_wrapper, /* shutdown */
...
STANDARD_SAPI_MODULE_PROPERTIES
};
do_cli
do_cli 函数定义在 php_cli.c 文件中,大致流程如下:
根据命令行选项 确定 behavior(解释器行为)
根据 behavior 执行相应的动作
通过执行 sapi/cli/php --help 可以查看所有的 php-cli 命令行选项,我们通过几个简单的选项来分析解释器执行流程
PHP_MODE_CLI_DIRECT
该模式下,php-cli 会执行解释执行通过命令行参数传递的 code
case PHP_MODE_CLI_DIRECT:
cli_register_file_handles();
if (zend_eval_string_ex(exec_direct, NULL,
"Command line code", 1) == FAILURE) {
exit_status=254;
}
break;
追踪 zend_eval_string_ex 的函数调用,定位到 zend_execute_API.c 文件中 zend_eval_stringl 函数,代码逻辑已经很清楚了:先调用 zend_compile_string 函数编译代码生成字节码 new_op_array,再调用 zend_execute 函数执行生成的字节码
ZEND_API int zend_eval_stringl(char *str, size_t str_len, zval *retval_ptr,
char *string_name) {
...
original_compiler_options = CG(compiler_options);
CG(compiler_options) = ZEND_COMPILE_DEFAULT_FOR_EVAL;
new_op_array = zend_compile_string(&pv, string_name);
CG(compiler_options) = original_compiler_options;
if (new_op_array) {
zend_try {
ZVAL_UNDEF(&local_retval);
zend_execute(new_op_array, &local_retval);
} zend_catch {
destroy_op_array(new_op_array);
efree_size(new_op_array, sizeof(zend_op_array));
zend_bailout();
} zend_end_try();
...
} else {
retval = FAILURE;
}
zval_dtor(&pv);
return retval;
}
zend_compile_string 属于语法分析内容,参考 PHP-7.1 源代码学习: 语法分析,这里做个简要介绍
compile_string
通过搜索源代码可以发现 zend_compile_string 最终调用 compile_string
zend_op_array *compile_string(zval *source_string, char *filename)
{
zend_lex_state original_lex_state;
zend_op_array *op_array = NULL;
zval tmp;
if (Z_STRLEN_P(source_string)==0) {
return NULL;
}
ZVAL_DUP(&tmp, source_string);
convert_to_string(&tmp);
source_string = &tmp;
zend_save_lexical_state(&original_lex_state);
if (zend_prepare_string_for_scanning(source_string, filename) == SUCCESS) {
BEGIN(ST_IN_SCRIPTING);
op_array = zend_compile(ZEND_EVAL_CODE);
}
zend_restore_lexical_state(&original_lex_state);
zval_dtor(&tmp);
return op_array;
}
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。