Merge pull request Leon2012#1 from sunzy/master

Update 02.md

Author: Leon2012

02.md

@@ -24,7 +24,7 @@
 
 	static PHP_FUNCTION(params_add) {
     	long a,b;
-    	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &a, &b) == FALSE) {
+    	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &a, &b) == FAILURE) {
         	return;
     	}
     	RETURN_LONG(a+b);
@@ -60,7 +60,7 @@
 	//宏说明
 	ZEND_BEGIN_ARG_INFO(name, pass_rest_by_reference) //开始参数块定义，pass_rest_by_reference为1时，强制所有参数为引用类型
 	ZEND_END_ARG_INFO() //结束参数块定义
-	ZEND_ARG_INFO //声明普通参数，可以用来表示PHP中的int, float, double, string等基本数组类型
+	ZEND_ARG_INFO //声明普通参数，可以用来表示PHP中的int, float, double, string等基本数据类型
 	ZEND_ARG_OBJ_INFO //声明对象类型的参数
 	ZEND_ARG_ARRAY_INFO //声明数组类型的参数
 	ZEND_ARG_PASS_INFO(pass_by_ref)	 //pass_by_ref为1时，强制设置后续的参数为引用类型 
@@ -173,4 +173,4 @@
 
 
 
-		
+		

04.md

@@ -1,131 +1,225 @@
 # INI参数设置
 
-1，创建一个新的扩展
+## 创建一个新的扩展
 
-	./ext_skel --extname=inis
++ 生成扩展
 
-2，宏
+```
+./ext_skel --extname=inis
+```
 
