php内核分析之sapi-module-struct

时间：2025-12-19 07:48:46 php语言我要投稿

　　为了帮助同学们学习PHP内核技术，小编整理了php内核分析之sapi_module_struct，希望对大家有所帮助!更多内容请关注应届毕业生网!

　　这里阅读的php版本为PHP-7.1.0 RC3，阅读代码的平台为linux

　　首先是寻找php的入口，php有很多种模式，apache，php-fpm, cli模式，我要入手的话，只能先从最简单的cli模型开始。

　　那么，我需要先寻找

　　php -r 'echo 12;'

　　这个命令是如何执行的。

　　首先还是寻找main入口，由于我们看的是命令行的php程序。所以，这个入口在sapi/cli/php_cli.c中。

　　首先是定义一系列的变量

　　int c;

　　zend_file_handle file_handle;

　　int behavior = PHP_MODE_STANDARD;

　　char *reflection_what = NULL;

　　volatile int request_started = 0;

　　volatile int exit_status = 0;

　　char *php_optarg = NULL, *orig_optarg = NULL;

　　int php_optind = 1, orig_optind = 1;

　　char *exec_direct=NULL, *exec_run=NULL, *exec_begin=NULL, *exec_end=NULL;

　　char *arg_free=NULL, **arg_excp=&arg_free;

　　char *script_file=NULL, *translated_path = NULL;

　　int interactive=0;

　　int lineno = 0;

　　const char *param_error=NULL;

　　int hide_argv = 0;

　　然后是这个

　　sapi_module_struct *sapi_module = &cli_sapi_module;

　　这是一个sapi_module_struct结构，这个结构是sapi中最重要的数据结构。它的定义在main/SAPI.h中。

　　下面是增加了注释的代码：

　　struct _sapi_module_struct { /pic/p>

　　char *name; /pic/p>

　　char *pretty_name; /pic/p>

　　int (*startup)(struct _sapi_module_struct *sapi_module); /pic/p>

　　int (*shutdown)(struct _sapi_module_struct *sapi_module); /pic/p>

　　int (*activate)(void); /pic/p>

　　int (*deactivate)(void); /pic/p>

　　size_t (*ub_write)(const char *str, size_t str_length); /pic/p>

　　void (*flush)(void *server_context); /pic/p>

　　zend_stat_t *(*get_stat)(void); /pic/p>

　　char *(*getenv)(char *name, size_t name_len); /pic/p>

　　void (*sapi_error)(int type, const char *error_msg, ...) ZEND_ATTRIBUTE_FORMAT(printf, 2, 3); /pic/p>

　　int (*header_handler)(sapi_header_struct *sapi_header, sapi_header_op_enum op, sapi_headers_struct *sapi_headers); /pic/p>

　　int (*send_headers)(sapi_headers_struct *sapi_headers); /pic/p>

　　void (*send_header)(sapi_header_struct *sapi_header, void *server_context); /pic/p>

　　size_t (*read_post)(char *buffer, size_t count_bytes); /pic/p>

　　char *(*read_cookies)(void); /pic/p>

　　void (*register_server_variables)(zval *track_vars_array); /pic/p>

　　void (*log_message)(char *message, int syslog_type_int); /pic/p>

　　double (*get_request_time)(void); /pic/p>

　　void (*terminate_process)(void); /pic/p>

　　char *php_ini_path_override; /pic/p>

　　void (*default_post_reader)(void); /pic/p>

　　void (*treat_data)(int arg, char *str, zval *destArray); /pic/tread_data/input_filter是三个能对输入进行过滤和处理的函数

　　char *executable_location; /pic/p>

　　int php_ini_ignore; /pic/p>

　　int php_ini_ignore_cwd; /pic/p>

　　int (*get_fd)(int *fd); /pic/p>

　　int (*force_http_10)(void); /pic/p>

　　int (*get_target_uid)(uid_t *); /pic/p>

　　int (*get_target_gid)(gid_t *); /pic/p>

　　unsigned int (*input_filter)(int arg, char *var, char **val, size_t val_len, size_t *new_val_len); /pic/p>

　　void (*ini_defaults)(HashTable *configuration_hash); /pic/p>

　　int phpinfo_as_text; /pic/p>

　　char *ini_entries; /pic/Adak,可以在命令行中设置时区

　　const zend_function_entry *additional_functions; /pic/p>

　　unsigned int (*input_filter_init)(void); /pic/p>

　　};

　　那么我们看下cli的SAPI的module是什么样子的呢?

　　其中我把里面原先有的STANDARD_SAPI_MODULE_PROPERTIES宏给解出来展示如下：

　　static sapi_module_struct cli_sapi_module = {

　　"cli", /* name */

　　"Command Line Interface", /* pretty name */

　　php_cli_startup, /* startup */

　　php_module_shutdown_wrapper, /* shutdown */

　　NULL, /* activate */

　　sapi_cli_deactivate, /* deactivate */

　　sapi_cli_ub_write, /* unbuffered write */

　　sapi_cli_flush, /* flush */

　　NULL, /* get uid */

　　NULL, /* getenv */

　　php_error, /* error handler */

　　sapi_cli_header_handler, /* header handler */

　　sapi_cli_send_headers, /* send headers handler */

　　sapi_cli_send_header, /* send header handler */

　　NULL, /* read POST data */

　　sapi_cli_read_cookies, /* read Cookies */

　　sapi_cli_register_variables, /* register server variables */

　　sapi_cli_log_message, /* Log message */

　　NULL, /* Get request time */

　　NULL, /* Child terminate */

　　NULL, /* php_ini_path_override */ \

　　NULL, /* default_post_reader */ \

　　NULL, /* treat_data */ \

　　NULL, /* executable_location */ \

　　0, /* php_ini_ignore */ \

　　0, /* php_ini_ignore_cwd */ \

　　NULL, /* get_fd */ \

　　NULL, /* force_http_10 */ \

　　NULL, /* get_target_uid */ \

　　NULL, /* get_target_gid */ \

　　NULL, /* input_filter */ \

　　NULL, /* ini_defaults */ \

　　0, /* phpinfo_as_text; */ \

　　NULL, /* ini_entries; */ \

　　NULL, /* additional_functions */ \

　　NULL /* input_filter_init */

　　};

　　有几个点可以总结：

　　cli模式是不需要发送header的，所以对应header处理的三个函数

　　sapi_cli_header_handler

　　sapi_cli_send_headers

　　sapi_cli_send_header

　　实际上都是空实现。

　　cookie也是同样道理

　　sapi_cli_read_cookies

　　其他的一些定义的函数，等到我们遇到的时候再分析吧。

　　main

　　回到main函数，根据上面的那个结构，我们就理解了

　　argv = save_ps_args(argc, argv); /pic/p>

　　cli_sapi_module.additional_functions = additional_functions; /pic/p>

　　signal

　　#ifdef HAVE_SIGNAL_H

　　#if defined(SIGPIPE) && defined(SIG_IGN)

　　/pic/p>

　　signal(SIGPIPE, SIG_IGN);

　　#endif

【php内核分析之sapi-module-struct】相关文章：

php内核分析之zend-compile10-17

php内核分析之全局变量12-14

php内核分析之ZTS和zend-try08-24

php学习之php配置03-11

php学习之php预定义变量11-02

相关推荐