ini 原理分析

Author: zhoumengkang

book/chapt11/11-04-00-ini-set.markdown

@@ -16,6 +16,30 @@
 
 ### 声明
 
+`PHP_INI_ENTRY` 宏
+
+    [c]
+    /* main/php_ini.h */
+    #define PHP_INI_ENTRY		ZEND_INI_ENTRY
+    /* Zend/zend_ini.h */
+    ZEND_INI_ENTRY(name, default_value, modifiable, on_modify)
+    
+参数        	  |描述
+--------------|------------------------------------------------
+name          |ini 指令名
+default_value |默认值
+modifiable    |ini 指令可以被修改的位域
+on_modify     |修改 ini 指令的回调函数
+
+modifiable 可分为四种状态机：
+
+* ZEND_INI_USER  能够被用户脚本更改
+* ZEND_INI_PERDIR 能够在 .htaccess中更改
+* ZEND_INI_SYSTEM 能够在php.ini或http.conf等系统文件更改
+* ZEND_INI_ALL 能在所有地方更改
+
+关于 `on_modify` 参数的使用在下一小节使用 `STD_PHP_INI_ENTRY` 宏中使用
+
 打开`tipi_ini_demo.c`的`PHP_INI_BEGIN`宏和`PHP_INI_END`宏的注释。这里仅演示一个配置项
 
     [c]

book/chapt11/11-04-01-ini-set.markdown

@@ -2,14 +2,34 @@
 
 首先需要复习下[全局变量的使用](/book/?p=chapt11/11-03-00-global-var)，这里就不重复说明了。
 完整的代码可以参考[配合全局变量添加 INI Demo](https://github.com/reeze/tipi/tree/master/book/sample/chapt11/11-04-01-ini-set/)
-与上面的步骤中不同的地方仅仅是把 `PHP_INI_BEGIN` 宏和 `PHP_INI_END` 宏中申明 INI 变量的宏不一样
+与上面的步骤中不同的地方仅仅是把 `PHP_INI_BEGIN` 宏和 `PHP_INI_END` 宏中申明 INI 变量的宏不一样。
+
+### STD_PHP_INI_ENTRY 宏
+
+    [c]
+    /* main/php_ini.h */
+    #define STD_PHP_INI_ENTRY		STD_ZEND_INI_ENTRY
+    /* Zend/zend_ini.h */
+    STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr)
+
+参数        	  |描述
+--------------|------------------------------------------------
+name          |ini 指令名
+default_value |默认值
+modifiable    |ini 指令可以被修改的位域
+on_modify     |修改 ini 指令的回调函数
+property_name |应当被更新的变量名
+struct_type   |变量驻留的结构类型，通常使用全局变量。
+struct_ptr    |全局变量结构体指针
+
+### 声明
 
     [c]
     PHP_INI_BEGIN()
         STD_PHP_INI_ENTRY("tipi_ini_demo.global_value", "42", PHP_INI_ALL, OnUpdateLong, global_value, zend_tipi_ini_demo_globals, tipi_ini_demo_globals)
     PHP_INI_END()
 
-其他注册、注销，使用和前一小节一样，不过配合全局变量使用时，也通过全局变量宏来 INI 的值。
+其他注册、注销，使用和前一小节一样，不过配合全局变量使用时，也通过全局变量宏来读取 INI 的值。
 
     [c]
     RETURN_LONG(TIPI_INI_DEMO_G(global_value));

book/chapt11/11-04-02-ini-set.markdown

@@ -42,7 +42,7 @@ PHP7 中新定义了一个数据结构 `zend_ini_entry_def` 作为传入函数 `
 
 ### 声明变量
 
-#### 使用 `PHP_INI_ENTRY` 宏
+#### 使用 PHP_INI_ENTRY 宏
 
     [c]
     PHP_INI_BEGIN()
@@ -60,7 +60,19 @@ PHP7 中新定义了一个数据结构 `zend_ini_entry_def` 作为传入函数 `
 PHP5 中则是 `zend_ini_entry` 结构体数组，注意有所变化。
 `PHP_INI_END()`是在 `ini_entries[]` 末尾添加了一个空的 `zend_ini_entry_def` 数组元素，这样方便在 `while` 循环读取 `ini_entries[]` 时通过获取下一个元素的 `name` 是否为 NULL 来判断是否结束循环，防止数组越界。
 
-上面使用 `PHP_INI_ENTRY` 宏相当于声明了一个`zend_ini_entry_def`结构体，仅仅设置了名称、默认值和可以修改的时机这三个值。
+使用 `PHP_INI_ENTRY` 宏相当于声明了一个`zend_ini_entry_def`结构体，仅仅设置了名称、默认值和可以修改的时机这三个值。
+
+#### 使用 STD_PHP_INI_ENTRY 宏
+
+    [c]
+    PHP_INI_BEGIN()
+        STD_PHP_INI_ENTRY("tipi_ini_demo.global_value", "42", PHP_INI_ALL, OnUpdateLong, global_value, zend_tipi_ini_demo_globals, tipi_ini_demo_globals)
+    PHP_INI_END()
+    
+其参数的作用，在上一节已说明。
+其作用呢，实际是把 INI 指令值和全局变量指针 `tipi_ini_demo_globals` 关联起来，
+比如这里的 INI 指令 `tipi_ini_demo.global_value` 就与 `tipi_ini_demo_globals->global_value` 关联。
+当在更新该 INI 指令时，则根据 `ZEND_INI_MH(OnUpdateLong)` 来更新 `tipi_ini_demo_globals->global_value` 。 
 
 ### 注册
 
@@ -151,4 +163,6 @@ PHP5 中则是 `zend_ini_entry` 结构体数组，注意有所变化。
     }
 
 因为前面注册的时候是以一个 `zend_ini_entry` 的 `name` 字段作为 `key` 存储的，所以这里也是根据传入的 `name` 在
-`EG(ini_directives)` 中查找。
+`EG(ini_directives)` 中查找。
+
+销毁和注册类似，也不再做过多的阐述，重点还是自己跟一跟代码，手动敲一敲。这一节的分析就写到这里。