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