php中动态修改ini配置


Posted in PHP onOctober 14, 2014

1,运行时改变配置
在前一篇中曾经谈到,ini_set函数可以在php执行的过程中,动态修改php的部分配置。注意,仅仅是部分,并非所有的配置都可以动态修改。关于ini配置的可修改性,参见:http://php.net/manual/zh/configuration.changes.modes.php

我们直接进入ini_set的实现,函数虽然有点长,但是逻辑很清晰:

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受到保护,不会被动态修改

    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;

        }

    }
    // 调用zend_alter_ini_entry_ex去动态修改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;

    }

}

可以看到,除了一些必要的验证工作,主要就是调用zend_alter_ini_entry_ex。

我们继续跟进到zend_alter_ini_entry_ex函数中:

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)中对应的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;

    }
    // 是否强制修改

    if (!force_change) {

        if (!(ini_entry->modifiable & modify_type)) {

            return FAILURE;

        }

    }
    // EG(modified_ini_directives)用于存放被修改过的ini_entry

    // 主要用做恢复

    if (!EG(modified_ini_directives)) {

        ALLOC_HASHTABLE(EG(modified_ini_directives));

        zend_hash_init(EG(modified_ini_directives), 8, NULL, NULL, 0);

    }

    

    // 将ini_entry中的值,值的长度,可修改范围,保留到orig_xxx中去

    // 以便在请求结束的时候,可以对ini_entry做恢复

    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);
    // 调用modify来更新XXX_G中对应的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处逻辑需要我们仔细体会:

1)ini_entry中的modified字段用来表示该配置是否被动态修改过。一旦该ini配置发生修改,modified就会被置为1。上述代码中有一段很关键:

// 如果多次调用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代码中调用几次ini_set,只有第一次ini_set时才会进入这段逻辑,设置好orig_value。从第二次调用ini_set开始,便不会再次执行这段分支,因为此时的modified已经被置为1了。因此,ini_entry->orig_value始终保存的是第一次修改之前的配置值(即最原始的配置)。

2)为了能使ini_set修改的配置立即生效,需要on_modify回调函数。

如前一篇文中所述,调用on_modify是为了能够更新模块的全局变量。再次回忆下,首先,模块全局变量中的配置已经不是字符串类型了,该用bool用bool、该用int用int。其次,每一个ini_entry中都存储了该模块全局变量的地址以及对应的偏移量,使得on_modify可以很迅速的进行内存修改。此外不要忘记,on_modify调用完了之后,仍需进一步更新ini_entry->value,这样EG(ini_directives)中的配置值就是最新的了。

3)这里出现了一张新的hash表,EG(modified_ini_directives)。

EG(modified_ini_directives)只用于存放被动态修改过的ini配置,如果一个ini配置被动态修改过,那么它既存在于EG(ini_directives)中,又存在于EG(modified_ini_directives)中。既然每一个ini_entry都有modified字段做标记,那岂不是可以遍历EG(ini_directives)来获得所有被修改过的配置呢?

答案是肯定的。个人觉得,这里的EG(modified_ini_directives)主要还是为了提升性能,酱直接遍历EG(modified_ini_directives)就足够了。此外,把EG(modified_ini_directives)的初始化推迟到zend_alter_ini_entry_ex中,也可以看出php在细节上的性能优化点。

2,恢复配置
ini_set的作用时间和php.ini文件的作用时间是不一样的,一旦请求执行结束,则ini_set会失效。此外,当我们代码中调用了ini_restore函数,则之前通过ini_set设置的配置也会失效。

每一个php请求执行完毕之后,会触发php_request_shutdown,它和php_request_startup是两个相对应过程。如果php是挂接在apache/nginx下,则每处理完一个http请求,就会调用php_request_shutdown;如果php以CLI模式来运行,则脚本执行完毕之后,也会调用php_request_shutdown。

在php_request_shutdown中,我们可以看到针对ini的恢复处理:

/* 7. Shutdown scanner/executor/compiler and restore ini entries */

zend_deactivate(TSRMLS_C);

进入zend_deactivate,可以进一步看到调用了zend_ini_deactivate函数,由zend_ini_deactivate来负责将php的配置进行恢复。

