HTTP模块的数据结构

news2025/2/3 18:55:20

1.ngx_module_t

1.1数据定义

背景：

ngx_module_t结构体作为所有模块的通用接口，它只定义了init_master、init_module、init_process、init_thread、ext_thread、exit_process、exit_master这7个回调方法（事实上，init_master、init_thread、exit_thread这3个方法目前都没有使用），它们负责模块的初始化和退出，同时它们的权限也非常高

 基础解析：

*下面的ctx_index、index、spare0、spare1、spare2、spare3、version变量不需要在定义时赋值，可以用Nginx准备好的宏NGX_MODULE_V1来定义，它已经定义好了这7个值
#define NGX_MODULE_V  0，0，0，0，0，0，1

struct ngx_module_s{

ngx_uint_t ctx_index；

ngx_uint_t  index；

ngx_uint_t spare0；

ngx_uint_t spare1；

ngx_uint_t spare2；

ngx_uint_t spare3；

ngx_uint_t version;

void*     ctx;

ngx_command_t commands;

ngx_uint_t types;

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）；



}

ctx_index:

ctx_index表示当前模块在这类模块中的序号。这个成员常常是由管理这类模块的一个Nginx核心模块设置的，对于所有的HTTP模块而言，ctx_index是由核心模块ngx_http_module设置的。ctx_index非常重要，Nginx的模块化设计非常依赖于各个模块的顺序，它们既用于表达优先级，也用于明每个模块的位置，借以帮助Nginx框架快速获得某个模块的数据

index:

当前模板块在ngx_modules数组中的序号。注意，ctx_index表示的是当前模块在一类模块中的序号，而index表示当前模块在所有模块中的序号，它同样关键。Nginx启动时会根据ngx_modules数组设置各模块的index值。

spare:

spare系列的保留变量，暂未使用

version:

//模块的版本，便于将来的扩展。目前只有一种，默认为1

ctx:

Nginx模块有许多种类，不同类模块之间的功能差别很大。例如，事件类型的模块主要处理I/O事件相关的功能，HTTP类型的模块主要处理HTTP应用层的功能。这样，每个模块都有了自己的特性，而ctx将会指向特定类型模块的公共接口

type:

ype表示该模块的类型，它与ctx指针是紧密相关的。在官方Nginx中，它的取值范围是NGX_HTTP_MODULE、NGX_CORE_MODULE、NGX_CONF_MODULE、NGX_EVENT_MODULE、NGX_MAIL_MODULE。这5种模块间的关系参考上图。实际上，还可以自定义新的模块类型

执行点：在Nginx的启动、停止过程中，以下7个函数指针表示有7个执行点会分别调用这7种方法

init_master和exit_master:虽然从字面上理解应当在master进程启动时回调init_master，但到目前为止，框架代码从来不会调用它，因此，可将init_master设为NULL。exit_master回调方法将在master进程退出前被调用

init_module:init_module回调方法在初始化所有模块时被调用。在master/worker模式下，这个阶段将在启动worker子进程前完成 

init_process和exit_process:init_process回调方法在正常服务前被调用。在master/worker模式下，多个worker子进程已经产生，在每个worker进程的初始化过程会调用所有模块的init_process函数,exit_process回调方法在服务停止前调用。在master/worker模式下，worker进程会在退出前调用它

init_thread和exit_thread:由于Nginx暂不支持多线程模式，所以init_thread在框架代码中没有被调用过，设为NULL

spare_hook(未列出)：8个spare_hook变量也是保留字段，目前没有使用，但可用Nginx提供的NGX_MODULE_V1_PADDING宏来填充。看一下该宏的定义：#define NGX_MODULE_V1_PADDING 0，0，0，0，0，0，0，0

note：

1.定义一个HTTP模块时，务必把type字段设为NGX_HTTP_MODULE。

