【php7扩展开发三】ini配置

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

猜你喜欢

转载自blog.csdn.net/zhangge3663/article/details/115173245