Nginx源码阅读（模块）

最新推荐文章于 2024-07-12 21:58:05 发布
最新推荐文章于 2024-07-12 21:58:05 发布
阅读量664 收藏
点赞数
分类专栏： Nginx
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hz5034/article/details/54647276
版权

每个nginx模块，都是一个ngx_module_t类型的变量。根据ngx_module_t的type，所有nginx模块可以分为5种类型：

typectx指向的数据结构commands指向的数据结构具体模块
NGX_CORE_MODULEngx_core_module_tngx_command_tngx_core_module、ngx_errlog_module、ngx_events_module、ngx_openssl_module、ngx_http_module、ngx_mail_module
NGX_CONF_MODULENULLngx_command_tngx_conf_module
NGX_EVENT_MODULEngx_event_module_tngx_command_tngx_event_core_module等
NGX_HTTP_MODULEngx_http_module_tngx_command_tngx_http_core_module等
NGX_MAIL_MODULEngx_mail_module_tngx_command_tngx_mail_core_module等

这里写图片描述

// 用于初始化ngx_module_t的前7个成员变量
#define NGX_MODULE_V1 NGX_MODULE_UNSET_INDEX, NGX_MODULE_UNSET_INDEX, NULL, 0, 0, nginx_version, NGX_MODULE_SIGNATURE

// 用于初始化ngx_module_t的后8个成员变量
#define NGX_MODULE_V1_PADDING 0, 0, 0, 0, 0, 0, 0, 0


struct ngx_module_s {
    ngx_uint_t            ctx_index; // 表示当前模块在一类模块（type相同）中的序号
    ngx_uint_t            index; // 表示当前模块在所有模块中的序号

    char                 *name;

    ngx_uint_t            spare0;
    ngx_uint_t            spare1;

    ngx_uint_t            version;
    const char           *signature;

    void                 *ctx; // 指向一类模块（type相同）的上下文结构体
    ngx_command_t        *commands; // 解析模块配置的命令
    ngx_uint_t            type; // 模块的类型

    ngx_int_t           (*init_master)(ngx_log_t *log); // 目前没有使用

    ngx_int_t           (*init_module)(ngx_cycle_t *cycle);

    ngx_int_t           (*init_process)(ngx_cycle_t *cycle);
    ngx_int_t           (*init_thread)(ngx_cycle_t *cycle); // 目前没有使用
    void                (*exit_thread)(ngx_cycle_t *cycle); // 目前没有使用
    void                (*exit_process)(ngx_cycle_t *cycle);

    void                (*exit_master)(ngx_cycle_t *cycle);

    uintptr_t             spare_hook0;
    uintptr_t             spare_hook1;
    uintptr_t             spare_hook2;
    uintptr_t             spare_hook3;
    uintptr_t             spare_hook4;
    uintptr_t             spare_hook5;
    uintptr_t             spare_hook6;
    uintptr_t             spare_hook7;
};


// 核心模块的ctx指向的数据结构
typedef struct {
    ngx_str_t             name;
    void               *(*create_conf)(ngx_cycle_t *cycle);
    char               *(*init_conf)(ngx_cycle_t *cycle, void *conf);
} ngx_core_module_t;


// 事件模块的ctx指向的数据结构
typedef struct {
    ngx_str_t              *name;

    void                 *(*create_conf)(ngx_cycle_t *cycle);
    char                 *(*init_conf)(ngx_cycle_t *cycle, void *conf);

    ngx_event_actions_t     actions;
} ngx_event_module_t;

typedef struct {
    ngx_int_t  (*add)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
    ngx_int_t  (*del)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);

    ngx_int_t  (*enable)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);
    ngx_int_t  (*disable)(ngx_event_t *ev, ngx_int_t event, ngx_uint_t flags);

    ngx_int_t  (*add_conn)(ngx_connection_t *c);
    ngx_int_t  (*del_conn)(ngx_connection_t *c, ngx_uint_t flags);

    ngx_int_t  (*notify)(ngx_event_handler_pt handler);

    ngx_int_t  (*process_events)(ngx_cycle_t *cycle, ngx_msec_t timer,
                                 ngx_uint_t flags);

    ngx_int_t  (*init)(ngx_cycle_t *cycle, ngx_msec_t timer);
    void       (*done)(ngx_cycle_t *cycle);
} ngx_event_actions_t;


