msgbartop
PHP语言, PHP扩展, Zend引擎相关的研究,技术,新闻分享 – 左手代码 右手诗
msgbarbottom

14 Jun 09 深入理解PHP原理之扩展载入过程

why xdebug extension must be loaded as a zend extension?

what is zend extension and what are the differents between regular php extension and zend extension?

let’s start from that the extension loading process.

PHP是可以被扩展的, PHP的核心引擎Zend Engine也是可以被扩展的, 如果你也对Apache Module的编写也有所了解的话, 那么, 你就会对如下的结构很熟悉了:

struct _zend_extension {
        char *name;
        char *version;
        char *author;
        char *URL;
        char *copyright;
        startup_func_t startup;
        shutdown_func_t shutdown;
        activate_func_t activate;
        deactivate_func_t deactivate;
        message_handler_func_t message_handler;
        op_array_handler_func_t op_array_handler;
        statement_handler_func_t statement_handler;
        fcall_begin_handler_func_t fcall_begin_handler;
        fcall_end_handler_func_t fcall_end_handler;
        op_array_ctor_func_t op_array_ctor;
        op_array_dtor_func_t op_array_dtor;
        int (*api_no_check)(int api_no);
        void *reserved2;
        void *reserved3;
        void *reserved4;
        void *reserved5;
        void *reserved6;
        void *reserved7;
        void *reserved8;
        DL_HANDLE handle;
        int resource_number;
};

然后, 让我们对比下PHP extension的module entry:

	struct _zend_module_entry {
		unsigned short size;
		unsigned int zend_api;
		unsigned char zend_debug;
		unsigned char zts;
		struct _zend_ini_entry *ini_entry;
		struct _zend_module_dep *deps;
		char *name;
		struct _zend_function_entry *functions;
		int (*module_startup_func)(INIT_FUNC_ARGS);
		int (*module_shutdown_func)(SHUTDOWN_FUNC_ARGS);
		int (*request_startup_func)(INIT_FUNC_ARGS);
		int (*request_shutdown_func)(SHUTDOWN_FUNC_ARGS);
		void (*info_func)(ZEND_MODULE_INFO_FUNC_ARGS);
		char *version;
		size_t globals_size;
	#ifdef ZTS
		ts_rsrc_id* globals_id_ptr;
	#else
		void* globals_ptr;
	#endif
		void (*globals_ctor)(void *global TSRMLS_DC);
		void (*globals_dtor)(void *global TSRMLS_DC);
		int (*post_deactivate_func)(void);
		int module_started;
		unsigned char type;
		void *handle;
		int module_number;
	};

上面的结构, 可以结合我之前的文章用C/C++扩展你的PHP来帮助理解.

恩,回到主题:既然Xdebug要以Zend Extension方式加载, 那么它必然有基于Zend Extension的需求, 会是什么呢?

恩, 我们知道Xdebug有profile PHP的功能, 对, 就是statement_handler:
the statement handler callback inserts an additional opcode at the end of every statement in a script in which the callback is called. One of the primary uses for this sort of callback is to implement per-line profiling, stepping debuggers, or code-coverage utilities.

并且,因为Xdebug也提供了给用户脚本使用的函数, 所以, 它也会有部分PHP extension的实现, 并且由于它要以ZendExt方式载入的原因,所以它必须自己实现本身PHPExt部分的载入过程.

最后, 将PHP Extension的载入过程罗列如下(我会慢慢加上注释), 当然, 如果你等不及想知道, 也欢迎你直接在我的博客风雪之隅留言探讨.

以apache/mod_php5.c为例

1. 在mod_php5.c中,定义了Apache模块结构:

	module MODULE_VAR_EXPORT php5_module =
	{
		STANDARD_MODULE_STUFF,
		php_init_handler,           /* initializer */
		php_create_dir,             /* per-directory config creator */
		php_merge_dir,              /* dir merger */
		NULL,                       /* per-server config creator */
		NULL,                       /* merge server config */
		php_commands,               /* command table */
		php_handlers,               /* handlers */
		NULL,                       /* filename translation */
		NULL,                       /* check_user_id */
		NULL,                       /* check auth */
		NULL,                       /* check access */
		NULL,                       /* type_checker */
		NULL,                       /* fixups */
		NULL                        /* logger */
	#if MODULE_MAGIC_NUMBER >= 19970103
		, NULL                      /* header parser */
	#endif
	#if MODULE_MAGIC_NUMBER >= 19970719
		, NULL                      /* child_init */
	#endif
	#if MODULE_MAGIC_NUMBER >= 19970728
		, php_child_exit_handler        /* child_exit */
	#endif
	#if MODULE_MAGIC_NUMBER >= 19970902
		, NULL                      /* post read-request */
	#endif
	};