-	#define ZEND_DECLARE_MODULE_GLOBALS(module_name) ts_rsrc_id module_name##_globals_id;
-	
-	#define STD_PHP_INI_ENTRY		STD_ZEND_INI_ENTRY
-	#define STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
-	ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr##_id)
-	#define ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, arg3, displayer) \
++ config.m4
+
+```
+PHP_ARG_ENABLE(inis, whether to enable inis support,
+[  --enable-inis           Enable inis support])
+
+if test "$PHP_INIS" != "no"; then
+  PHP_NEW_EXTENSION(inis, inis.c, $ext_shared)
+fi
+```
+
++ php_inis.h
+
+```
+ZEND_BEGIN_MODULE_GLOBALS(inis)
+    char *name;
+    long level;
+ZEND_END_MODULE_GLOBALS(inis)
+
+#ifdef ZTS 
+#define INIS_G(v) TSRMG(inis_globals_id, zend_inis_globals *, v) 
+#else 
+#define INIS_G(v) (inis_globals.v) 
+#endif 
+```
+
++ inis.c
+
+定义全局变量
+
+```c
+ZEND_DECLARE_MODULE_GLOBALS(inis)
+```
+
+设置INI参数
+
+```c
+PHP_INI_BEGIN()
+     STD_PHP_INI_ENTRY("inis.name","sunzy",PHP_INI_ALL,OnUpdateString,name,zend_inis_globals,inis_globals)
+     STD_PHP_INI_ENTRY("inis.level","1",PHP_INI_ALL,OnUpdateLong,level,zend_inis_globals,inis_globals)
+PHP_INI_END()
+```
+
+初始化函数
+
+```c
+static void php_inis_init_globals(zend_inis_globals *inis_globals)
+{
+    inis_globals->name="sunzy.org";
+    inis_globals->level=10;
+}
+```
+
+注册&清除INI变量
+
+```c
+PHP_MINIT_FUNCTION(inis)
+{
+    REGISTER_INI_ENTRIES();
+    return SUCCESS;
+}
+
+PHP_MSHUTDOWN_FUNCTION(inis)
+{
+    UNREGISTER_INI_ENTRIES();
+    return SUCCESS;
+}
+```
+
+自定义函数
+
+```c
+PHP_FUNCTION(inis_report)
+{
+    php_printf("Name:%s\n",INIS_G(name));
+    php_printf("Level:%d\n",INIS_G(level));
+}
+```
+
+注册自定义函数
+
+```c
+const zend_function_entry inis_functions[] = {
+    PHP_FE(inis_report,NULL)
+    PHP_FE_END  /* Must be the last line in inis_functions[] */
+};
+```
+
++ 测试
+
+测试脚本
+
+```php
+$function = "inis_report";
+call_user_func($function);
+```
+
+测试
+
+```shell
+$ /usr/local/php5.6.9/bin/php -q inis.php
+Functions available in the test extension:
+inis_report
+Name:sunzy
+Level:1
+```
+
+修改php.ini
+
+```
+inis.name=test
+inis.level=2
+```
+
+```shell
+$ /usr/local/php5.6.9/bin/php -q inis.php
+Functions available in the test extension:
+inis_report
+Name:test
+Level:2
+```
+
+
+## 相关的宏
+
++ ZEND_DECLARE_MODULE_GLOBALS ->Zend/zend_API.h
+
+
+```c
+#ifdef ZTS
+#define ZEND_DECLARE_MODULE_GLOBALS(module_name)	\
+	ts_rsrc_id module_name##_globals_id;
+#else
+#define ZEND_DECLARE_MODULE_GLOBALS(module_name)							\
+	zend_##module_name##_globals module_name##_globals;
+#endif
+```
+
+```ts_rsrc_id```是[线程安全](http://walu.cc/phpbook/1.4.md)里的内容
+
++ PHP_INI_BEGIN、PHP_INI_END、STD_PHP_INI_ENTRY ->main/php_ini.h
+
+```c
+#define PHP_INI_BEGIN		ZEND_INI_BEGIN
+#define PHP_INI_END		ZEND_INI_END
+#define STD_PHP_INI_ENTRY	STD_ZEND_INI_ENTRY
+```
+
++ ZEND_INI_BEGIN、ZEND_INI_END、STD_ZEND_INI_ENTRY -> Zend/zend_ini.h
+
+```c
+#define ZEND_INI_BEGIN()		static const zend_ini_entry ini_entries[] = {
+#define ZEND_INI_END()		{ 0, 0, NULL, 0, NULL, NULL, NULL, NULL, NULL, 0, NULL, 0, 0, 0, NULL } };
+
+#define ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, arg3, displayer) \
 	{ 0, modifiable, name, sizeof(name), on_modify, arg1, arg2, arg3, default_value, sizeof(default_value)-1, NULL, 0, 0, 0, displayer },
-	
-	#define ZEND_INI_BEGIN()		static const zend_ini_entry ini_entries[] = {
-	#define ZEND_INI_END()		{ 0, 0, NULL, 0, NULL, NULL, NULL, NULL, NULL, 0, NULL, 0, 0, 0, NULL } };
-	
-	//注册ini变量，在minit中调用
-	#define REGISTER_INI_ENTRIES() zend_register_ini_entries(ini_entries, module_number TSRMLS_CC)
-	
-	//清除ini变量，在mshutdown中调用
-	#define UNREGISTER_INI_ENTRIES() zend_unregister_ini_entries(module_number TSRMLS_CC)
-	
-	//在phpinfo中显示变量值，在minfo中调用
-	#define DISPLAY_INI_ENTRIES() display_ini_entries(zend_module)
-	
-	//
-	
-3，定义ini变量
-
-	struct _zend_ini_entry {
-		int module_number;
-		int modifiable;
-		char *name;
-		uint name_length;
-		ZEND_INI_MH((*on_modify));
-		void *mh_arg1;
-		void *mh_arg2;
-		void *mh_arg3;
-
-		char *value;
-		uint value_length;
-
-		char *orig_value;
-		uint orig_value_length;
-		int orig_modifiable;
-		int modified;
-
-		void (*displayer)(zend_ini_entry *ini_entry, int type);
-	};
-	
-	//第二个参数即为ini变量的初始值
-	PHP_INI_BEGIN()
-    	STD_PHP_INI_ENTRY("inis.enable",      "1", PHP_INI_ALL, OnUpdateBool, enable, zend_inis_globals, inis_globals)
-    	STD_PHP_INI_ENTRY("inis.name", "", PHP_INI_ALL, OnUpdateString, name, zend_inis_globals, inis_globals)
-    	STD_PHP_INI_ENTRY("inis.level", "0", PHP_INI_ALL, OnUpdateLong, level, zend_inis_globals, inis_globals)
-	PHP_INI_END()
-	
-	#展开后
-	
-	static const zend_ini_entry ini_entries[] = {//BEGIN
-		{0, PHP_INI_ALL, "inis.enable", sizeof("inis.enable"), OnUpdateBool, enable, zend_inis_globals, inis_globals... }//inis.enable定义
-		...
-		{ 0, 0, NULL, 0, NULL, NULL, NULL, NULL, NULL, 0, NULL, 0, 0, 0, NULL } //END
-	};
-	
-	/*初始化ini值的宏*/
-	ZEND_INIT_MODULE_GLOBALS(module_name, globals_ctor, globals_dtor)
-	
-	#module_name 	与传递给ZEND_BEGIN_MODULE_GLOBALS()宏相同的扩展名称。
-	#globals_ctor 	构造函数指针。在myfile扩展里，函数原形与void php_myfile_init_globals(zend_myfile_globals *myfile_globals)类似
-	#globals_dtor 	析构函数指针。例如，php_myfile_init_globals(zend_myfile_globals *myfile_globals)
-	
-4，注册/清除/显示 ini变量
 
-	PHP_MINIT_FUNCTION(inis)
-	{
-		REGISTER_INI_ENTRIES();
-		return SUCCESS;
-	}
-	
-	PHP_MSHUTDOWN_FUNCTION(inis)
-	{
-		UNREGISTER_INI_ENTRIES();
-		return SUCCESS;
-	}
-	
-	PHP_MINFO_FUNCTION(inis)
-	{
-		php_info_print_table_start();
-		php_info_print_table_header(2, "inis support", "enabled");
-		php_info_print_table_end();
-
-		DISPLAY_INI_ENTRIES();
-	}
-	
-5，获取ini变量的值
+#define ZEND_INI_ENTRY3(name, default_value, modifiable, on_modify, arg1, arg2, arg3) \
+	ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, arg3, NULL)
 
-	//INIS_G宏即是用于获取ini变量的值的方法
-	PHP_FUNCTION(inis_report) {
-    	php_printf("Name:%s\n", INIS_G(name));
-    	php_printf("Level:%d\n", INIS_G(level));
-	}
-	
-	
-6，修改ini变量
-	
-	#编辑php.ini文件
-	vi /etc/php/php.ini
-	
-	#添加动态库，并修改其默认值
-	extension=inis.so
-	inis.name = leon123
-	inis.level = 200
+#define ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, arg1, arg2, displayer) \
+	ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, NULL, displayer)
+
+#define ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, arg1, arg2) \
+	ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, arg1, arg2, NULL)
 
-	#运行，ini变量的值变成为上面修改过的值
-	kentchentekiiMac-23868:inis kentchen$ php -q inis.php 
-	Functions available in the test extension:
-	inis_report
-	Name:leon123
-	Level:200
+#ifdef ZTS
+#define STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
+	ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr##_id)
+#else
+#define STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
+	ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr)
+#endif
+
+```
+
+前面扩展中对ini变量的定义展开后
+
+```c
+static const zend_ini_entry ini_entries[] = {//BEGIN
+	{0, PHP_INI_ALL, "inis.enable", sizeof("inis.enable"), OnUpdateBool, enable, zend_inis_globals, inis_globals... }//inis.enable定义
+	...
+	{ 0, 0, NULL, 0, NULL, NULL, NULL, NULL, NULL, 0, NULL, 0, 0, 0, NULL } //END
+};
+```
+	
++ REGISTER_INI_ENTRIES、UNREGISTER_INI_ENTRIES ->Zend/zend_ini.h
+
+```c
+#define REGISTER_INI_ENTRIES() zend_register_ini_entries(ini_entries, module_number TSRMLS_CC) //注册ini变量
+#define UNREGISTER_INI_ENTRIES() zend_unregister_ini_entries(module_number TSRMLS_CC) //清除ini变量
+#define DISPLAY_INI_ENTRIES() display_ini_entries(zend_module)  //在phpinfo中显示变量值
+```
+
+
++ ZEND_INIT_MODULE_GLOBALS  ->Zend/zend_ini.h
+
+```c
+#ifdef ZTS
+#define ZEND_INIT_MODULE_GLOBALS(module_name, globals_ctor, globals_dtor)	\
+	ts_allocate_id(&module_name##_globals_id, sizeof(zend_##module_name##_globals), (ts_allocate_ctor) globals_ctor, (ts_allocate_dtor) globals_dtor);
+#else
+#define ZEND_INIT_MODULE_GLOBALS(module_name, globals_ctor, globals_dtor)	\
+	globals_ctor(&module_name##_globals);
+#endif
+```
+初始化ini值的宏	
+
+> module_name 	与传递给ZEND_BEGIN_MODULE_GLOBALS()宏相同的扩展名称。
+
+> globals_ctor 	构造函数指针。在myfile扩展里，函数原形与void php_myfile_init_globals(zend_myfile_globals *myfile_globals)类似
+
+> globals_dtor 	析构函数指针。例如，php_myfile_init_globals(zend_myfile_globals *myfile_globals)
 	
-	#注释php.ini里设置值的语句，ini变量值变回了默认值
-	kentchentekiiMac-23868:inis kentchen$ php -q inis.php 
-	Functions available in the test extension:
-	inis_report
-	Name:leon peng
-	Level:100