1，運(yùn)行時(shí)改變配置
在前一篇中曾經(jīng)談到，ini_set函數(shù)可以在php執(zhí)行的過(guò)程中，動(dòng)態(tài)修改php的部分配置。注意，僅僅是部分，并非所有的配置都可以動(dòng)態(tài)修改。關(guān)于ini配置的可修改性，參見：http://php.NET/manual/zh/configuration.changes.modes.php

我們直接進(jìn)入ini_set的實(shí)現(xiàn)，函數(shù)雖然有點(diǎn)長(zhǎng)，但是邏輯很清晰：

復(fù)制代碼 代碼如下:
php_FUNCTION(ini_set)
{
    char *varname, *new_value;
    int varname_len, new_value_len;
    char *old_value;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss", &varname, &varname_len, &new_value, &new_value_len) == FAILURE) {
        return;
    }

    // 去EG(ini_directives)中獲取配置的值
    old_value = zend_ini_string(varname, varname_len + 1, 0);

    /* copy to return here, because alter might free it! */
    if (old_value) {
        RETVAL_STRING(old_value, 1);
    } else {
        RETVAL_FALSE;
    }

    // 如果開啟了安全模式，那么如下這些ini配置可能涉及文件操作，需要要輔助檢查uid
#define _CHECK_PATH(var, var_len, ini) php_ini_check_path(var, var_len, ini, sizeof(ini))
    /* safe_mode & basedir check */
    if (PG(safe_mode) || PG(open_basedir)) {
        if (_CHECK_PATH(varname, varname_len, "error_log") ||
            _CHECK_PATH(varname, varname_len, "Java.class.path") ||
            _CHECK_PATH(varname, varname_len, "Java.home") ||
            _CHECK_PATH(varname, varname_len, "mail.log") ||
            _CHECK_PATH(varname, varname_len, "Java.library.path") ||
            _CHECK_PATH(varname, varname_len, "vpopmail.directory")) {
            if (PG(safe_mode) && (!php_checkuid(new_value, NULL, CHECKUID_CHECK_FILE_AND_DIR))) {
                zval_dtor(return_value);
                RETURN_FALSE;
            }
            if (php_check_open_basedir(new_value TSRMLS_CC)) {
                zval_dtor(return_value);
                RETURN_FALSE;
            }
        }
    }

    // 在安全模式下，如下這些ini受到保護(hù)，不會(huì)被動(dòng)態(tài)修改
    if (PG(safe_mode)) {
        if (!strncmp("max_execution_time", varname, sizeof("max_execution_time")) ||
            !strncmp("memory_limit", varname, sizeof("memory_limit")) ||
            !strncmp("child_terminate", varname, sizeof("child_terminate"))
        ) {
            zval_dtor(return_value);
            RETURN_FALSE;
        }
    }

    // 調(diào)用zend_alter_ini_entry_ex去動(dòng)態(tài)修改ini配置
    if (zend_alter_ini_entry_ex(varname, varname_len + 1, new_value, new_value_len, php_INI_USER, php_INI_STAGE_RUNTIME, 0 TSRMLS_CC) == FAILURE) {
        zval_dtor(return_value);
        RETURN_FALSE;
    }
}

可以看到，除了一些必要的驗(yàn)證工作，主要就是調(diào)用zend_alter_ini_entry_ex。

我們繼續(xù)跟進(jìn)到zend_alter_ini_entry_ex函數(shù)中：

