PHP扩展的加载流程

第一步，先完成一个最简单的扩展，只提供一个函数，hello。

主要代码：

ZEND_FUNCTION(hello)
{
    php_printf( " Hello World!\n ");
}

static zend_function_entry tonic_functions[] = {
    ZEND_FE(hello,        NULL)
    { NULL, NULL, NULL }
};

zend_module_entry tonic_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
     STANDARD_MODULE_HEADER,
#endif
     " tonic ", 
    tonic_functions,  /*  Functions  */
    NULL,  /*  MINIT  */
    NULL,  /*  MSHUTDOWN  */
    NULL,  /*  RINIT  */
    NULL,  /*  RSHUTDOWN  */
    NULL,  /*  MINFO  */
#if ZEND_MODULE_API_NO >= 20010901
     " 2.1 ", 
#endif
    STANDARD_MODULE_PROPERTIES
};

#ifdef COMPILE_DL_TONIC
ZEND_GET_MODULE(tonic)

#endif 

  

这几行代码，就完成了一个最简单的扩展了...

 ZEND_GET_MODULE宏展开如下：

#define ZEND_GET_MODULE(name) \
    BEGIN_EXTERN_C()\
    ZEND_DLEXPORT zend_module_entry *get_module( void) {  return &name##_module_entry; }\

    END_EXTERN_C() 

 这个宏，定义了一个名为get_module的函数，返回当前模块定义的zend_module_entry的指针。(通过这个宏可以发现，module_entry的名称，是固定格式的..不然就要自己实现get_module函数)

 

再看看php加载扩展的实现(我去掉了一些老版本兼容等与分析无关的代码) ：

PHPAPI  int php_load_extension( char *filename,  int type,  int start_now TSRMLS_DC)  /*  {{{  */
{
     void *handle;
     char *libpath;
    zend_module_entry *module_entry;
    zend_module_entry *(*get_module)( void); /* 函数指针，获取module的信息 */
     int error_type;
     char *extension_dir;

     if (type == MODULE_PERSISTENT) {
        extension_dir = INI_STR( " extension_dir ");
    }  else {
        extension_dir = PG(extension_dir);
    }

     if (type == MODULE_TEMPORARY) {
        error_type = E_WARNING;
    }  else {
        error_type = E_CORE_WARNING;
    }

     /*  Check if passed filename contains directory separators  */
     if (strchr(filename,  ' / ') != NULL || strchr(filename, DEFAULT_SLASH) != NULL) {
         /*  Passing modules with full path is not supported for dynamically loaded extensions  */
         if (type == MODULE_TEMPORARY) {
            php_error_docref(NULL TSRMLS_CC, E_WARNING,  " Temporary module name should contain only filename ");
             return FAILURE;
        }
        libpath = estrdup(filename);
    }  else  if (extension_dir && extension_dir[ 0]) {
         int extension_dir_len = strlen(extension_dir);

         if (IS_SLASH(extension_dir[extension_dir_len- 1])) {
            spprintf(&libpath,  0,  " %s%s ", extension_dir, filename);  /*  SAFE  */
        }  else {
            spprintf(&libpath,  0,  " %s%c%s ", extension_dir, DEFAULT_SLASH, filename);  /*  SAFE  */
        }
    }  else {
         return FAILURE;  /*  Not full path given or extension_dir is not set  */
    }

     /*  load dynamic symbol  */
    handle = DL_LOAD(libpath); /* 加载动态链接文件 */
     if (!handle) {
        php_error_docref(NULL TSRMLS_CC, error_type,  " Unable to load dynamic library '%s' - %s ", libpath, GET_DL_ERROR());
        GET_DL_ERROR();  /*  free the buffer storing the error  */

        efree(libpath);
         return FAILURE;
    }
    efree(libpath);

    get_module = (zend_module_entry *(*)( void)) DL_FETCH_SYMBOL(handle,  " get_module ");/* 获取动态链接库内部实现的get_module函数的指针供下面调用  */

     /*  Some OS prepend _ to symbol names while their dynamic linker
     * does not do that automatically. Thus we check manually for
     * _get_module.  */

     if (!get_module) {
        get_module = (zend_module_entry *(*)( void)) DL_FETCH_SYMBOL(handle,  " _get_module ");
    }

     if (!get_module) { /* 如果动态链接库没有实现get_module函数，或者函数原型与前面定义的不符，则不是合法的PHP扩展 */
        DL_UNLOAD(handle);
        php_error_docref(NULL TSRMLS_CC, error_type,  " Invalid library (maybe not a PHP library) '%s' ", filename);
         return FAILURE;
    }
    module_entry = get_module();/* 执行get_module函数，获取zend_module_entry的信息,这里是个指针 */
    
    module_entry->type = type;
    module_entry->module_number = zend_next_free_module();
    module_entry->handle = handle;

     if ((module_entry = zend_register_module_ex(module_entry TSRMLS_CC)) == NULL) {  /* 这里完成三个任务，第一判断此扩展依赖的其它扩展是否都已经正确加载，第二将扩展的module_entry添加到全局的module_registry这个HashTable中，第三，注册扩展提供的所有函数 */
        DL_UNLOAD(handle);
         return FAILURE;
    }

     if ((type == MODULE_TEMPORARY || start_now) && zend_startup_module_ex(module_entry TSRMLS_CC) == FAILURE) { /* 执行module_entry的MINIT函数 */
        DL_UNLOAD(handle);
         return FAILURE;
    }

     if ((type == MODULE_TEMPORARY || start_now) && module_entry->request_startup_func) {
         if (module_entry->request_startup_func(type, module_entry->module_number TSRMLS_CC) == FAILURE) { /* 执行module_entry的RINIT函数 */
            php_error_docref(NULL TSRMLS_CC, error_type,  " Unable to initialize module '%s' ", module_entry->name);
            DL_UNLOAD(handle);
             return FAILURE;
        }
    }
     return SUCCESS;

}