zend_try {

    zend_ini_deactivate(TSRMLS_C);

} zend_end_try();

具体来看看zend_ini_deactivate的实现:

ZEND_API int zend_ini_deactivate(TSRMLS_D) /* {{{ */

{

    if (EG(modified_ini_directives)) {

        // 遍历EG(modified_ini_directives)中这张表

        // 对每一个ini_entry调用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来看,真正恢复ini的任务最终落地到了zend_restore_ini_entry_wrapper回调函数。

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;
    // 只看修改过的ini项

    if (ini_entry->modified) {

        if (ini_entry->on_modify) {

            // 使用orig_value,对XXX_G内的相关字段进行重新设置

            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本身恢复到最原始的值

        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;

}

逻辑都蛮清晰的,相信读者可以看明白。总结一下关于ini配置的恢复流程:

php_request_shutdown--->zend_deactivate--->zend_ini_deactivate--->zend_restore_ini_entry_wrapper--->zend_restore_ini_entry_cb

3,配置的销毁
在sapi生命周期结束的时候,比如apache关闭,cli程序执行完毕等等。一旦进入到这个阶段,之前所说的configuration_hash,EG(ini_directives)等都需要被销毁,其用到的内存空间需要被释放。

1,php会依次结束所有的模块,在每个模块的PHP_MSHUTDOWN_FUNCTION中调用UNREGISTER_INI_ENTRIES。UNREGISTER_INI_ENTRIES和REGISTER_INI_ENTRIES对应,但是UNREGISTER_INI_ENTRIES并不负责模块全局空间的释放,XXX_globals这块内存放在静态数据区上,无需人为回收。

UNREGISTER_INI_ENTRIES主要做的事情,是将某个模块的ini_entry配置从EG(ini_directives)表中删除。删除之后,ini_entry本身的空间会被回收,但是ini_entry->value不一定会被回收。

当所有模块的PHP_MSHUTDOWN_FUNCTION都调用UNREGISTER_INI_ENTRIES一遍之后,EG(ini_directives)中只剩下了Core模块的ini配置。此时,就需要手动调用UNREGISTER_INI_ENTRIES,来完成对Core模块配置的删除工作。

void php_module_shutdown(TSRMLS_D)

{

    ...

    

    // zend_shutdown会依次关闭除了Core之外的所有php模块

    // 关闭时会调用各个模块的PHP_MSHUTDOWN_FUNCTION

    zend_shutdown(TSRMLS_C);

    

    ...
    // 至此,EG(ini_directives)中只剩下了Core模块的配置

    // 这里手动清理一下

    UNREGISTER_INI_ENTRIES();

    

    // 回收configuration_hash

    php_shutdown_config();
    // 回收EG(ini_directives)

    zend_ini_shutdown(TSRMLS_C);
    ...

}

当手动调用UNREGISTER_INI_ENTRIES完成之后,EG(ini_directives)已经不包含任何的元素,理论上讲,此时的EG(ini_directives)是一张空的hash表。

2,configuration_hash的回收发生在EG(ini_directives)之后,上面贴出的代码中有关于php_shutdown_config的函数调用。php_shutdown_config主要负责回收configuration_hash。

int php_shutdown_config(void)

{

    // 回收configuration_hash

    zend_hash_destroy(&configuration_hash);

    

    ...

    

    return SUCCESS;

}

注意zend_hash_destroy并不会释放configuration_hash本身的空间,同XXX_G访问的模块全局空间一样,configuration_hash也是一个全局变量,无需手动回收。

3,当php_shutdown_config完成时,只剩下EG(ini_directives)的自身空间还没被释放。因此最后一步调用zend_ini_shutdown。zend_ini_shutdown用于释放EG(ini_directives)。在前文已经提到,此时的EG(ini_directives)理论上是一张空的hash表,因此该HashTable本身所占用的空间需要被释放。

ZEND_API int zend_ini_shutdown(TSRMLS_D)

{

    // EG(ini_directives)是动态分配出的空间,需要回收

    zend_hash_destroy(EG(ini_directives));

    free(EG(ini_directives));

    return SUCCESS;

}

4,总结
用一张图大致描述一下和ini配置相关的流程:

php中动态修改ini配置

PHP 相关文章推荐
模板引擎正则表达式调试小技巧
Jul 20 PHP
php 强制下载文件实现代码
Oct 28 PHP
php Calender(日历)代码分享
Jan 03 PHP
php加速器eAccelerator的配置参数、API详解
May 05 PHP
PHP批量检测并去除文件BOM头代码实例
May 08 PHP
ThinkPHP查询语句与关联查询用法实例
Nov 01 PHP
php中debug_backtrace、debug_print_backtrace和匿名函数用法实例
Dec 01 PHP
PHP操作MySQL的mysql_fetch_* 函数的常见用法教程
Dec 25 PHP
PHP上传图片类显示缩略图功能
Jun 30 PHP
php 的反射详解及示例代码
Aug 25 PHP
php删除数组指定元素实现代码
May 03 PHP
PHP常用函数之根据生日计算年龄功能示例
Oct 21 PHP
php中的ini配置原理详解
Oct 14 #PHP
9段PHP实用功能的代码推荐
Oct 14 #PHP
五款PHP代码重构工具推荐
Oct 14 #PHP
ThinkPHP 表单自动验证运用示例
Oct 13 #PHP
php 模拟 asp.net webFrom 按钮提交事件实例
Oct 13 #PHP
ThinkPHP表单自动验证实例
Oct 13 #PHP
Linux下安装oracle客户端并配置php5.3
Oct 12 #PHP
You might like
PHP面向对象学习笔记之二 生成对象的设计模式
2012/10/06 PHP
PHP+Memcache实现wordpress访问总数统计(非插件)
2014/07/04 PHP
10个实用的PHP正则表达式汇总
2014/10/23 PHP
PHP中filter函数校验数据的方法详解
2015/07/31 PHP
使用ltrace工具跟踪PHP库函数调用的方法
2016/04/25 PHP
PHPCMS V9 添加二级导航的思路详解
2016/10/20 PHP
详谈phpAdmin修改密码后拒绝访问的问题
2017/04/03 PHP
javascript实现图片切换的幻灯片效果源代码
2012/12/12 Javascript
JS获取当前网页大小以及屏幕分辨率等
2014/09/05 Javascript
浅谈nodeName,nodeValue,nodeType,typeof 的区别
2015/01/13 Javascript
jQuery拖拽插件gridster使用指南
2015/04/21 Javascript
使用vue.js写一个tab选项卡效果
2017/03/25 Javascript
微信小程序中顶部导航栏的实现代码
2017/03/30 Javascript
微信小程序如何获取用户手机号
2018/01/26 Javascript
Vue resource三种请求格式和万能测试地址
2018/09/26 Javascript
小程序实现抽奖动画
2020/04/16 Javascript
node微信开发之获取access_token+自定义菜单
2019/03/17 Javascript
jQuery实现动态加载(按需加载)javascript文件的方法分析
2019/05/31 jQuery
vue项目中常见问题及解决方案(推荐)
2019/10/21 Javascript
js+css实现全屏侧边栏
2020/06/16 Javascript
Postman环境变量全局变量使用方法详解
2020/08/13 Javascript
[01:34]DOTA2 7.22版本新增神杖效果一览(敏捷英雄篇)
2019/05/28 DOTA
python获取一组数据里最大值max函数用法实例
2015/05/26 Python
Python自动化测试ConfigParser模块读写配置文件
2016/08/15 Python
python读取dicom图像示例(SimpleITK和dicom包实现)
2020/01/16 Python
python 爬虫如何实现百度翻译
2020/11/16 Python
关于探究python中sys.argv时遇到的问题详解
2021/02/23 Python
北卡罗来纳州豪华家具和家居装饰店:Carolina Rustica
2018/10/30 全球购物
Why do we need Unit test
2013/01/03 面试题
手机银行营销方案
2014/03/14 职场文书
开幕式邀请函
2015/01/31 职场文书
大学毕业生自我评价
2015/03/02 职场文书
2015年社区民政工作总结
2015/04/21 职场文书
史上最全书信经典范文大全(建议收藏)
2019/07/10 职场文书
Java9新特性之Module模块化编程示例演绎
2022/03/16 Java/Android
漫改真人电影「萌系男友是燃燃的橘色」公开先导视觉图
2022/03/21 日漫