復(fù)制代碼 代碼如下:
ZEND_API int zend_alter_ini_entry_ex(char *name, uint name_length, char *new_value, uint new_value_length, int modify_type, int stage, int force_change TSRMLS_DC) /* {{{ */
{
    zend_ini_entry *ini_entry;
    char *duplicate;
    zend_bool modifiable;
    zend_bool modified;

    // 找出EG(ini_directives)中對(duì)應(yīng)的ini_entry
    if (zend_hash_find(EG(ini_directives), name, name_length, (void **) &ini_entry) == FAILURE) {
        return FAILURE;
    }

    // 是否被修改以及可修改性
    modifiable = ini_entry->modifiable;
    modified = ini_entry->modified;

    if (stage == ZEND_INI_STAGE_ACTIVATE && modify_type == ZEND_INI_SYSTEM) {
        ini_entry->modifiable = ZEND_INI_SYSTEM;
    }

    // 是否強(qiáng)制修改
    if (!force_change) {
        if (!(ini_entry->modifiable & modify_type)) {
            return FAILURE;
        }
    }

    // EG(modified_ini_directives)用于存放被修改過(guò)的ini_entry
    // 主要用做恢復(fù)
    if (!EG(modified_ini_directives)) {
        ALLOC_HASHTABLE(EG(modified_ini_directives));
        zend_hash_init(EG(modified_ini_directives), 8, NULL, NULL, 0);
    }
   
    // 將ini_entry中的值，值的長(zhǎng)度，可修改范圍，保留到orig_xxx中去
    // 以便在請(qǐng)求結(jié)束的時(shí)候，可以對(duì)ini_entry做恢復(fù)
    if (!modified) {
        ini_entry->orig_value = ini_entry->value;
        ini_entry->orig_value_length = ini_entry->value_length;
        ini_entry->orig_modifiable = modifiable;
        ini_entry->modified = 1;
        zend_hash_add(EG(modified_ini_directives), name, name_length, &ini_entry, sizeof(zend_ini_entry*), NULL);
    }

    duplicate = estrndup(new_value, new_value_length);

    // 調(diào)用modify來(lái)更新XXX_G中對(duì)應(yīng)的ini配置
    if (!ini_entry->on_modify || ini_entry->on_modify(ini_entry, duplicate, new_value_length, ini_entry->mh_arg1, ini_entry->mh_arg2, ini_entry->mh_arg3, stage TSRMLS_CC) == SUCCESS) {
        // 同上面，如果多次修改，則需要釋放前一次修改的值
        if (modified && ini_entry->orig_value != ini_entry->value) {
            efree(ini_entry->value);
        }
        ini_entry->value = duplicate;
        ini_entry->value_length = new_value_length;
    } else {
        efree(duplicate);
        return FAILURE;
    }

    return SUCCESS;
}

有3處邏輯需要我們仔細(xì)體會(huì)：

1）ini_entry中的modified字段用來(lái)表示該配置是否被動(dòng)態(tài)修改過(guò)。一旦該ini配置發(fā)生修改，modified就會(huì)被置為1。上述代碼中有一段很關(guān)鍵：

復(fù)制代碼 代碼如下:
// 如果多次調(diào)用ini_set，則orig_value等始終保持最原始的值
if (!modified) {
    ini_entry->orig_value = ini_entry->value;
    ini_entry->orig_value_length = ini_entry->value_length;
    ini_entry->orig_modifiable = modifiable;
    ini_entry->modified = 1;
    zend_hash_add(EG(modified_ini_directives), name, name_length, &ini_entry, sizeof(zend_ini_entry*), NULL);
}

這段代碼表示，不管我們先后在php代碼中調(diào)用幾次ini_set，只有第一次ini_set時(shí)才會(huì)進(jìn)入這段邏輯，設(shè)置好orig_value。從第二次調(diào)用ini_set開始，便不會(huì)再次執(zhí)行這段分支，因?yàn)榇藭r(shí)的modified已經(jīng)被置為1了。因此，ini_entry->orig_value始終保存的是第一次修改之前的配置值（即最原始的配置）。

2）為了能使ini_set修改的配置立即生效，需要on_modify回調(diào)函數(shù)。

如前一篇文中所述，調(diào)用on_modify是為了能夠更新模塊的全局變量。再次回憶下，首先，模塊全局變量中的配置已經(jīng)不是字符串類型了，該用bool用bool、該用int用int。其次，每一個(gè)ini_entry中都存儲(chǔ)了該模塊全局變量的地址以及對(duì)應(yīng)的偏移量，使得on_modify可以很迅速的進(jìn)行內(nèi)存修改。此外不要忘記，on_modify調(diào)用完了之后，仍需進(jìn)一步更新ini_entry->value，這樣EG(ini_directives)中的配置值就是最新的了。

3）這里出現(xiàn)了一張新的hash表，EG(modified_ini_directives)。

EG(modified_ini_directives)只用于存放被動(dòng)態(tài)修改過(guò)的ini配置，如果一個(gè)ini配置被動(dòng)態(tài)修改過(guò)，那么它既存在于EG(ini_directives)中，又存在于EG(modified_ini_directives)中。既然每一個(gè)ini_entry都有modified字段做標(biāo)記，那豈不是可以遍歷EG(ini_directives)來(lái)獲得所有被修改過(guò)的配置呢？

答案是肯定的。個(gè)人覺得，這里的EG(modified_ini_directives)主要還是為了提升性能，醬直接遍歷EG(modified_ini_directives)就足夠了。此外，把EG(modified_ini_directives)的初始化推遲到zend_alter_ini_entry_ex中，也可以看出php在細(xì)節(jié)上的性能優(yōu)化點(diǎn)。