// http模块的ctx指向的数据结构
typedef struct {
    ngx_int_t   (*preconfiguration)(ngx_conf_t *cf);
    ngx_int_t   (*postconfiguration)(ngx_conf_t *cf);

    void       *(*create_main_conf)(ngx_conf_t *cf);
    char       *(*init_main_conf)(ngx_conf_t *cf, void *conf);

    void       *(*create_srv_conf)(ngx_conf_t *cf);
    char       *(*merge_srv_conf)(ngx_conf_t *cf, void *prev, void *conf);

    void       *(*create_loc_conf)(ngx_conf_t *cf);
    char       *(*merge_loc_conf)(ngx_conf_t *cf, void *prev, void *conf);
} ngx_http_module_t;


// mail模块的ctx指向的数据结构
typedef struct {
    ngx_mail_protocol_t        *protocol;

    void                       *(*create_main_conf)(ngx_conf_t *cf);
    char                       *(*init_main_conf)(ngx_conf_t *cf, void *conf);

    void                       *(*create_srv_conf)(ngx_conf_t *cf);
    char                       *(*merge_srv_conf)(ngx_conf_t *cf, void *prev,
                                                  void *conf);
} ngx_mail_module_t;


// commands指向的数据结构
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;
};

6个核心模块的定义

// 定义核心模块ngx_core_module
static ngx_command_t  ngx_core_commands[] = {...};

static ngx_core_module_t  ngx_core_module_ctx = {
    ngx_string("core"),
    ngx_core_module_create_conf,
    ngx_core_module_init_conf
};

ngx_module_t  ngx_core_module = {
    NGX_MODULE_V1,
    &ngx_core_module_ctx,                  /* module context */
    ngx_core_commands,                     /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};


// 定义核心模块ngx_errlog_module
static ngx_command_t  ngx_errlog_commands[] = {...};

static ngx_core_module_t  ngx_errlog_module_ctx = {
    ngx_string("errlog"),
    NULL,
    NULL
};

ngx_module_t  ngx_errlog_module = {
    NGX_MODULE_V1,
    &ngx_errlog_module_ctx,                /* module context */
    ngx_errlog_commands,                   /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};


// 定义核心模块ngx_events_module
static ngx_command_t  ngx_events_commands[] = {...};

static ngx_core_module_t  ngx_events_module_ctx = {
    ngx_string("events"),
    NULL,
    ngx_event_init_conf
};

ngx_module_t  ngx_events_module = {
    NGX_MODULE_V1,
    &ngx_events_module_ctx,                /* module context */
    ngx_events_commands,                   /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};


// 定义核心模块ngx_openssl_module
static ngx_command_t  ngx_openssl_commands[] = {...};

static ngx_core_module_t  ngx_openssl_module_ctx = {
    ngx_string("openssl"),
    ngx_openssl_create_conf,
    NULL
};

ngx_module_t  ngx_openssl_module = {
    NGX_MODULE_V1,
    &ngx_openssl_module_ctx,               /* module context */
    ngx_openssl_commands,                  /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    ngx_openssl_exit,                      /* exit master */
    NGX_MODULE_V1_PADDING
};


// 定义核心模块ngx_http_module
static ngx_command_t  ngx_http_commands[] = {...};

static ngx_core_module_t  ngx_http_module_ctx = {
    ngx_string("http"),
    NULL,
    NULL
};

ngx_module_t  ngx_http_module = {
    NGX_MODULE_V1,
    &ngx_http_module_ctx,                  /* module context */
    ngx_http_commands,                     /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};


// 定义核心模块ngx_mail_module 
static ngx_command_t  ngx_mail_commands[] = {...};

static ngx_core_module_t  ngx_mail_module_ctx = {
    ngx_string("mail"),
    NULL,
    NULL
};

ngx_module_t  ngx_mail_module = {
    NGX_MODULE_V1,
    &ngx_mail_module_ctx,                  /* module context */
    ngx_mail_commands,                     /* module directives */
    NGX_CORE_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};

1个配置模块的定义

// 定义配置模块ngx_conf_module，其中ctx为空
static ngx_command_t  ngx_conf_commands[] = {...};

