[李景山php] 深入理解PHP内核[读书笔记]--第二章:用户代码执行--SAPI概述-1

xiaoxiao2021-02-28  70

第二节:SAPI概述


简介: 一些与服务相关的操作都是通过SAPI接口实现。 这些内置实现的物理位置在PHP源码的SAPI目录。 这个目录存放了PHP对各个服务器抽象层的代码,例如命令行程序的实现,Apache的mod_php模块实现以及fastcgi的实现等等。

在各个服务器抽象层抽象层遵守着相同的约定,这里我们称之为SAPI接口。每个SAPI实现都是一个__sapi_module_struct结构体变量。(SAPI接口)。在PHP的源码中,当需要调用服务器相关信息时,全部通过SAPI接口中对应方法调用实现,而这对应的方法在各个服务器抽象层实现时都会有各自的实现。 由于很多操作的通用性,有很大一部分的接口方法使用的默认方法。

如图2.4所示:为SAPI的简单示意图。

第一层:上层调用 第二层:SAPI层 第三层:CGI/FASTCGI,Apache,Embed

以cgi模式和apache2服务器为例,他们的启动方法如下:

cgi_sapi_module.startup(&cgi_sapi_module)//cgi模式 cgi/cgi_main.c文件 apache2_sapi_module.startup(&apache2_sapi_module);//apache2服务器 apache2handler/sapi_apache2.c文件

这里的cgi_sapi_module是sapi_module_struct结构体的静态变量。它的startup方法执行php_cgi_startup函数指针。在这个结构体中除了startup函数指针,还有需要其它方法或字段,其部分定义如下:

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);//停用 int (*ub_write)(const char *str,unsigned int str_length TSRMLS_DC);// 不缓存的写操作(unbuffered write) void (*flush)(void *server_context);//flush struct stat *(*get_stat)(TSRMLS_D);//get uid char *(*getenv)(char *name,size_t name_len TSRMLS_DC);//getenv void (*sapi_error)(int type,const char *error_msg,...);/*error handler*/ int (*header_handler)(sapi_header_struct *sapi_header,sapi_header_op_enum op,sapi_headers_struct *sapi_headers TSRMLS_DC);//header handler int (*send_headers)(sapi_headers_struct *sapi_headers TSRMLS_DC); void (*send_header)(sapi_header_struct *sapi_header,void * server_context TSRMLS_DC);//send header handler int (*read_post)(char *buffer,uint count_bytes TSRMLS_DC);//read POST data char *(*read_cookies)(TSRMLS_D);//read Cookies void (*register_server_variables)(zval *track_vars_array TSRMLS_DC); void (*log_message)(char *message);// log messages time_t (*get_request_time)(TSRMLS_D)//request Time void (*terminate_process)(TSRMLS_D);//child terminate char *php_ini_path_voerride;//覆盖的ini路径 }
转载请注明原文地址: https://www.6miu.com/read-96814.html

最新回复(0)