php內核分析（四）－do_cli

這裏閱讀的php版本爲PHP-7.1.0 RC3，閱讀代碼的平臺爲linux

＃ main

把剩下的代碼增長了下注釋所有貼出來了（這個是簡化後的main函數，去掉了一些可有可無的代碼段）：

int main(int argc, char *argv[])
{
    ...
    sapi_module_struct *sapi_module = &cli_sapi_module;

    argv = save_ps_args(argc, argv); //這裏獲取一次當前執行進程的參數，環境變量等。爲的是對特定平臺，修正下argv變量以供後續使用。

    cli_sapi_module.additional_functions = additional_functions; // cli模式特有的函數

     ...


#ifdef ZTS
    tsrm_startup(1, 1, 0, NULL);
    (void)ts_resource(0);
    ZEND_TSRMLS_CACHE_UPDATE();
#endif

    zend_signal_startup();  // 設置信號，把一些須要反應的信號位設置爲0

    // 獲取參數，作一些對應的初始化行爲，或者一些簡單的操做，好比help
    while ((c = php_getopt(argc, argv, OPTIONS, &php_optarg, &php_optind, 0, 2))!=-1) {
        switch (c) { // 這裏的c是表明返回的字符串的ascii碼值
            case 'c':
                ...
            case 'n':
                ini_ignore = 1; // 不使用ini文件，經過代碼或者其餘指定ini值
                break;
            case 'd': { // 配置ini的key，val值在命令行中，下面的行爲都是修改ini_entries這個變量
                ...
            }
            case 'h': /* help & quit */
            case '?':
                php_cli_usage(argv[0]);
                goto out;
            case 'i': case 'v': case 'm':
                sapi_module = &cli_sapi_module;
                goto exit_loop;
            case 'e': /* enable extended info output */
                use_extended_info = 1;
                break;
        }
    }
exit_loop:

    sapi_module->ini_defaults = sapi_cli_ini_defaults; // 設置初始化的ini值
    sapi_module->php_ini_path_override = ini_path_override; //設置重寫後的ini_path地址，若是是php -c的話，這個就爲非null
    sapi_module->phpinfo_as_text = 1; // 打開打印phpinfo的開關，須要的時候能夠把phpinfo打印出來
    sapi_module->php_ini_ignore_cwd = 1; // 不在當前路徑尋找php.ini
    sapi_startup(sapi_module); // sapi初始化行爲，好比初始化全局變量SG
    sapi_started = 1; // 標記，表示已經調用了startup，關閉的時候須要調用shundown
    ...

    // 開始調用sapi的startup方法，對cli模式，其實是調用php_cli_startup方法
    if (sapi_module->startup(sapi_module) == FAILURE) {
        exit_status = 1;
        goto out;
    }
    module_started = 1; // 標記位，標記已經調用了module的startup方法

    ...

    zend_first_try {
            exit_status = do_cli(argc, argv);  // 這個是實際上調用的內容
    } zend_end_try();
out:  // 這個代碼段已是要退出了
    if (ini_path_override) {
        free(ini_path_override);
    }
    if (ini_entries) {
        free(ini_entries);
    }
    if (module_started) {
        php_module_shutdown();
    }
    if (sapi_started) {
        sapi_shutdown();
    }
#ifdef ZTS
    tsrm_shutdown();
#endif

    cleanup_ps_args(argv);
    exit(exit_status);
}

其實看僞碼很簡單：

tsrm_startup(1, 1, 0, NULL);  // TSM啓動
zend_signal_startup();  // 信號設置
sapi_startup(sapi_module);  // SAPI啓動
sapi_module->startup(sapi_module); // 當前模塊的startup
do_cli(argc, argv); // 作實際的行爲
php_module_shutdown();  // 當前模塊的shutdown
sapi_shutdown(); // SAPI關閉
tsrm_shutdown(); // TSM關閉

好了，其實看了一圈，裏面最重的函數是do_cli了。

php參數

do_cli裏面你會看到根據參數的不一樣，有不少分支，這裏你就須要瞭解這些參數都是什麼用的。

參數
做用
實例

do_cli

咱們把do_cli函數的整個函數去掉多餘代碼，僅保留關鍵代碼以下：

