PHP模組開發學習心得

最近在學習PHP模組開發相關的知識, 再看了dl()函數的流程之後, 對模組載入的處理流程做一個總結, 希望可以在PHP模組開發上協助到大家.

進入正題.

PHP的代碼架構

上圖摘自Extending and Embedding PHP(Sams).

從圖中可以看出, PHP所有的部分都處在一個被稱為TSRM的層中, TSRM層是負責安全執行緒管理的. 最底下的SAPI是對外提供服務的介面, 比如命令列的sapi為cli, php-fpm則是fastcgi的sapi, apache的模組方式也是一種sapi.

中間是PHP核心和Zend 引擎. 從圖中的文字可以看出, PHP核心負責要求管理/網路和檔案操作, Zend核心則負責編譯和執行/記憶體和資源的分配.

在所有這些之上, 是擴充層, PHP中多數對外介面都是通過擴充層來提供的, 比如, standard, string等語言基礎也被以擴充形式提供.

擴充(以後稱為模組)載入到PHP中的方式有兩種: 靜態編譯, 動態連結.

靜態編譯需要重建php的configure指令碼, 這裡不再贅述. 動態連結方式是將模組編譯為一個.so檔案, 然後動態載入到php中.

載入.so檔案的方式有兩種, 一種是將其寫到php.ini檔案中, 比如: extension=apc.so, 另外一種就是在代碼中使用dl(‘xxx.so’).

dl($library)

函數的作用就是把一個模組載入進來, 使其內部提供的能力可用.

dl()函數的原始碼在PHP原始碼根目錄(簡寫為PHP_SRC_HOME)下, PHP_SRC_HOME/ext/standard/dl.c, 處理關鍵流程如下:

PHP_FUNCTION(dl)

PHPAPI PHP_FUNCTION(dl)  {      //...      php_dl(filename, MODULE_TEMPORARY, return_value, 0 TSRMLS_CC);      //...   }

php_dl

PHPAPI void php_dl(char *file, int type, zval *return_value, int start_now TSRMLS_DC)  {      if (php_load_extension(file, type, start_now TSRMLS_CC) == FAILURE) {         //...  }

php_load_extension

PHPAPI int php_load_extension(char *filename, int type, int start_now TSRMLS_DC) {      //檔案名稱解析相關            //載入動態連結程式庫      handle = DL_LOAD(libpath);            //載入錯誤處理            //擷取模組的get_module函數(重點, 模組初始入口)      get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "get_module");            //get_module函數擷取錯誤處理            //那個get_module()得到struct zend_module_entry      module_entry = get_module();      //...            //註冊模組(重點, 函數在這裡被註冊)      if ((module_entry = zend_register_module_ex(module_entry TSRMLS_CC)) == NULL) {          //錯誤處理      }            //模組啟動(重點, PHP_MINIT_FUNCTION)      if ((type == MODULE_TEMPORARY || start_now) && zend_startup_module_ex(module_entry TSRMLS_CC) == FAILURE) {          //錯誤處理      }            //模組請求啟動(重點, PHP_RINIT_FUNCTION)      if ((type == MODULE_TEMPORARY || start_now) && module_entry->request_startup_func) {          //錯誤處理      }      return SUCCESS;  }