接下来,继续理解helloworld模块中的指令。
helloworld中的代码
/* Commands */
static ngx_command_t ngx_http_hello_world_commands[] = {
{ ngx_string("hello_world"),
NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS,
ngx_http_hello_world,
0,
0,
NULL },
ngx_null_command
};
有代码可以看出模块的指令在源码中ngx_command_t结构的变量,ngx_command_t的声明在src/core/ngx_conf_file.h中:
struct ngx_command_s {
ngx_str_t name;
ngx_uint_t type;
char *(*set)(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
ngx_uint_t conf;
ngx_uint_t offset;
void *post;
};
一一作对比来看看每个变量的具体含义:
name是指指令名称的字符串,不可以包含空格。
type是用来设置指令在配置文件位置的哪一部分使用是合法的可选值(在src/core/ngx_conf_file.h中保存了参数配置信息,其他模块中包含位置可选值)如下:
src/core/ngx_conf_file.h 参数配置信息
#define NGX_CONF_NOARGS 0x00000001 //指令没有参数
#define NGX_CONF_TAKE1 0x00000002 //指令读入2个参数
#define NGX_CONF_TAKE2 0x00000004 //….
#define NGX_CONF_TAKE3 0x00000008
#define NGX_CONF_TAKE4 0x00000010
#define NGX_CONF_TAKE5 0x00000020
#define NGX_CONF_TAKE6 0x00000040
#define NGX_CONF_TAKE7 0x00000080
#define NGX_CONF_MAX_ARGS 8
#define NGX_CONF_TAKE12 (NGX_CONF_TAKE1|NGX_CONF_TAKE2) //有1个或2个参数
#define NGX_CONF_TAKE13 (NGX_CONF_TAKE1|NGX_CONF_TAKE3)
#define NGX_CONF_TAKE23 (NGX_CONF_TAKE2|NGX_CONF_TAKE3)
#define NGX_CONF_TAKE123 (NGX_CONF_TAKE1|NGX_CONF_TAKE2|NGX_CONF_TAKE3)
#define NGX_CONF_TAKE1234 (NGX_CONF_TAKE1|NGX_CONF_TAKE2|NGX_CONF_TAKE3 \
|NGX_CONF_TAKE4)
#define NGX_CONF_ARGS_NUMBER 0x000000ff
#define NGX_CONF_BLOCK 0x00000100 //块域 后面跟{…} 例如events{…}
#define NGX_CONF_FLAG 0x00000200 //指令读入1个布尔型数据
#define NGX_CONF_ANY 0x00000400
#define NGX_CONF_1MORE 0x00000800 //指令至少一个参数
#define NGX_CONF_2MORE 0x00001000
#define NGX_CONF_MULTI 0x00002000 //多个参数
位置配置信息src/http/ngx_http_config.h中
#define NGX_HTTP_MAIN_CONF 0x02000000 //指令出现在全局配置部分是合法的
#define NGX_HTTP_SRV_CONF 0x04000000 //指令出现在server主机配置部分是合法的
#define NGX_HTTP_LOC_CONF 0x08000000 //指令出现在location部分是合法的
#define NGX_HTTP_UPS_CONF 0x10000000 //指令出现在upstream配置部分是合法的
#define NGX_HTTP_SIF_CONF 0x20000000 //…
#define NGX_HTTP_LIF_CONF 0x40000000
#define NGX_HTTP_LMT_CONF 0x80000000
在读上书信息是,希望各位有配置过nginx的经验,否则可能不会理解很深。
set是一个函数指针,这个函数主要是从配置文件中把该指令的参数(存放在ngx_conf_t中)转换为合适的数据类型,并将转换后的值保存到模块的配置结构体中(viod *conf),这个配置结构体又是用void *指向的,这里和之前讲过的一样,每个模块的结构体是不同的。这样正是这个回调函数的三个参数,这些结构体的命名格式为:ngx_<module name>_conf_t,
offset主要是存放转换后的值在配置结构体的偏移。
并不是所有的模块都要定义一个配置结构体,因为set也可能是一个简单的操作函数,它可能只是从配置中(ngx_conf_t)读取一些数据进行简单的操作,比如errlog模块的“error_log”指令就是调用ngx_error_log写一条日志,并不需要存储什么配置数据。
conf和offset,offset前面已经提到,它是配置结构体中成员的偏移。conf也是一个偏移值,不过它是配置文件结构体的(ngx_conf_t)成员ctx的成员的偏移,一般是用来把ctx中指定偏移位置的成员赋值给void *conf。
post指向模块读配置的时候需要的一些零碎变量。
从上面的分析可以看出,每个模块会映射到配置文件中的某个位置,全局位置的配置会被下一级的配置继承,比如http_main会被http_svr继承,http_svr会被http_loc继承,这些继承在源码中是调用模块上下文的合并配置的接口完成的。
分享到:
相关推荐
nginx-rtmp模块源码包nginx-rtmp-module-master
Nginx 源码分析笔记 自己的源码分析笔记,未完。
自己的nginx源码学习资料,包含《Nginx模块开发指南》和《深入理解Nginx》等,方便初学者了解nginx设计思想以及源码
mac无坑安装nginx(csdn)————程序
添加nginx-http-flv-module模块并重新编译后的nginx(windows版)
Nginx模块源码 nginx-notice-2 一只小麻雀。 通过Post的方式取文件 Nginx 0.7 可编译。
隐藏窗口启动Nginx和PHP——Nginx1.14.2+php-VC15-x64+RunHiddenConsole+启动和停止脚本
nginx带nginx-http-flv模块,包含所有rtmp功能,我自己在windows下编译的,直接可用,用的是最新版的1.19.4版本
nginx源码nginx源码nginx源码nginx源码nginx源码nginx源码nginx源码nginx源码nginx源码nginx源码
nginx-http-flv-module-master 支持flv模块直播
windows平台nginx编译nginx-http-flv-module,可直接运行,基于nginx-1.17.10编译
在windows 7 64位 环境下使用nginx的nginx-http-flv-module搭建flv视频流播放所有的安装包,参考:https://blog.csdn.net/qq_33071429/article/details/102628008
nginx学习笔记.zip
nginx-upload-module模块源码,用于nginx配置文件上传功能
nginx源码说明;其他下载即可,没下载分了,大家互相帮忙。其他情况大概就这些吧,其他也没什么好说的了,看文档即可
nginx-http-flv-module-master, 因为RTMP,HLS 都会存在这样那样的缺点,为了更好的解决延时问题、拉流兼容性问题,所以我们准备用flv.js 进行拉流。 对应的nginx组件
nginx-upload-progress模块源码,用于nginx配置获取文件上传进度。
nginx-rtmp-module-master源码
--> nginx-1.21.6 ======================== 在网上查找半天都只有教程,没有可免费下载的版本,深知没有积分遍地找资源的痛苦,无奈之下只好自己按照教程一步一个坑编译出来的,供大家免费下载使用。(无毒放心使用...
nginx sticky是nginx的module,可以实现基于cookie的负载均衡。 下载后,在编译安装nginx时,用--add-module... ./configure --prefix=/usr/local/nginx-1.6.0 --add-module=../nginx-sticky-module-1.25 --without-...