ngx_module_t  ngx_conf_module = {
    NGX_MODULE_V1,
    NULL,                                  /* module context */
    ngx_conf_commands,                     /* module directives */
    NGX_CONF_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    NULL,                                  /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    ngx_conf_flush_files,                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
};
hz5034
关注
专栏目录
nginx源码阅读(一).综述
Move_now的博客
10-28 1万+
前言 nginx作为一款开源的轻量级高性能web服务器,是非常值得立志从事服务端开发方向的人学习的。现今nginx的最新版本是nginx-1.13.6,代码量也日渐庞大,但是由于其核心思想并没改变,为了降低阅读难度,我选择的是nginx-1.0.15版本,并且由于时间和水平有限,重点关注的是nginx的启动以及进程模型、事件模块中的epoll模块、负载均衡以及整体的框架等方面。 这里先推荐两本
nginx源码剖析
09-27
nginx源码说明；其他下载即可，没下载分了，大家互相帮忙。其他情况大概就这些吧，其他也没什么好说的了，看文档即可
NGINX源码阅读
weixin_34407348的博客
12-31 1392
NGINX源码阅读 前言 源码版本：2018-10-02 nginx-1.15.5 本文主要描述Darwin环境下的流程，与Linux环境下类似，Win32环境下可能会减少部分流程 Darwin/Linux等*nix类系统使用多进程方式运行，而Win32使用多线程方式运行 ngx_ 开头的变量多为全局变量 ngx_model_name....
Nginx 源码阅读-HTTP请求处理
最新发布
gma999的博客
07-12 887
新的HTTP请求到来时，处理流程分析。
nginx源码阅读
evsqiezi
01-18 431
ngx_alloc.c 分配内存的封装 ngx_daemon_c 创建守护进程。 ngx_thread_cond.c 条件变量的封装。 ngx_recv.c   socket收的封装 ngx_send.c socket发的封装 ngx_shmem.c 共享内存的封装 ngx_socket.c socket操作的封装 ngx_thread_m
nginx源码阅读（1）
xizmi的专栏
02-20 440
ngix 源码解析
Nginx源码阅读（Hello World程序）
Jiajun Zhu
04-02 688
来源于深入理解Nginx第3章 在nginx-1.10.2目录下新建mytest目录，把config文件和ngx_http_mytest_module.c文件放在mytest目录下 修改配置文件 // 在/usr/local/nginx/conf/nginx.conf中增加以下配置 location /test { mytest; } 编写config文件 ngx...
nginx各版本源码包
09-23
Nginx 是一款高性能的 Web 和反向代理服务器，广泛应用于互联网行业中，以其高效的并发处理能力、低内存占用和丰富的模块支持而备受青睐。本压缩包提供了 Nginx 的四个不同版本源码，包括 nginx-1.17.6.tar.gz、...
《跟我一起阅读nginx源代码》听课笔记
刘海龙的专栏
05-17 88
鲁义明，Gigah作者。 VMare Player 虚拟机里装Fedora re 17 然后用cygwin连 ll tar zxvf 绿色表示可以执行，configure可以执行 make到objs下nginx make install 默认 /usr/local/nginx/sbin 进入调试 gdb nginx 调试命令找到main vi nginx.c vim...
nginx代码阅读
03-29
nginx代码阅读，nginx请求流程梳理，有截图有真相，纯干货
Nginx-1.7.3:Nginx源码阅读注解
03-23
Nginx-1.7.3:Nginx源码阅读注解
阅读 Nginx 源码
QS9816
08-17 850
阅读 nginx 源码 Nginx是由俄罗斯软件工程师Igor Sysoev开发的一个高性能的HTTP和反向代理服务器，具备IMAP/POP3和SMTP服务器功能。Nginx最大的特点是对高并发的支持和高效的负载均衡，在高并发的需求场景下，是Apache服务器不错的替代品。目前，nginx [engine x]是Igor Sysoev编写的一个HTTP和反向代理服务器，另外它也可以作为邮
Nginx源码阅读（IPC）
Jiajun Zhu
01-21 655
共享内存/* src/os/unix/ngx_shmem.h */typedef struct { u_char *addr; // 共享内存的地址 size_t size; // 共享内存的长度 ngx_str_t name; // 共享内存的名称 ngx_log_t *log; ngx_uint_t exists;
nginx源码阅读(一)
xiewei0485的专栏
10-05 2259
公司使用goahead做为web服务器，在其基础上进行的二次开发，本来是给A产品做的定制的开发项目，后来移植到了B产品，添加了很多内容。A产品是嵌入式系统，B产品是运行在服务器上的，现在B产品对其性能不满意，上面就说要“优化”，要把一个单进程、单线程的轻量级服务器优化成一个高性能
Nginx源码阅读（事件/连接/请求）
Jiajun Zhu
07-15 547
在nginx中，ngx_connection_t是对TCP连接的封装，包括已连接套接字、读事件、写事件 表示一个事件的数据结构 struct ngx_event_s { void *data; // 通常指向ngx_connection_t unsigned write:1; // 位域，表示事件可写 unsigned ...
Nginx源码架构与核心模块分析
Nginx源码分析 Nginx源码分析是对Nginx源代码的深入分析，涵盖了Nginx代码的目录和结构、基本数据结构、Nginx的core module结构和运行机制、Nginx的http module结构和运行机制等方面。 **Nginx代码的目录和结构** ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值