2，恢復(fù)配置
ini_set的作用時(shí)間和php.ini文件的作用時(shí)間是不一樣的，一旦請(qǐng)求執(zhí)行結(jié)束，則ini_set會(huì)失效。此外，當(dāng)我們代碼中調(diào)用了ini_restore函數(shù)，則之前通過(guò)ini_set設(shè)置的配置也會(huì)失效。

每一個(gè)php請(qǐng)求執(zhí)行完畢之后，會(huì)觸發(fā)php_request_shutdown，它和php_request_startup是兩個(gè)相對(duì)應(yīng)過(guò)程。如果php是掛接在apache/nginx下，則每處理完一個(gè)http請(qǐng)求，就會(huì)調(diào)用php_request_shutdown；如果php以CLI模式來(lái)運(yùn)行，則腳本執(zhí)行完畢之后，也會(huì)調(diào)用php_request_shutdown。

在php_request_shutdown中，我們可以看到針對(duì)ini的恢復(fù)處理：

復(fù)制代碼 代碼如下:
/* 7. Shutdown scanner/executor/compiler and restore ini entries */
zend_deactivate(TSRMLS_C);

進(jìn)入zend_deactivate，可以進(jìn)一步看到調(diào)用了zend_ini_deactivate函數(shù)，由zend_ini_deactivate來(lái)負(fù)責(zé)將php的配置進(jìn)行恢復(fù)。

復(fù)制代碼 代碼如下:
zend_try {
    zend_ini_deactivate(TSRMLS_C);
} zend_end_try();

具體來(lái)看看zend_ini_deactivate的實(shí)現(xiàn)：

復(fù)制代碼 代碼如下:
ZEND_API int zend_ini_deactivate(TSRMLS_D) /* {{{ */
{
    if (EG(modified_ini_directives)) {
        // 遍歷EG(modified_ini_directives)中這張表
        // 對(duì)每一個(gè)ini_entry調(diào)用zend_restore_ini_entry_wrapper
        zend_hash_apply(EG(modified_ini_directives), (apply_func_t) zend_restore_ini_entry_wrapper TSRMLS_CC);
       
        // 回收操作
        zend_hash_destroy(EG(modified_ini_directives));
        FREE_HASHTABLE(EG(modified_ini_directives));
        EG(modified_ini_directives) = NULL;
    }
    return SUCCESS;
}

從zend_hash_apply來(lái)看，真正恢復(fù)ini的任務(wù)最終落地到了zend_restore_ini_entry_wrapper回調(diào)函數(shù)。

復(fù)制代碼 代碼如下:
static int zend_restore_ini_entry_wrapper(zend_ini_entry **ini_entry TSRMLS_DC)
{
    // zend_restore_ini_entry_wrapper就是zend_restore_ini_entry_cb的封裝
    zend_restore_ini_entry_cb(*ini_entry, ZEND_INI_STAGE_DEACTIVATE TSRMLS_CC);
    return 1;
}

static int zend_restore_ini_entry_cb(zend_ini_entry *ini_entry, int stage TSRMLS_DC)
{
    int result = FAILURE;

    // 只看修改過(guò)的ini項(xiàng)
    if (ini_entry->modified) {
        if (ini_entry->on_modify) {
            // 使用orig_value，對(duì)XXX_G內(nèi)的相關(guān)字段進(jìn)行重新設(shè)置
            zend_try {
                result = ini_entry->on_modify(ini_entry, ini_entry->orig_value, ini_entry->orig_value_length, ini_entry->mh_arg1, ini_entry->mh_arg2, ini_entry->mh_arg3, stage TSRMLS_CC);
            } zend_end_try();
        }
        if (stage == ZEND_INI_STAGE_RUNTIME && result == FAILURE) {
            /* runtime failure is OK */
            return 1;
        }
        if (ini_entry->value != ini_entry->orig_value) {
            efree(ini_entry->value);
        }
       
        // ini_entry本身恢復(fù)到最原始的值
        ini_entry->value = ini_entry->orig_value;
        ini_entry->value_length = ini_entry->orig_value_length;
        ini_entry->modifiable = ini_entry->orig_modifiable;
        ini_entry->modified = 0;
        ini_entry->orig_value = NULL;
        ini_entry->orig_value_length = 0;
        ini_entry->orig_modifiable = 0;
    }
    return 0;
}

邏輯都蠻清晰的，相信讀者可以看明白。總結(jié)一下關(guān)于ini配置的恢復(fù)流程：

