深入理解PHP与WEB服务器交互

1.WEB服务器调用PHP接口

　　以Apache服务器为例，我们看看该服务器是怎样启动PHP，并调用PHP中的方法。Apache服务器启动并运行PHP时，一般是通过mod_php7模块的形式集成（如果是php5.*版本，就是mod_php5模块，模块后缀名根据php版本而定），mod_php7的结构如下（源码路径为php/sapi/apache2handler/mod_php7.c）：

1 2 3 4 5 6 7 8 9

AP_MODULE_DECLARE_DATA module php7_module = {     STANDARD20_MODULE_STUFF,/* 宏，包括版本，版本，模块索引，模块名，下个模块指针等信息 */     create_php_config,      /* create per-directory config structure */     merge_php_config,       /* merge per-directory config structures */     NULL,                   /* create per-server config structure */     NULL,                   /* merge per-server config structures */     php_dir_cmds,           /* 模块定义的所有指令 */     php_ap2_register_hook   /* register hooks */ };

　　当Apache需要调用PHP中的方法时，只需要将该请求通过mod_php7模块传达给PHP，PHP层处理完后将数据返回给Apache，整个过程就结束了（补充一下：Apache服务器启动PHP时，其实有两种加载方式，一种为静态加载，一种为动态加载，刚才讨论的mod_php5模块加载方式可以理解为静态加载，也就是需要重新启动Apache服务器，才能将PHP加载进去；动态加载不需要重启服务器，只需要通过发送信号的方式将PHP固定的模块加载到服务器，以达到PHP启动的目的，但是在进行动态加载前，需要将加载模块编译成动态链接库，然后将其配置到服务器的配置文件中）。上面已经给出Apache在PHP中的model结构，下面给出Apache服务器中对应的module结构，如下（该源代码在Apache中，下同）：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

struct module_struct {     int version;     int minor_version;     int module_index;     const char *name;     void *dynamic_load_handle;     struct module_struct *next;     unsigned long magic;     void (*rewrite_args) (process_rec *process);     void *(*create_dir_config) (apr_pool_t *p, char *dir);     void *(*merge_dir_config) (apr_pool_t *p, void *base_conf, void *new_conf);     void *(*create_server_config) (apr_pool_t *p, server_rec *s);     void *(*merge_server_config) (apr_pool_t *p, void *base_conf, void *new_conf);     const command_rec *cmds;     void (*register_hooks) (apr_pool_t *p); }

　　可以看得出php7_module和module_struct还是有很大不同，不过如果看到php7_module.STANDARD20_MODULE_STUFF这个宏的定义方式，你可能就会觉得这两个结构体很像，其实这个宏定义了module_struct中的前8个参数，定义如下：

1 2 3 4 5 6 7 8

#define STANDARD20_MODULE_STUFF MODULE_MAGIC_NUMBER_MAJOR, \     MODULE_MAGIC_NUMBER_MINOR, \     -1, \     __FILE__, \     NULL, \     NULL, \     MODULE_MAGIC_COOKIE, \     NULL /* rewrite args spot */

　　然后php7_module.php_dir_cmds定义了模块的所有指令集合，具体定义内容如下（代码路径为php/sapi/apache2handler/apache_config.c）：

1 2 3 4 5 6 7 8 9 10

const command_rec php_dir_cmds[] = {     AP_INIT_TAKE2("php_value", php_apache_value_handler, NULL, OR_OPTIONS, "PHP Value Modifier"),     AP_INIT_TAKE2("php_flag", php_apache_flag_handler, NULL, OR_OPTIONS, "PHP Flag Modifier"),     AP_INIT_TAKE2("php_admin_value", php_apache_admin_value_handler, NULL, ACCESS_CONF|RSRC_CONF, "PHP Value Modifier (Admin)     "),     AP_INIT_TAKE2("php_admin_flag", php_apache_admin_flag_handler, NULL, ACCESS_CONF|RSRC_CONF, "PHP Flag Modifier (Admin)"),     AP_INIT_TAKE1("PHPINIDir", php_apache_phpini_set, NULL, RSRC_CONF, "Directory containing the php.ini file"),     {NULL} };

　　也就是说，PHP层只给Apache提供了上述5个指令，每个指令的实现源码也在apache_config.c文件中，最后就剩php7_module.php_ap2_register_hook了，它定义的内容如下（代码路径为php/sapi/apache2handler/mod_php7.c）：

1 2 3 4 5 6 7 8 9 10