2.对于下列回调方法：init_module、init_process、exit_process、exit_master，调用它们的是Nginx的框架代码。换句话说，这4个回调方法与HTTP框架无关，即使nginx.conf中没有配置http{……}这种开启HTTP功能的配置项，这些回调方法仍然会被调用。因此，通常开发HTTP模块时都把它们设为NULL空指针

3.定义HTTP模块时，最重要的是要设置ctx和commands这两个成员。对于HTTP类型的模块来说，ngx_module_t中的ctx指针必须指向ngx_http_module_t接口（HTTP框架的要求）。

1.2解析数据：
 

1.八个ngx_module_t）：

1.//解析配置文件前调用

ngx_int_t（*preconfiguration）（ngx_conf_t*cf）；

2.//完成配置文件的解析后调用

ngx_int_t（*postconfiguration）（ngx_conf_t*cf）；

3.*当需要创建数据结构用于存储main级别（直属于http{……}块的配置项）的全局配置项时，可以通过create_main_conf回调方法创建存储全局配置项的结构体*/

4.//常用于初始化main级别配置项

char*（*init_main_conf）（ngx_conf_t*cf,void*conf）；

5.*当需要创建数据结构用于存储srv级别（直属于虚拟主机server{……}块的配置项）的配置项时，可以通过实现create_srv_conf回调方法创建存储srv级别配置项的结构体*/

void*（*create_srv_conf）（ngx_conf_t*cf）

6.//merge_srv_conf回调方法主要用于合并main级别和srv级别下的同名配置项

char*（*merge_srv_conf）（ngx_conf_t*cf,void*prev,void*conf）

7.*当需要创建数据结构用于存储loc级别（直属于location{……}块的配置项）的配置项时，可以实现create_loc_conf回调方法*/

void*（*create_loc_conf）（ngx_conf_t*cf）

8.//merge_loc_conf回调方法主要用于合并srv级别和loc级别下的同名配置项

*（*merge_loc_conf）（ngx_conf_t*cf,void*prev,void*conf）；

不过，这8个阶段的调用顺序与上述定义的顺序是不同的。在Nginx启动过程中，HTTP框架调用这些回调方法的实际顺序有可能是这样的（与nginx.conf配置项有关）：

1）create_main_conf
2）create_srv_conf
3）create_loc_conf
4）preconfiguration
5）init_main_conf
6）merge_srv_conf
7）merge_loc_conf
8）postconfiguration

2.commands数组

commands数组用于定义模块的配置文件参数，每一个数组元素都是ngx_command_t类型，数组的结尾用ngx_null_command表示。Nginx在解析配置文件中的一个配置项时首先会遍历所有的模块，对于每一个模块而言，即通过遍历commands数组进行，另外，在数组中检查到ngx_null_command时，会停止使用当前模块解析该配置项。每一个ngx_command_t结构体定义了自己感兴趣的一个配置项：

ngx_command_t
struct ngx_command ds{

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；
}；


1.name

//配置项名称

2 type:

.配置项类型，type将指定配置项可以出现的位置。

例如，出现在server{}或location{}中，以及它可以携带的参数个数

3.char*（*set）（ngx_conf_t*cf,ngx_command_t*cmd,void*conf）；出现了name中指定的配置项后，将会调用set方法处理配置项的参数

4.conf

在配置文件中的偏移量

5.ngx_uint_t
offset；：通常用于使用预设的解析方法解析配置项，这是配置模块的一个优秀设计。它需要与conf配合使用

6.ngx_uint_t offset；
处置项读取后的处理方法，必须是ngx_conf_post_t结构的指针

官方文件（节选与用户过滤模板）

ngx_module_t  ngx_http_userid_filter_module = {
    NGX_MODULE_V1,
    &ngx_http_userid_filter_module_ctx,    /* module context */
    ngx_http_userid_commands,              /* module directives */
    NGX_HTTP_MODULE,                       /* module type */
    NULL,                                  /* init master */
    NULL,                                  /* init module */
    ngx_http_userid_init_worker,           /* init process */
    NULL,                                  /* init thread */
    NULL,                                  /* exit thread */
    NULL,                                  /* exit process */
    NULL,                                  /* exit master */
    NGX_MODULE_V1_PADDING
}