/* }}} */

可见, 最开始被调用的将会是php_init_handler,

static void php_init_handler(server_rec *s, pool *p)
{
    register_cleanup(p, NULL, (void (*)(void *))apache_php_module_shutdown_wrapper, (void (*)(void *))php_module_shutdown_for_exec);
    if (!apache_php_initialized) {
        apache_php_initialized = 1;
#ifdef ZTS
        tsrm_startup(1, 1, 0, NULL);
#endif
        sapi_startup(&apache_sapi_module);
        php_apache_startup(&apache_sapi_module);
    }
#if MODULE_MAGIC_NUMBER >= 19980527
    {
        TSRMLS_FETCH();
        if (PG(expose_php)) {
            ap_add_version_component("PHP/" PHP_VERSION);
        }
    }
#endif
}

这里, 调用了sapi_startup, 这部分是初始化php的apache sapi,
然后是调用,php_apache_startup:

static int php_apache_startup(sapi_module_struct *sapi_module)
{
    if (php_module_startup(sapi_module, &apache_module_entry, 1) == FAILURE) {
        return FAILURE;
    } else {
        return SUCCESS;
    }
}

这个时候,调用了php_module_startup, 其中有:

/* this will read in php.ini, set up the configuration parameters,
       load zend extensions and register php function extensions
       to be loaded later */
    if (php_init_config(TSRMLS_C) == FAILURE) {
        return FAILURE;
    }

调用了php_init_config, 这部分读取所有的php.ini和关联的ini文件, 然后对于每一条配置指令调用:

	....
 if (sapi_module.ini_entries) {
        zend_parse_ini_string(sapi_module.ini_entries, 1, php_config_ini_parser_cb, &extension_lists);
    }
然后在php_config_ini_parser_cb中:
               if (!strcasecmp(Z_STRVAL_P(arg1), "extension")) { /* load function module */
                    zval copy;

                    copy = *arg2;
                    zval_copy_ctor(&copy);
                    copy.refcount = 0;
                    zend_llist_add_element(&extension_lists.functions, &copy);
                } else if (!strcasecmp(Z_STRVAL_P(arg1), ZEND_EXTENSION_TOKEN)) { /* load Zend extension */
                    char *extension_name = estrndup(Z_STRVAL_P(arg2), Z_STRLEN_P(arg2));

                    zend_llist_add_element(&extension_lists.engine, &extension_name);
                } else {
                    zend_hash_update(&configuration_hash, Z_STRVAL_P(arg1), Z_STRLEN_P(arg1) + 1, arg2, sizeof(zval), (void **) &entry);
                    Z_STRVAL_P(entry) = zend_strndup(Z_STRVAL_P(entry), Z_STRLEN_P(entry));
                }

这里记录下来所有要载入的php extension和zend extension,
然后, 让我们回到php_module_startup, 后面有调用到了
php_ini_register_extensions(TSRMLS_C);

void php_ini_register_extensions(TSRMLS_D)
{
    zend_llist_apply(&extension_lists.engine, php_load_zend_extension_cb TSRMLS_CC);
    zend_llist_apply(&extension_lists.functions, php_load_function_extension_cb TSRMLS_CC);

    zend_llist_destroy(&extension_lists.engine);
    zend_llist_destroy(&extension_lists.functions);
}

我们可以看到, 对于每一个扩展记录, 都调用了一个回叫函数, 我们这里只看php_load_function_extension_cb:

static void php_load_function_extension_cb(void *arg TSRMLS_DC)
{
    zval *extension = (zval *) arg;
    zval zval;

    php_dl(extension, MODULE_PERSISTENT, &zval, 0 TSRMLS_CC);
}

最后, 就是核心的载入逻辑了:

void php_dl(zval *file, int type, zval *return_value, int start_now TSRMLS_DC)
{
        void *handle;
        char *libpath;
        zend_module_entry *module_entry;
        zend_module_entry *(*get_module)(void);
        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;
        }

        if (extension_dir && extension_dir[0]){
                int extension_dir_len = strlen(extension_dir);

                if (type == MODULE_TEMPORARY) {
                        if (strchr(Z_STRVAL_P(file), '/') != NULL || strchr(Z_STRVAL_P(file), DEFAULT_SLASH) != NULL) {
                                php_error_docref(NULL TSRMLS_CC, E_WARNING, "Temporary module name should contain only filename");
                                RETURN_FALSE;
                        }
                }

                if (IS_SLASH(extension_dir[extension_dir_len-1])) {
                        spprintf(&libpath, 0, "%s%s", extension_dir, Z_STRVAL_P(file));
                } else {
                        spprintf(&libpath, 0, "%s%c%s", extension_dir, DEFAULT_SLASH, Z_STRVAL_P(file));
                }
        } else {
                libpath = estrndup(Z_STRVAL_P(file), Z_STRLEN_P(file));
        }

        /* 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_FALSE;
        }

        efree(libpath);

        get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "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) {
                DL_UNLOAD(handle);
                php_error_docref(NULL TSRMLS_CC, error_type, "Invalid library (maybe not a PHP library) '%s' ", Z_STRVAL_P(file));
                RETURN_FALSE;
        }
        module_entry = get_module();
        if ((module_entry->zend_debug != ZEND_DEBUG) || (module_entry->zts != USING_ZTS)
                || (module_entry->zend_api != ZEND_MODULE_API_NO)) {
                /* Check for pre-4.1.0 module which has a slightly different module_entry structure :(  */
                        struct pre_4_1_0_module_entry {
                                  char *name;
                                  zend_function_entry *functions;
                                  int (*module_startup_func)(INIT_FUNC_ARGS);
                                  int (*module_shutdown_func)(SHUTDOWN_FUNC_ARGS);
                                  int (*request_startup_func)(INIT_FUNC_ARGS);
                                  int (*request_shutdown_func)(SHUTDOWN_FUNC_ARGS);
                                  void (*info_func)(ZEND_MODULE_INFO_FUNC_ARGS);
                                  int (*global_startup_func)(void);
                                  int (*global_shutdown_func)(void);
                                  int globals_id;
                                  int module_started;
                                  unsigned char type;
                                  void *handle;
                                  int module_number;
                                  unsigned char zend_debug;
                                  unsigned char zts;
                                  unsigned int zend_api;
                        };

                        char *name;
                        int zend_api;
                        unsigned char zend_debug, zts;

                        if ((((struct pre_4_1_0_module_entry *)module_entry)->zend_api > 20000000) &&
                                (((struct pre_4_1_0_module_entry *)module_entry)->zend_api < 20010901)
                        ) {
                                name       = ((struct pre_4_1_0_module_entry *)module_entry)->name;
                                zend_api   = ((struct pre_4_1_0_module_entry *)module_entry)->zend_api;
                                zend_debug = ((struct pre_4_1_0_module_entry *)module_entry)->zend_debug;
                                zts        = ((struct pre_4_1_0_module_entry *)module_entry)->zts;
                        } else {
                                name       = module_entry->name;
                                zend_api   = module_entry->zend_api;
                                zend_debug = module_entry->zend_debug;
                                zts        = module_entry->zts;
                        }

                        php_error_docref(NULL TSRMLS_CC, error_type,
                                          "%s: Unable to initialize module\n"
                                          "Module compiled with module API=%d, debug=%d, thread-safety=%d\n"
                                          "PHP    compiled with module API=%d, debug=%d, thread-safety=%d\n"
                                          "These options need to match\n",
                                          name, zend_api, zend_debug, zts,
                                          ZEND_MODULE_API_NO, ZEND_DEBUG, USING_ZTS);
                        DL_UNLOAD(handle);
                        RETURN_FALSE;
        }
        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) {
                DL_UNLOAD(handle);
                RETURN_FALSE;
        }

        if ((type == MODULE_TEMPORARY || start_now) && zend_startup_module_ex(module_entry TSRMLS_CC) == FAILURE) {
                DL_UNLOAD(handle);
                RETURN_FALSE;
        }

        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) {
                        php_error_docref(NULL TSRMLS_CC, error_type, "Unable to initialize module '%s'", module_entry->name);
                        DL_UNLOAD(handle);
                        RETURN_FALSE;
                }
        }
        RETURN_TRUE;
}


分享到:



Related Posts:

Tags: ,

97 Responses to “深入理解PHP原理之扩展载入过程”