復(fù)制代碼 代碼如下:
php_request_shutdown--->zend_deactivate--->zend_ini_deactivate--->zend_restore_ini_entry_wrapper--->zend_restore_ini_entry_cb

3，配置的銷毀
在sapi生命周期結(jié)束的時(shí)候，比如apache關(guān)閉，cli程序執(zhí)行完畢等等。一旦進(jìn)入到這個(gè)階段，之前所說(shuō)的configuration_hash，EG(ini_directives)等都需要被銷毀，其用到的內(nèi)存空間需要被釋放。

1，php會(huì)依次結(jié)束所有的模塊，在每個(gè)模塊的php_MSHUTDOWN_FUNCTION中調(diào)用UNREGISTER_INI_ENTRIES。UNREGISTER_INI_ENTRIES和REGISTER_INI_ENTRIES對(duì)應(yīng)，但是UNREGISTER_INI_ENTRIES并不負(fù)責(zé)模塊全局空間的釋放，XXX_globals這塊內(nèi)存放在靜態(tài)數(shù)據(jù)區(qū)上，無(wú)需人為回收。

UNREGISTER_INI_ENTRIES主要做的事情，是將某個(gè)模塊的ini_entry配置從EG(ini_directives)表中刪除。刪除之后，ini_entry本身的空間會(huì)被回收，但是ini_entry->value不一定會(huì)被回收。

當(dāng)所有模塊的php_MSHUTDOWN_FUNCTION都調(diào)用UNREGISTER_INI_ENTRIES一遍之后，EG(ini_directives)中只剩下了Core模塊的ini配置。此時(shí)，就需要手動(dòng)調(diào)用UNREGISTER_INI_ENTRIES，來(lái)完成對(duì)Core模塊配置的刪除工作。

復(fù)制代碼 代碼如下:
void php_module_shutdown(TSRMLS_D)
{
    ...
   
    // zend_shutdown會(huì)依次關(guān)閉除了Core之外的所有php模塊
    // 關(guān)閉時(shí)會(huì)調(diào)用各個(gè)模塊的php_MSHUTDOWN_FUNCTION
    zend_shutdown(TSRMLS_C);
   
    ...

    // 至此，EG(ini_directives)中只剩下了Core模塊的配置
    // 這里手動(dòng)清理一下
    UNREGISTER_INI_ENTRIES();
   
    // 回收configuration_hash
    php_shutdown_config();

    // 回收EG(ini_directives)
    zend_ini_shutdown(TSRMLS_C);

    ...
}

當(dāng)手動(dòng)調(diào)用UNREGISTER_INI_ENTRIES完成之后，EG(ini_directives)已經(jīng)不包含任何的元素，理論上講，此時(shí)的EG(ini_directives)是一張空的hash表。

2，configuration_hash的回收發(fā)生在EG(ini_directives)之后，上面貼出的代碼中有關(guān)于php_shutdown_config的函數(shù)調(diào)用。php_shutdown_config主要負(fù)責(zé)回收configuration_hash。

復(fù)制代碼 代碼如下:
int php_shutdown_config(void)
{
    // 回收configuration_hash
    zend_hash_destroy(&configuration_hash);
   
    ...
   
    return SUCCESS;
}

注意zend_hash_destroy并不會(huì)釋放configuration_hash本身的空間，同XXX_G訪問(wèn)的模塊全局空間一樣，configuration_hash也是一個(gè)全局變量，無(wú)需手動(dòng)回收。

3，當(dāng)php_shutdown_config完成時(shí)，只剩下EG(ini_directives)的自身空間還沒被釋放。因此最后一步調(diào)用zend_ini_shutdown。zend_ini_shutdown用于釋放EG(ini_directives)。在前文已經(jīng)提到，此時(shí)的EG(ini_directives)理論上是一張空的hash表，因此該HashTable本身所占用的空間需要被釋放。

復(fù)制代碼 代碼如下:
ZEND_API int zend_ini_shutdown(TSRMLS_D)
{
    // EG(ini_directives)是動(dòng)態(tài)分配出的空間，需要回收
    zend_hash_destroy(EG(ini_directives));
    free(EG(ini_directives));
    return SUCCESS;
}

4，總結(jié)
用一張圖大致描述一下和ini配置相關(guān)的流程：

php技術(shù)：php中動(dòng)態(tài)修改ini配置，轉(zhuǎn)載需保留來(lái)源！

鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標(biāo)記有誤，請(qǐng)第一時(shí)間聯(lián)系我們修改或刪除，多謝。