static ngx_http_module_t  ngx_http_userid_filter_module_ctx = {
    ngx_http_userid_add_variables,         /* preconfiguration */
    ngx_http_userid_init,                  /* postconfiguration */

    NULL,                                  /* create main configuration */
    NULL,                                  /* init main configuration */

    NULL,                                  /* create server configuration */
    NULL,                                  /* merge server configuration */

    ngx_http_userid_create_conf,           /* create location configuration */
    ngx_http_userid_merge_conf             /* merge location configuration */
};

static ngx_command_t  ngx_http_userid_commands[] = {

    { ngx_string("userid"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_enum_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, enable),
      ngx_http_userid_state },

    { ngx_string("userid_service"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_num_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, service),
      NULL },

    { ngx_string("userid_name"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_str_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, name),
      NULL },

    { ngx_string("userid_domain"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_str_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, domain),
      &ngx_http_userid_domain_p },

    { ngx_string("userid_path"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_str_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, path),
      &ngx_http_userid_path_p },

    { ngx_string("userid_expires"),NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_http_userid_expires,
      NGX_HTTP_LOC_CONF_OFFSET,
      0,
      NULL },

    { ngx_string("userid_p3p"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_str_slot,
      NGX_HTTP_LOC_CONF_OFFSET,
      offsetof(ngx_http_userid_conf_t, p3p),
      &ngx_http_userid_p3p_p },

    { ngx_string("userid_mark"),
      NGX_HTTP_MAIN_CONF|NGX_HTTP_SRV_CONF|NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1,
      ngx_http_userid_mark,
      NGX_HTTP_LOC_CONF_OFFSET,
      0,
      NULL },

      ngx_null_command
};


 


 


 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/103703.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

DEJA_VU3D - Cesium功能集 之 090-台风过境实时动画

DEJA_VU3D - Cesium功能集 之 090-台风过境实时动画

前言 编写这个专栏主要目的是对工作之中基于Cesium实现过的功能进行整合，有自己琢磨实现的，也有参考其他大神后整理实现的，初步算了算现在有差不多实现小130个左右的功能，后续也会不断的追加，所以暂时打算一周2-3更的样子来更新本专栏（尽可能把代码简洁一些）。博文内容…
阅读更多...
内网穿透软件对比——cpolar : 花生壳（上）

内网穿透软件对比——cpolar : 花生壳（上）

系列文章 内网穿透软件对比——cpolar : 花生壳（上）内网穿透软件对比——cpolar : 花生壳（中）内网穿透软件对比——cpolar : 花生壳（下） 文章目录系列文章1. 前言2. 对比内容2.1 官网主页对比2.2 用户注册…
阅读更多...
JS中的事件循环机制(Event Loop)

JS中的事件循环机制(Event Loop)

JS中的事件循环机制(Event Loop) javascript是单线程的非阻塞的脚本语言 单线程 只有一个主线程来处理任务。非阻塞 JS引擎执行异步任务时，不会一直等待返回结果，主线程会挂起（pending）这个任务，继续执行其他任务&am…
阅读更多...
微三云（陈志坤）：共享购商业模式概念、框架、基础制度

微三云（陈志坤）：共享购商业模式概念、框架、基础制度

各位企业家及创业者朋友们，你们好。我是微三云（陈志坤），在你打开这个文章的时候，先不要急，因为任何一个能够长久、安稳、盈利的平台，背后肯定有一位看准宏观方向且耐心的人。这是一个极具颠覆性…
阅读更多...
php宝塔搭建部署实战零起飞OA办公管理系统源码

php宝塔搭建部署实战零起飞OA办公管理系统源码

大家好啊，我是测评君，欢迎来到web测评。 本期给大家带来一套php开发的零起飞OA办公管理系统源码，感兴趣的朋友可以自行下载学习。 技术架构 PHP7.2 nginx mysql5.7 JS CSS HTMLcnetos7以上 宝塔面板文字搭建教程 下载源码，宝…
阅读更多...
Mybatis对MySQL中BLOB字段的读取

Mybatis对MySQL中BLOB字段的读取

一、使用TEXT还是BLOB&#xff1f; 1、TEXT和BLOB主要差别 主要差别就是BLOB保存二进制数据&#xff0c;TEXT保存字符数据。 目前几乎博客内容里图片都不是二进制存储在数据库的&#xff0c;而是把图片上传到服务器&#xff0c;然后正文里使用<img>标签引用&#xff0c…
阅读更多...
电脑系统下载的镜像文件在哪里图解

电脑系统下载的镜像文件在哪里图解

如果你在小白系统上面下载了镜像文件&#xff0c;但是不知道下载完成怎么找到它的话&#xff0c;下面就和小编一起来看一下小白系统下载的镜像文件知道方法。 工具/原料&#xff1a; 系统版本&#xff1a;windows10系统 品牌型号&#xff1a;惠普战66五代 方法/步骤&#x…
阅读更多...
C/C++程序的断点调试 - Microsoft Visual Studio

C/C++程序的断点调试 - Microsoft Visual Studio

本文以Microsoft Visual Studio为例&#xff0c;简述C/C程序断点调试的基本方法和过程。其它的IDE环境&#xff0c;大同小异。 本文引用自作者编写的下述图书; 本文允许以个人学习、教学等目的引用、讲授或转载&#xff0c;但需要注明原作者"海洋饼干叔 叔"&#xff…
阅读更多...
【BFS】八数码问题（c++基础算法）

【BFS】八数码问题（c++基础算法）

目录 一.读题 二.在做题之前 1.康拓展开 2.DFS和BFS的区别 3.栈和队列的区别 三.做题 1.算法原理 2.算法实现 ①队列 ②康托展开 ③标记 四.AC代码 一.读题 作为最经典的一道宽度优先搜索题&#xff0c;它的题面并不是很难懂。 【宽搜&#xff08;难度&#xff1a;6&a…
阅读更多...
爆款短视频拍摄技巧之摇、移、跟拍等,这样拍的视频才更有吸引力,速收藏

爆款短视频拍摄技巧之摇、移、跟拍等,这样拍的视频才更有吸引力,速收藏

爆款短视频拍摄技巧之拍摄手法,这样拍的视频才更有吸引力。 拍摄技巧主要分为两个部分&#xff0c;一个是构图&#xff0c;一个是拍摄手法。上一篇我们聊过了两种构图手法&#xff0c;接下来咱们聊一下拍摄手法&#xff0c;也就是我们常说的推、拉、摇、移、跟这五种手法。 其…
阅读更多...
NNDL 2022秋

NNDL 2022秋

第一届AI专业&#xff0c;很多课程都是第一次开课&#xff0c;老师和学生都在“摸着石头过河”。 好处是所学内容比较新&#xff0c;跟得上“潮流”&#xff0c;学习意愿比较强。 难处是教学资料相对欠缺&#xff0c;需要学的内容较多&#xff0c;难度较大。 大家经过一学期…
阅读更多...
leetcode：1494. 并行课程 II【dfs记忆化 + 状态压缩】

leetcode：1494. 并行课程 II【dfs记忆化 + 状态压缩】

目录题目截图题目分析ac code总结题目截图 题目分析 这道题很像toposort&#xff0c;但实际不是因为那些indeg为先为0的&#xff0c;先选不一定好的考虑到n很小我们使用状态压缩dfs(state)表示当前state下&#xff0c;还需要多少个学期结束用pre数组存一下每个idx对应的前置条…
阅读更多...
基于C++11 实现的线程池

基于C++11 实现的线程池

提示&#xff1a;文章写完后&#xff0c;目录可以自动生成&#xff0c;如何生成可参考右边的帮助文档 基于C11 实现的线程池基于C11 实现的线程池1、线程池原理2、线程池的设计思路&#xff1f;3、一个基于C11的优秀的线程池3.1 头文件3.2 线程池类3.3 构造函数实现3.4 入队—添…
阅读更多...
ModStartBlog v6.4.0 升级输入过滤、多文件组件，修复已知问题

ModStartBlog v6.4.0 升级输入过滤、多文件组件，修复已知问题

V6.4.0版本更新 2022年12月20日ModStartBlog发布v6.4.0版本&#xff0c;增加了以下14个特性&#xff1a; [新功能] 富文本过滤规则调整优化[新功能] ArrayPackage数组输入数据包处理器[新功能] 请求输入组件新增多文件路径类型[新功能] 多文件上传组件[新功能] 所有组件新增t…
阅读更多...
RCE代码及命令执行(详解)

RCE代码及命令执行(详解)

RCE代码及命令执行1.RCE漏洞1.1.漏洞原理1.2.漏洞产生条件1.3.漏洞挖掘1.4.漏洞分类1.4.1.命令执行1.4.1.1.漏洞原理1.4.1.2.命令执行危险函数1.4.1.3.漏洞检测1.4.2.代码执行1.4.2.1.漏洞原理1.4.2.2.代码执行危险函数1.4.2.3.漏洞检测1.5.命令执行和代码执行区别2.命令执行2.…
阅读更多...
QT学习记录（二）最基础的工程

QT学习记录（二）最基础的工程

文件 工程新建后会有这几个文件&#xff0c;自动生成的 main.cpp #include "mainwindow.h"#include <QApplication>int main(int argc, char *argv[]) {QApplication a(argc, argv);MainWindow w;w.show();return a.exec(); }QApplication a(argc, argv);这里…
阅读更多...
Mentor-dft 学习笔记 day45-MTFI

Mentor-dft 学习笔记 day45-MTFI

Using MTFI Files此节介绍MTFI&#xff08;Mentor Tessend Fault Information&#xff09;功能&#xff0c;可用于ATPG工具和Tessent LogicBIST。MTFI是用于存储故障状态信息的通用且可扩展的文件格式。MTFI File Format MTFI是在“dft-edt”和“patterns-scan”上下文中读取和…
阅读更多...
运用大O来给代码提速（冒泡排序）

运用大O来给代码提速（冒泡排序）

本文内容借鉴一本我非常喜欢的书——《数据结构与算法图解》。学习之余&#xff0c;我决定把这本书精彩的部分摘录出来与大家分享。 本章内容 写在前面 1.冒泡排序 2.冒泡排序实战 3.冒泡排序的实现 4.冒泡排序的效率 5.二次问题 6.线性解决 7.总结 写在前面 大 O记…
阅读更多...
Diffusion Model合集 part2

Diffusion Model合集 part2

扩散模型原理介绍2五&#xff0c;逆扩散过程(Reverse Process)六&#xff0c;扩散过程中的后验的条件概率q(xt−1∣xt,x0)q(x_{t-1}|x_{t},x_{0})q(xt−1​∣xt​,x0​)七&#xff0c;目标数据分布的似然函数八&#xff0c;Diffusion Probabilistic Model的算法代码五&#xff…
阅读更多...
“专利费用减缓”怎么申请？

“专利费用减缓”怎么申请？

在专利申请时&#xff0c;很多申请人对“专利费用减缓”的概念并不了解&#xff0c;或者不太清楚。甚至有很多申请人一听到专利申请可以请求费用减缓&#xff0c;就以为申请专利是不要钱的。当然&#xff0c;这样的理解就存在了很大的偏差了&#xff0c;所以&#xff0c;我们今…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023