void php_ap2_register_hook(apr_pool_t *p) {     ap_hook_pre_config(php_pre_config, NULL, NULL, APR_HOOK_MIDDLE);     ap_hook_post_config(php_apache_server_startup, NULL, NULL, APR_HOOK_MIDDLE);     ap_hook_handler(php_handler, NULL, NULL, APR_HOOK_MIDDLE); #ifdef ZEND_SIGNALS     ap_hook_child_init(zend_signal_init, NULL, NULL, APR_HOOK_MIDDLE); #endif     ap_hook_child_init(php_apache_child_init, NULL, NULL, APR_HOOK_MIDDLE); }

　　php7_module.php_ap2_register_hook函数包含4个钩子和对应的处理函数，pre_config，pre_config、post_config和child_init是启动钩子，它们是在服务器启动时调用，handler钩子是请求挂钩，它是在服务器请求是调用，通过这些钩子，就可以通过Apache服务器启动PHP。

　　 将到这里，想必大家已经知道WEB服务器是如何启动PHP，并调用PHP中的方法了哈，下面再给大家讲讲PHP是如何调用WEB服务器接口的。

2.PHP调用WEB服务器接口

　　在讲述这个问题前，我们需要了解一下什么是SAPI。SAPI其实是与服务器抽象层之间遵守的共同约定，可以这么简单理解，当PHP需要调用服务器中的方法，例如清除缓存，但是清除缓存的实现方法是在服务器中实现，PHP层根本就不知道怎么调用服务器中的该方法，怎么办？这时双方需要进行约定，然后服务器提供一套约定后的接口给PHP，我们把这些与服务器抽象层之间遵守的共同约定称为SAPI接口。

　　问题来了，对于服务器Apache，我们可以提供一套SAPI，但是如果下次又来个其它的服务器，或者其它的“第三方”，那么我们是不是也要给他们提供一套单独的SAPI呢？我们聪明的PHP开发者肯定想到了这一点，即对所有的“第三方”提供一套通用的SAPI接口，但是你可以会问，如果新的“第三方”需要的接口，你的通用SAPI不支持，那怎么办呢，我的理解是将新的功能添加到PHP的通用SAPI接口中，仅仅是个人见解哈，通用SAPI结构如下（源码路径： php/main/SAPI.h）：

1 2 3 4 5 6 7 8 9 10 11

struct _sapi_module_struct {     char *name;         // 名字     char *pretty_name;  // 更好理解的名字     int (*startup)(struct _sapi_module_struct *sapi_module);    // 启动函数     int (*shutdown)(struct _sapi_module_struct *sapi_module);   // 关闭函数     int (*activate)(TSRMLS_D);           // 激活     int (*deactivate)(TSRMLS_D);         // 停用     void (*flush)(void *server_context); // flush     char *(*read_cookies)(TSRMLS_D);     //read Cookies     //... };

　　该结构体变量较多，就不一一列举，简要说明一下里面的变量：startup函数是当SAPI初始化时会被调用，shutdown函数是用来释放SAPI的数据结构和内存等，read_cookie 是在SAPI激活时被调用，然后将此函数获取的值赋值给SG(request_info).cookie_data。那么对于PHP提供的通用SAPI，Apache服务器又是怎样定制自己的接口呢？具体结构如下（源码路径为php/sapi/apache2handler/sapi_apache2.c）：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

static sapi_module_struct apache2_sapi_module = {     "apache2handler",     "Apache 2.0 Handler",       php_apache2_startup,            /* startup */     php_module_shutdown_wrapper,    /* shutdown */       NULL,                           /* activate */     NULL,                           /* deactivate */       php_apache_sapi_ub_write,       /* unbuffered write */     php_apache_sapi_flush,          /* flush */     php_apache_sapi_get_stat,       /* get uid */     php_apache_sapi_getenv,         /* getenv */       php_error,                      /* error handler */       php_apache_sapi_header_handler, /* header handler */     php_apache_sapi_send_headers,   /* send headers handler */     NULL,                           /* send header handler */       php_apache_sapi_read_post,      /* read POST data */     php_apache_sapi_read_cookies,   /* read Cookies */       php_apache_sapi_register_variables,     php_apache_sapi_log_message,        /* Log message */     php_apache_sapi_get_request_time,   /* Request Time */     NULL,                               /* Child Terminate */       STANDARD_SAPI_MODULE_PROPERTIES };

　　上述源码目录php/sapi/apache2handler/中，目录php/sapi下面放的都是通过SAPI调用的“第三方”，该目录结构如下图所示，目录php/sapi/apache2handler中都是与PHP交互的接口，sapi_apache2.c是PHP与Apache约定的SAPI接口文件。

　　看到这里，大家应该基本清楚PHP层是怎样调用服务器层的接口，为了巩固上面的知识，下面举个栗子，即在Apache服务器环境下读取cookie：

1	SG(request_info).cookie_data = sapi_module.read_cookies(TSRMLS_C);

对于任意一个服务器在加载时，我们都会指定sapi_module，Apache的sapi_module是apache2_sapi_module，它的read_cookies方法的是php_apache_sapi_read_cookies函数，这样就实现PHP层调用Apache的接口，是不是很简单呢：）

3.后记

　　这篇博文是我参考《深入理解PHP内核》一书总结的，参考的内容为第二章第二节“SAPI概述”，不过我感觉该书中这部分内容讲的有点绕，我重新编排了，然后提取了里面的重点，并加入个人见解，如果在该文中有哪些讲的不对的地方，希望能帮我指出来，大家共同提高哈，谢谢！

 

参考： http://www.php-internals.com/