static int do_cli(int argc, char **argv)
{
    ...

    zend_try {

        // 這裏處理了 i-輸出phpinfo內容/ v-輸出php版本 / m-輸出擴展信息
        while ((c = php_getopt(argc, argv, OPTIONS, &php_optarg, &php_optind, 0, 2)) != -1) {
            switch (c) {

            case 'i': // 輸出phpinfo內容
                ...
                php_print_info(0xFFFFFFFF);
                ...
                goto out;

            case 'v': // 輸出php版本信息
                ...
                    get_zend_version()
                ...
                goto out;

            case 'm': // 列出全部模塊
                ...
                print_extensions();
                ...
                goto out;

            default:
                break;
            }
        }

        ...

        // 下面的代碼作了幾個事情：
        // 1 根據參數設置了behavior參數
        // 2 有執行文件的就將文件存在script_file
        while ((c = php_getopt(argc, argv, OPTIONS, &php_optarg, &php_optind, 0, 2)) != -1) {
            switch (c) {

            case 'a': // php的交互模式
                ...
                interactive=1;
                ...
                break;

            case 'C': // 不要把cwd目錄變成腳本所在的目錄。這個默認就是cwd是當前執行路徑，因此這裏什麼都不作。
                break;

            case 'F': // php -F <FILE> 進入交互模式，每執行一行就執行一次<FILE>文件
                ...
                behavior=PHP_MODE_PROCESS_STDIN;
                script_file = php_optarg;
                break;

            case 'f': // php -f <FILE> 解析並執行文件
                ...
                script_file = php_optarg;
                break;

            case 'l':  // 檢查文件的語法是否有錯誤
                ...
                behavior=PHP_MODE_LINT;
                break;

            case 'q': // 安靜模式，默認也是安靜模式
                break;

            case 'r': // 從命令行直接執行腳本
                ...
                behavior=PHP_MODE_CLI_DIRECT;
                exec_direct=php_optarg;
                break;

            case 'R': // 每行輸入的時候執行一次code腳本，好比 php -R 'echo 12;'
                ...
                behavior=PHP_MODE_PROCESS_STDIN;
                exec_run=php_optarg;
                break;

            case 'B': // 在每次輸入開始以前執行一次code腳本
                ...
                behavior=PHP_MODE_PROCESS_STDIN;
                exec_begin=php_optarg;
                break;

            case 'E': // 在每次輸入結束以後執行一次code腳本， 上面的 RBE能夠參考一個例子：find conf.d | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";'
                ...
                behavior=PHP_MODE_PROCESS_STDIN;
                exec_end=php_optarg;
                break;

            case 's': // 使用html高亮方式顯示代碼，這個或許在一些代碼顯示的時候須要用到
                ...
                behavior=PHP_MODE_HIGHLIGHT;
                break;

            case 'w':  // php <file> -w 能把<file>中的評論和多餘的空格去掉
                ...
                behavior=PHP_MODE_STRIP;
                break;

            case 'z': // 加載外部擴展
                zend_load_extension(php_optarg);
                break;
            case 'H': // 隱藏全部參數
                hide_argv = 1;
                break;
            case 10: // 顯示function定義
                behavior=PHP_MODE_REFLECTION_FUNCTION;
                reflection_what = php_optarg;
                break;
            case 11: // 顯示class定義
                behavior=PHP_MODE_REFLECTION_CLASS;
                reflection_what = php_optarg;
                break;
            case 12: // 顯示擴展定義，注意這裏是php擴展
                behavior=PHP_MODE_REFLECTION_EXTENSION;
                reflection_what = php_optarg;
                break;
            case 13: // 顯示zend擴展定義, 好比xdebug
                behavior=PHP_MODE_REFLECTION_ZEND_EXTENSION;
                reflection_what = php_optarg;
                break;
            case 14: // 顯示擴展的對應配置
                behavior=PHP_MODE_REFLECTION_EXT_INFO;
                reflection_what = php_optarg;
                break;
            case 15: // 顯示ini配置
                behavior = PHP_MODE_SHOW_INI_CONFIG;
                break;
            default:
                break;
            }
        }

        ...

        // 初始化request以後，執行了request_startup
        if (php_request_startup()==FAILURE) {
            ...
            goto err;
        }
        ...

        zend_is_auto_global_str(ZEND_STRL("_SERVER"));

        // 根據不一樣的行爲作不一樣的具體操做，這個是核心方法
        switch (behavior) {
        case PHP_MODE_STANDARD:  // 標準，就是執行一個腳本文件
            ...
                php_execute_script(&file_handle);
            ...
            break;
        case PHP_MODE_LINT: // 只檢查文件有沒有語法錯誤
            exit_status = php_lint_script(&file_handle);
            ...
            break;
        case PHP_MODE_STRIP:
            ...
                zend_strip();
            ...
            break;
        case PHP_MODE_HIGHLIGHT:
            ...
            php_get_highlight_struct(&syntax_highlighter_ini);
            zend_highlight(&syntax_highlighter_ini);
            goto out;
            break;
        case PHP_MODE_CLI_DIRECT:
            ...
            if (zend_eval_string_ex(exec_direct, NULL, "Command line code", 1) == FAILURE) {
                exit_status=254;
            }
            break;

        case PHP_MODE_PROCESS_STDIN:
                ...
                zend_eval_string_ex(exec_end, NULL, "Command line end code", 1)
                ...
                break;
        case PHP_MODE_REFLECTION_FUNCTION:
        case PHP_MODE_REFLECTION_CLASS:
        case PHP_MODE_REFLECTION_EXTENSION:
        case PHP_MODE_REFLECTION_ZEND_EXTENSION:
            ...
            ZVAL_STRING(&arg, reflection_what);
            object_init_ex(&ref, pce);
            ...
            zend_call_method_with_1_params(&ref, pce, &pce->constructor, "__construct", NULL, &arg);
            ...
            break;
        case PHP_MODE_REFLECTION_EXT_INFO:
            ...
            if ((module = zend_hash_str_find_ptr(&module_registry, lcname, len)) == NULL) {
                ...
                    display_ini_entries(NULL);
                ...
            } 
            ...
            break;
        case PHP_MODE_SHOW_INI_CONFIG:
            ...
            break;
        }
    } zend_end_try();

out:
    ...
err:
    ...
}

整個200行的代碼就很好理解了，整個是包在一個zend_try...zend_catch中的。作了幾步：

• 處理-i, -m, -v參數
• 對其餘的參數設置behavior，script_file等變量
• 根據behavior作不一樣的行爲

回到咱們的初步計劃，咱們想要了解的事：

咱們的根據-r的參數配置尋找。

它實際上時調用了

zend_eval_string_ex(exec_direct, NULL, "Command line code", 1)

這裏的exec_direct是 echo 12字符串