首页 > 代码库 > php扩展开发-INI配置
php扩展开发-INI配置
php.ini文件是用来保存各项扩展配置的文件,每个扩展都或多或少需要有一个定制化的配置,ini文件是一个很好的保存配置的方式,我们来看下怎么在自己的扩展里,使用到ini的配置功能
//创建ini的配置项
#include "php_ini.h"
//ini配置的创建和全局变量的类似,通过宏定义创建一个结构体,来保存INI的配置项
//参数说明:
//1,配置名称
//2,配置值
//3,作用域
//4,修改时的回调函数,可以为NULL PHP_INI_BEGIN() PHP_INI_ENTRY("myext.ini_string","我是ini的字符串",PHP_INI_ALL,myext_example_ini_callback) PHP_INI_ENTRY("myext.ini_long","100",PHP_INI_ALL,NULL) PHP_INI_END()
//在入口增加PHP_MSHUTDOWN(myext)函数 zend_module_entry myext_module_entry = { #if ZEND_MODULE_API_NO >= 20010901 STANDARD_MODULE_HEADER, #endif "myext",//扩展名称 myext_functions,//zend_function_entry myext_functions 定义好的函数扩展变量 PHP_MINIT(myext),//MINIT_FUNCTION PHP_MSHUTDOWN(myext),//PHP_MSHUTDOWN(myext),//MSHUTDOWN_FUNCTION PHP_RINIT(myext),//RINIT_FUNCTION PHP_RSHUTDOWN(myext),//RSHUTDOWN_FUNCTION PHP_MINFO(myext),//MINFO_FUNCTION #if ZEND_MODULE_API_NO >= 20010901 PHP_MYEXT_VERSION, #endif STANDARD_MODULE_PROPERTIES }; PHP_MINIT_FUNCTION(myext) { //注册INI配置 REGISTER_INI_ENTRIES(); return SUCCESS; } PHP_MSHUTDOWN_FUNCTION(myext) {
//销毁INI配置 UNREGISTER_INI_ENTRIES(); return SUCCESS; }
//PHP_INI_ENTRY中的回调函数
ZEND_INI_MH(myext_example_ini_callback){
if(new_value_length == 0 || strcmp(new_value,"no_allow_string") == 0){
return FAILURE;
}
return SUCCESS;
}
/*
var_dump(ini_get(‘myext.ini_string‘));
ini_set(‘myext.ini_string‘,‘我是新的INI字符串‘);
var_dump(ini_get(‘myext.ini_string‘));
var_dump(ini_get(‘myext.ini_long‘));
ini_set(‘myext.ini_long‘,‘101‘);
var_dump(ini_get(‘myext.ini_long‘));
string(21) "我是ini的字符串"
string(24) "我是新的INI字符串"
string(3) "100"
string(3) "101"
*/
我们来看一下刚才PHP_INI_ENTRY函数中第三个参数作用域的问题
参数 | 描述 |
PHP_INI_PERDIR | 指令可以在php.ini、httpd.conf或.htaccess文件中修改 |
PHP_INI_SYSTEM | 指令可以在php.ini 和 httpd.conf 文件中修改 |
PHP_INI_USER | 指令可以在用户脚本中修改 |
PHP_INI_ALL | 指令可以在任何地方修改 |
怎么能在扩展中访问ini的配置项呢
PHP_FUNCTION(myext_example_ini);//php_myext.c PHP_FE(myext_example_ini, NULL)//每个函数一行,第一个参数与PHP_FUNCTION(name)的name一样 PHP_FUNCTION(myext_example_ini){ const char * ini_string = INI_STR("myext.ini_string");//获取当前值 long ini_long = INI_INT("myext.ini_long"); php_printf("ini_string => %s\n",ini_string); php_printf("ini_long => %ld\n",ini_long); const char * orig_ini_string = INI_ORIG_STR("myext.ini_string");//获取默认值 long orig_ini_long = INI_ORIG_INT("myext.ini_long"); php_printf("orig_ini_string => %s\n",orig_ini_string); php_printf("orig_ini_long => %ld\n",orig_ini_long); }
/*
myext_example_ini();
ini_set(‘myext.ini_string‘,‘我是新的INI字符串‘);
ini_set(‘myext.ini_long‘,‘101‘);
myext_example_ini();
ini_string => 我是ini的字符串
ini_long => 100
orig_ini_string => 我是ini的字符串
orig_ini_long => 100
//上面是修改前,下面是修改后
ini_string => 我是新的INI字符串
ini_long => 101
orig_ini_string => 我是ini的字符串
orig_ini_long => 100
*/
INI的配置项一共有四种类型,所有INI_STR和INI_ORIG_STR分别有四种不同类型的组合
#define INI_INT(name) zend_ini_long((name), sizeof(name), 0) #define INI_FLT(name) zend_ini_double((name), sizeof(name), 0) #define INI_STR(name) zend_ini_string_ex((name), sizeof(name), 0, NULL) #define INI_BOOL(name) ((zend_bool) INI_INT(name)) #define INI_ORIG_INT(name) zend_ini_long((name), sizeof(name), 1) #define INI_ORIG_FLT(name) zend_ini_double((name), sizeof(name), 1) #define INI_ORIG_STR(name) zend_ini_string((name), sizeof(name), 1) #define INI_ORIG_BOOL(name) ((zend_bool) INI_ORIG_INT(name))
在PHP_INI_ENTRY函数中第四个参数是一个回调函数,在ini配置项被修改的时候,这个函数会被调用,这个的作用在于,你可以对设置的值进行过滤,不符合要求的可以返回FAILER让本次修改不生效。
ZEND_INI_MH(myext_example_ini_callback){//这个函数需要用ZEND_INI_MH来定义,跟ZEND_FUNCTION不一样
if(new_value_length == 0 || strcmp(new_value,"no_allow_string") == 0)//如果字符串为空或字符串=no_allow_string就不允许设置
{
return FAILURE; //本次修改不会生效
}
return SUCCESS;
}
#define ZEND_INI_MH(name) int name(zend_ini_entry *entry, char *new_value, uint new_value_length, void *mh_arg1, void *mh_arg2, void *mh_arg3, int stage TSRMLS_DC)
//宏展开以后这里有很多参数,这里面我们会用到的是修改值的new_value(字符串内容)和new_value_length(字符串长度),其余参数,内核会帮助我们自己补充,可以不需要关心
我们经常需要通过phpinfo或php -i来查询当前有效的ini配置项目,所以当我们开发扩展的时候,最好也把当前配置的信息写到PHP_MINFO_FUNCTION的函数中,结合前面说的MINFO部分的知识,以及刚才说到读取INI配置项的知识,我们可以自己实现这个功能,幸运的是,Zend的内核以及帮我们考虑到了,所有我们只要用以下代码就可以做到了。
PHP_MINFO_FUNCTION(myext){ php_info_print_table_start(); php_info_print_table_row(2, "version", PHP_MYEXT_VERSION); php_info_print_table_row(2, "writer", "zhangxiaomin"); php_info_print_table_end(); DISPLAY_INI_ENTRIES();//只要增加这一行就可以了/ }
/*
php5.6 -i //命令行
myext
version => 1.0
writer => zhangxiaomin
Directive => Local Value =http://www.mamicode.com/> Master Value
myext.ini_long => 100 => 100
myext.ini_string => 我是ini的字符串 => 我是ini的字符串
*/
ba
php扩展开发-INI配置