PHP 擴展與 ZEND 引擎的整合

        PHP 擴展是對 PHP 功能的一個補充，編寫完 PHP 擴展之後， ZEND 引擎須要獲取到 PHP 擴展的信息，好比 phpinfo() 函數是如何列出 PHP 擴展的信息，PHP 擴展中的函數如何提供給 PHP 程序員使用，這些是開發 PHP 擴展須要瞭解的內容。

 

        這些內容並不複雜，在開發 PHP 擴展時只要願意去了解一下相關的部分就能夠了，在這裏，我給出一個簡單的介紹。

 

        PHP 擴展中負責提供信息的結構體爲 zend_module_entry，該結構體的定義以下：

 1 struct _zend_module_entry {
 2     unsigned short size;
 3     unsigned int zend_api;
 4     unsigned char zend_debug;
 5     unsigned char zts;
 6     const struct _zend_ini_entry *ini_entry;
 7     const struct _zend_module_dep *deps;
 8     const char *name;
 9     const struct _zend_function_entry *functions;
10     int (*module_startup_func)(INIT_FUNC_ARGS);
11     int (*module_shutdown_func)(SHUTDOWN_FUNC_ARGS);
12     int (*request_startup_func)(INIT_FUNC_ARGS);
13     int (*request_shutdown_func)(SHUTDOWN_FUNC_ARGS);
14     void (*info_func)(ZEND_MODULE_INFO_FUNC_ARGS);
15     const char *version;
16     size_t globals_size;
17 #ifdef ZTS
18     ts_rsrc_id* globals_id_ptr;
19 #else
20     void* globals_ptr;
21 #endif
22     void (*globals_ctor)(void *global);
23     void (*globals_dtor)(void *global);
24     int (*post_deactivate_func)(void);
25     int module_started;
26     unsigned char type;
27     void *handle;
28     int module_number;
29     const char *build_id;
30 };

        有了上面的結構體之後，那麼 PHP 擴展的信息就已經有了，那麼就能夠將該結構體的信息提供給 ZEND 引擎，獲取該結構體信息的函數爲 get_module()，該函數的定義以下：

1 #define ZEND_GET_MODULE(name) \
2     BEGIN_EXTERN_C()\
3     ZEND_DLEXPORT zend_module_entry *get_module(void) { return &name##_module_entry; }\
4     END_EXTERN_C()

        get_module() 函數返回一個 zend_module_entry 結構體的指針，經過 ## 完成字符串的拼接，而後經過 & 取地址符得到結構體的內容便可。

 

        經過這兩部分就能夠完成 PHP 擴展到 ZEND 引擎的整合，不過好在 zend_module_entry 結構體會由擴展模板生成工具進行填充，而 get_module() 函數也不須要咱們本身去調用，可是整合的原理仍是要大致瞭解一下的，具體信息能夠閱讀相關的源碼去進行理解。

 

---

 

個人微信公衆號：「碼農UP2U」