PHP-7.1 源代碼學(xué)習(xí)：php-cli 啟動流程

VishKozus 發(fā)布于2019-06-27 15:24 / 3109人閱讀

摘要：前言函數(shù)默認構(gòu)建目標為，相關(guān)代碼在目錄下，文件中能夠找到入口函數(shù)，大概流程如下命令行參數(shù)處理初始化清理工作語言系統(tǒng)編程常用手法，通過中聲明函數(shù)指針類型的字段來實現(xiàn)類似面向?qū)ο笾谐橄箢惖母拍睿谖募锌梢哉业皆摻Y(jié)構(gòu)體的定義，這里只列出部分

前言 php cli main 函數(shù)

configure & make 默認構(gòu)建目標為 php-cli，相關(guān)代碼在 sapi/cli 目錄下，php_cli.c 文件中能夠找到 main（入口）函數(shù)，大概流程如下：

命令行參數(shù)處理

cli_sapi_module 初始化

sapi_module->startup

do_cli or do_cli_server

清理工作

sapi_module_struct

C 語言系統(tǒng)編程常用手法，通過 struct 中聲明函數(shù)指針類型的字段來實現(xiàn)類似面向?qū)ο笾谐橄箢惖母拍睿?main/SAPI.h 文件中可以找到該結(jié)構(gòu)體的定義，這里只列出部分字段（下同）：

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 是一個靜態(tài)全局變量，定義在 php_cli.c 中，你可以將它理解成是 sapi_module_struct "類" 的一個 "實例"，結(jié)構(gòu)體中 "掛載" 了 cli 特定的實現(xiàn)函數(shù)：

/* {{{ 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 函數(shù)定義在 php_cli.c 文件中，大致流程如下：

根據(jù)命令行選項確定 behavior（解釋器行為）

根據(jù) behavior 執(zhí)行相應(yīng)的動作

通過執(zhí)行 sapi/cli/php --help 可以查看所有的 php-cli 命令行選項，我們通過幾個簡單的選項來分析解釋器執(zhí)行流程

PHP_MODE_CLI_DIRECT

該模式下，php-cli 會執(zhí)行解釋執(zhí)行通過命令行參數(shù)傳遞的 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 的函數(shù)調(diào)用，定位到 zend_execute_API.c 文件中 zend_eval_stringl 函數(shù)，代碼邏輯已經(jīng)很清楚了：先調(diào)用 zend_compile_string 函數(shù)編譯代碼生成字節(jié)碼 new_op_array，再調(diào)用 zend_execute 函數(shù)執(zhí)行生成的字節(jié)碼

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 屬于語法分析內(nèi)容，參考 PHP-7.1 源代碼學(xué)習(xí): 語法分析，這里做個簡要介紹

compile_string

通過搜索源代碼可以發(fā)現(xiàn) zend_compile_string 最終調(diào)用 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;
}

總結(jié)