Pages: [2] 1 » Show All

  1. mersin temizlik şirketleri |

    good hh

  2. AngelinaRQ |

    VIZI.com.ua

  3. JeffreyMn |

    Online Casino On Net – Black Jack Ballroom, Online Casino Rewards.

  4. Robertel |

    kredit 9000 euro – onlinesofortkredite.org – kredit von 1000 euro, 5000 euro kredit trotz schufa.

  5. Charlesneus |

    cvv dumps – cc dumps shop, dumps cc.

  6. MichaelTage |

    cc shop – dumps shop, dumps shop.

  7. HectorPulk |

    credit card dumps – dumps sites, dumps shop.

  8. KennethMi |

    canadian rx – canadian pharmacy, canadian rx online.

  9. MarcusKa |

    Game of Thrones 15 lines bonus slot BlackJack Ballroom online casino – Alley Cats bonus slot machine BlackJack Ballroom

  10. Robertosaic |

    суть счастья – книги саморазвитие онлайн, эзотерика онлайн бесплатно.

  11. read ds |

    http://your-porn-tube.com

  12. Cristal |

    J’ai vu quelques-uns des plus stupides, les réponses inutiles ici. Certains sont simplement comique, mais certains pourraient vraiment être dangereux ou causer des dommages à la propriété ou la perte d’argent ou de temps tout simplement gaspillée. Le problème, bien sûr, est que les geeks de Yahoo ont ce jeu à venir en haut dans les recherches web propageant ces réponses stupides sur une zone plus large ..

  13. GregorySt |

    irresistible website View site

  14. Taylorvala |

    lucky web site xxx-tube-videos.com

  15. StephenEi |

    good-neighbourly resource lovexhamster.com

  16. Timothyka |

    useful website View site

  17. MichaelPate |

    buy cvv – credit card dumps track 2, cvv shop online.

  18. DanielOn |

    track 1 track 2 dumps – buy dumps, dumps shop online.

  19. tony |

    ha

  20. FrancisSa |

    flawless resource goindianporn.com

  21. FreddyPag |

    first class web site Click here

  22. Dwaynetiz |

    курсы английского языка алматы отзывы – курсы английского языка +для начинающих алматы, интенсивный курс английского алматы.

  23. dan florea |

    super escort girls http://elitescort.co.com

  24. Azra |

    very nice web

  25. Roberthem |

    select web site http://pornmovie43.com/

  26. Efrainkat |

    fancy website http://xnxxnxvideos.com/

  27. florea |

    the best girls from istanbu

    http://www.bayanescort.co.com

  28. RobertWak |

    Comment Telecharger video Facebook – Facebook Video herunterladen, Como Baixar Videos Facebook.

  29. Williepam |

    http://planearium.de/gb/go.php?url=http://www.yoyoglasses.com/?url=www.oakley.com/?p=693
    oakley desert boots, fancifully oligarch unproductively nitric lags sequent verifiability pinnal anergy superseding whereunder mamma usually ultracentrifuge skeans

  30. online slot malaysia |

    You actually make it seem so easy with your presentation but I find this matter to be really something that I think I would never understand.
    It seems too complex and very broad for me. I’m looking forward for your next post, I will try to get the
    hang of it!

  31. Misty Lawry |

    Nice blog right here! Additionally your site rather a lot up fast!
    What webb host are you the use of? Can Igget your associate link in your host?
    I wish my web site loadesd up as quickly as yours lol

  32. Chance Muramats |

    Greate pieces. Keeep posting such kind of info on your page.
    Im eally impressed by it.
    Hey there, You’ve donbe a great job. I will definitely digg itt and for
    my part recommend to my friends. I’m confident they will be benefited from this
    site.

  33. StevenBema |

    Made promise of $100 WalMart gift card that wasn’t authentic http://www.callbat.com/1-202-607-2807. Said an e-mail will be transmitted in the next 5 minutes and I could cancel whatever it was they were attempting to get me to purchase. That e-mail never came and it has been 13 days and today they are looking to get money with no method to get in touch with an actual individual out of me

  34. Warrenecom |

    casino tempe – casino tempe, horseshoe casino elizabeth indiana.

  35. MichaelSt |

    casino koblenz – palms casino restaurant, leelanau sands casino concerts.

  36. EugenePn |

    mgm grand detroit casino – real money no deposit casino, hollywood casino epic buffet menu.

  37. PatrickMup |

    enviable website xhamster

  38. Georgelive |

    продвижение youtube – поддержка в сети cobby, как увеличить CPM на youtube.

  39. KennethSn |

    шарики серпухов – купить букет в серпухове, цветы в серпухове цены.

  40. Ouida |

    Furthermore, you should be aware that attacking strategies are different
    at every stage. I think Clan of the Vein is going to be their project that
    establishes Neil and Neo as Double N. Among the
    many examples of this are Tetris, Sokoban, and Solitaire.

  41. Anthonyhix |

    portrait price – poster star, Sergey Lukashin Tote Bags.

  42. CharlesVes |

    You Porn – Mature Porn Pics, Home Porn Tube.

  43. Thomashard |

    You Porn – Virgin porn, Teen porn pics.

  44. Bev |

    Some gamers prefer first or third person shooting style games, others prefer sports apps.
    I think Clan of the Vein is going to be their project that establishes Neil and Neo as Double N.
    I don’t have a problem with surveys, but I understand the concerns.

  45. Leonardtori |

    red tube free porn – Latin porn, porn tube free.

  46. WilliamEr |

    Russian porn videos – Schoolgirl indian porn, Hidden cams.

  47. EdwardFurl |

    Chinese xnxx porn – Hairy xnxx, xnxx videos.

Pages: [2] 1 » Show All

Leave a Reply

*