12.1 关于生命周期

除了在上一节说到的4个函数，还有2个函数只用于处理单个线程的启动和关闭，他们只作用于线程环境。

首先，建立一个基本扩展，根据你PHP源码树使用下面几个源文件。

config.m4

  1. PHP_ARG_ENABLE(sample4,
  2.     [Whether to enable the "sample4" extension],
  3.     [ enable-sample4 Enable "sample4" extension support])
  4. if test $PHP_SAMPLE4 != "no"; then
  5.     PHP_SUBST(SAMPLE4_SHARED_LIBADD)
  6.     PHP_NEW_EXTENSION(sample4, sample4.c, $ext_shared)
  7. fi

php_sample4.h

  1. #ifndef PHP_SAMPLE4_H
  2. /* Prevent double inclusion */
  3. #define PHP_SAMPLE4_H
  5. /* Define Extension Properties */
  6. #define PHP_SAMPLE4_EXTNAME
  7. #define PHP_SAMPLE4_EXTVER
  9. /* Import configure options when building outside of the PHP source tree */
  10. #ifdef HAVE_CONFIG_H
  11. #include "config.h"
  12. #endif
  14. /* Include PHP Standard Header */
  15. #include "php.h"
  17. /* Define the entry point symbol
  18.  * Zend will use when loading this module
  19.  */
  20. extern zend_module_entry sample4_module_entry;
  21. #define phpext_sample4_ptr &sample4_module_entry
  22. #endif /* PHP_SAMPLE4_H */

sample4.c

  1. #include "php_sample4.h"
  2. #include "ext/standard/info.h"
  4. static function_entry php_sample4_functions[] = {
  5.     { NULL, NULL, NULL }
  6. };
  8. PHP_MINIT_FUNCTION(sample4)
  9. {
  10.     return SUCCESS;
  11. }
  13. PHP_MSHUTDOWN_FUNCTION(sample4) {
  14.     return SUCCESS;
  15. }
  17. PHP_RINIT_FUNCTION(sample4) {
  18.     return SUCCESS;
  19. }
  20. PHP_RSHUTDOWN_FUNCTION(sample4) {
  21.     return SUCCESS;
  22. }
  24. PHP_MINFO_FUNCTION(sample4) {
  25. }
  27. zend_module_entry sample4_module_entry = {
  28. #if ZEND_MODULE_API_NO >= 20010901
  29.     STANDARD_MODULE_HEADER,
  30. #endif
  31.     PHP_SAMPLE4_EXTNAME,
  32.     php_sample4_functions,
  33.     PHP_MINIT(sample4),
  34.     PHP_MSHUTDOWN(sample4),
  35.     PHP_RINIT(sample4),
  36.     PHP_RSHUTDOWN(sample4),
  37.     PHP_MINFO(sample4),
  38. #if ZEND_MODULE_API_NO >= 20010901
  39.     PHP_SAMPLE4_EXTVER,
  40. #endif
  41.     STANDARD_MODULE_PROPERTIES
  42. };
  44. #ifdef COMPILE_DL_SAMPLE4
  45.     ZEND_GET_MODULE(sample4)
  46. #endif

注意：每个启动或者关闭的方法在return SUCCESS时退出。如果其中任何的函数return FAILURE，PHP为了避免出现严重问题而将请求中止。

现在你应该对MINIT很熟悉了吧，它会在一个模块第一次加载到进程空间的时候被触发。

对于多进程的SAPIS(Apache1 & Apache2-prefork)，多个web server进程会fork出多个mod_php实例。每个mod_php实例都必须加载属于这个实例的扩展模块，这意味着MINIT函数会被执行多次。但是，它在每个进程空间中只会执行一次。

当一个模块被卸载，MSHUTDOWN会被调用，它可以使用该模块的任何资源，比如被占用的内存可能会被释放。

这里要注意个特性, 某些PHP的SAPI中, 比如Apache Prefork, PHP是作为一个动态库被加载到Apache中的, 而从Apache 1.3以后(如果我没记错的话), Apache做了一个优化, 优化的结果就是首先执行各个动态模块的模块初始化工作, 然后才做fork, 派生Worker子进程, 所以反应到这里, 有的时候会出现MINIT只执行一次, 而MSHUTDOWN会执行多次的现象.

理论上来说，你可以在MSHUTDOWN中跳过一些资源的清理工作，然而在APACHE 1.3上的时候，你会发现一个有趣的事情，apache会载入mod_php，并且会执行所有的MINIT方法，然后立刻卸载mod_php来触发MSHUTDOWN，接着再次装入，在没有执行MSHUTDOWN的时候，最初使用MINIT加载的资源将被泄露和浪费。

在多线程的SAPIS中，有时需要为每个线程分配自己独立的资源或跟踪每个请求的计数器。对于这些特殊情况，在每一个线程钩子中，允许额外的启动和关闭要执行的方法。通常情况下，当多进程的SAPIS(Apache2-worker)启动时，它会创建出十几个或者更多的线程，以便能够处理多个并发请求。

任何可以请求之间共享，但不能由多个线程在同一进程空间同时访问的资源，通常分配在线程的构造和析构方法中以免发生冲突。比如可能包括在EG（ persistent_list ） HashTable中的持久性资源，因为他们往往​​包括网络或文件资源。