php扩展开发-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_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

*/

#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))

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(字符串长度)，其余参数，内核会帮助我们自己补充，可以不需要关心

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 => Master Value
myext.ini_long => 100 => 100
myext.ini_string => 我是ini的字符串 => 我是ini的字符串

*/