【php7扩展开发三】ini配置

末蓝、 2022-11-12 13:52 155阅读 0赞

php.ini配置  
php.ini是PHP主要的配置文件，解析时PHP将在这些地方依次查找该文件：当前工作目录、环境变量PHPRC指定目录、编译时指定的路径，在命令行模式下，php.ini的查找路径可以用-c 参数替代。

该文件的语法非常简单： 配置标识符 = 值 。空白字符和用分号';'开始的行被忽略，\[xxx\]行也被忽略；配置标识符大写敏感，通常会用'.'区分不同的节；值可以是数字、字符串、PHP常量、位运算表达式。

关于php.ini的解析过程不作介绍，只从应用的角度介绍如何在一个扩展中获取一个配置项，通常会把php.ini的配置映射到一个变量，从而在使用时直接读取那个变量，也就是把所有的配置转化为了C语言中的变量，扩展中一般会把php.ini配置映射到上一篇介绍的全局变量(资源)https://blog.csdn.net/rorntuck7/article/details/86089246，要想实现这个转化需要在扩展中为每一项配置设置映射规则：

PHP_INI_BEGIN()
    //每一项配置规则
    ...
    PHP_INI_END()

这两个宏实际只是把各配置规则组成一个数组，配置规则通过 STD\_PHP\_INI\_ENTRY() 设置：

STD\_PHP\_INI\_ENTRY(name,default\_value,modifiable,on\_modify,property\_name,struct\_type,struct\_ptr)  
name: php.ini中的配置标识  
\_\_default\_value:\_\_ 默认值，注意不管转化后是什么类型，这里必须设置为字符  
modifiable:可修改等级，ZEND\_INI\_USER为可以在php脚本中修改，ZEND\_INI\_SYSTEM为可以在php.ini中修改，还有一个ZEND\_INI\_PERDIR，ZEND\_INI\_ALL表示三种都可以，通常情况下设置为ZEND\_INI\_ALL、ZEND\_INI\_SYSTEM即可  
\_\_on\_modify:\_\_函数指针，用于指定发现这个配置后赋值处理的函数，默认提供了5个：OnUpdateBool、OnUpdateLong、OnUpdateLongGEZero、OnUpdateReal、OnUpdateString、OnUpdateStringUnempty，支持可以自定义  
\_\_property\_name:\_\_ 要映射到的结构struct\_type中的成员  
\_\_struct\_type:\_\_ 映射结构的类型  
struct\_ptr:\_\_ 映射结构的变量地址，发现配置  
比如将php.ini中的 mytest.opene\_cache 值映射到 MYTEST\_G() 结构中的open\_cache，类型为zend\_long，默认值109，则可以这么定义：

PHP_INI_BEGIN()
    STD_PHP_INI_ENTRY("mytest.open_cache", "109", PHP_INI_ALL, OnUpdateLong, open_cache, zend_mytest_globals, mytest_globals)
    PHP_INI_END();

如果PHP提供的几个on\_modify不能满足需求可以自定义on\_modify函数，举个例子：将php.ini中的配置 mytest.class 插入MYTESY\_G(class\_table)哈希表，则可以在扩展中定义这样一个on\_modify： ZEND\_INI\_MH(OnUpdateAddArray) ，将php.ini映射到全局变量的完整代码：

//php_mytest.h
    #define MYTEST_G(v) ZEND_MODULE_GLOBALS_ACCESSOR(mytest, v)
    ZEND_BEGIN_MODULE_GLOBALS(mytest)
        zend_long open_cache;
        HashTable class_table;
    ZEND_END_MODULE_GLOBALS(mytest)
    //自定义on_modify函数
    ZEND_API ZEND_INI_MH(OnUpdateAddArray);
    //mytest.c
    ZEND_DECLARE_MODULE_GLOBALS(mytest)
     
    PHP_INI_BEGIN()
        STD_PHP_INI_ENTRY("mytest.open_cache", "109", PHP_INI_ALL, OnUpdateLong, open_cache, zend_mytest_globals, mytest_globals)
        STD_PHP_INI_ENTRY("mytest.class", "stdClass", PHP_INI_ALL, OnUpdateAddArray, class_table, zend_mytest_globals, mytest_globals)
    PHP_INI_END()
     
    ZEND_API ZEND_INI_MH(OnUpdateAddArray)
    {
        HashTable *ht;
        zval val;
        
        #ifndef ZTS
            char *base = (char *) mh_arg2;
        #else
            char *base;
            base = (char *) ts_resource(*((int *) mh_arg2));
        #endif
        
        ht = (HashTable*)(base+(size_t) mh_arg1);
        ZVAL_NULL(&val);
        zend_hash_add(ht, new_value, &val);
    }
     
    PHP_MINIT_FUNCTION(mytest)
    {
        zend_hash_init(&MYTEST_G(class_table), 0, NULL, NULL, 1);//将php.ini解析到指定结构体
        REGISTER_INI_ENTRIES();
        printf("open_cache %d\n", MYTEST_G(open_cache));
    }
     
    zend_module_entry mytest_module_entry = {
        STANDARD_MODULE_HEADER,
        "mytest",
        NULL,//mytest_functions,
        PHP_MINIT(mytest),
        NULL,//PHP_MSHUTDOWN(mytest),
        NULL,//PHP_RINIT(mytest),
        NULL,//PHP_RSHUTDOWN(mytest),
        NULL,//PHP_MINFO(mytest),
        "1.0.0",
        STANDARD_MODULE_PROPERTIES
    };
    #ifdef COMPILE_DL_TIMEOUT
    #ifdef ZTS
    ZEND_TSRMLS_CACHE_DEFINE()
    #endif
    ZEND_GET_MODULE(mytest)
    #endif