ngx_command_t 结构体中type成员的取值及其意义

最新推荐文章于 2025-03-14 14:25:01 发布
原创 最新推荐文章于 2025-03-14 14:25:01 发布 · 570 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#nginx #运维 #服务器

本文深入解析Nginx的ngx_command_t结构体，详细介绍了type取值的意义，配置项出现的位置，参数个数及形式的限制。这些信息对于理解Nginx如何解析配置文件至关重要。

ngx_command_t 结构体

struck 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;
};

type类型type取值意义
处理配置项时获取当前配置块的方式NGX_DIRECT_CONF一般由NGX_CORE_MODULE 类型的核心模块使用,仅与下面的NGX_MAIN_CONF同时设置,表示模块需要解析不属于任何{}内的全部配置项.它实际上会指定set方法里的第3个参数conf的值, 使之指向每个模块解析全局配置项的配置结构体
NGX_ANY_CONF目前未使用,配置与否均无意义
配置项可以在哪些{}配置块出现NGX_MAIN_CONF配置项可以出现在全局配置中,既不属于任何{}配置块
NGX_EVENT_CONF配置项可以出现在events{}块内
NGX_MAIL_SRV_CONF配置项可以出现在server{}块内,然而该server{}块必须属于mail{}块或者imap{}块
NGX_MAIL_MAIN_CONF配置项可以出现在mail{}块或者imap{}块内
NGX_HTTP_MAIN_CONF配置项可以出现在http{}块
NGX_HTTP_SRV_CONF配置项可以出现在server{}块内,然而server块必须属于http{}块
NGX_HTTP_LOC_CONF配置项可以出现在location{}块内,然而该location块必须属于http{}块
NGX_HTTP_UPS_CONF配置项可以出现在upstream{}块内, 然而该upstream块必须属于http{}块
NGX_HTTP_SIF_CONF配置项可以出现在server块内的if{}块中,目前仅有rewrite模块会使用,该if{}块必须属于http{}块
NGX_HTTP_LIF_CONF配置项可以出现在location块内的if{}块中,目前仅rewrite模块使用,该if{}块必须属于http{}块
NGX_HTTP_LMT_CONF配置项可以出现在limit_except{}块内,然而该limit_except块必须属于http{}块
限制配置项的参数个数NGX_CONF_NOARGS配置项不携带任何参数
NGX_CONF_NOARGS配置项不携带任何参数
NGX_CONF_TAKE1配置项可以携带1个参数
NGX_CONF_TAKE2配置项可以携带2个参数
NGX_CONF_TAKE3配置项可以携带3个参数
NGX_CONF_TAKE4配置项可以携带4个参数
NGX_CONF_TAKE5配置项可以携带5个参数
NGX_CONF_TAKE6配置项可以携带6个参数
NGX_CONF_TAKE7配置项可以携带7个参数
NGX_CONF_TAKE12配置项可以携带1个或2个参数
NGX_CONF_TAKE13配置项可以携带1个或3个参数
NGX_CONF_TAKE23配置项可以携带2个或3个参数
NGX_CONF_TAKE123配置项可以携带1~3个参数
NGX_CONF_TAKE1234配置项可以携带1~4个参数
限制配置项后的参数出现的形式NGX_CONF_ARGS_NUMBER目前未使用,无意义
NGX_CONF_BLOCK配置项定义了一种新的{}块
NGX_CONF_ANY不验证配置项携带的参数个数
NGX_CONF_FLAG配置项携带的参数只能是1个,并且参数的值只能是on或者off
NGX_CONF_1MORE配置项携带的参数个数必须超过1个
NGX_CONF_2MORE配置项携带的参数个数必须超过2个
NGX_CONF_MULTI表示当前配置项可以出现在任意块中(包括不属于任何块的全局配置),它仅用于配合其他配置项使用,type中未加NGX_CONF_MULTI时,如果一个配置项出现在type成员未标明配置块中,那么Nginx会认为该配置项违法,最后将导致Nginx启动失败.但如果配置项中加入了NGX_CONF_MULTI,则认为配置项一定是合法的.
Nginx源码分析与实践---ngx_command_t
ZX714311728的博客
03-15 3151
从上一节了解到配置项的相关属性是由ngx_command_t这个结构体设置的，下面就来看其源码，分析一下。 .../src/core/ngx_core.h : typedef struct ngx_command_s ngx_command_t;由上可知，以s结尾的和以t结尾的是同一种类型。该头文件下还有许多类似的定义。如： typedef struct ngx_modu
深度解析ngx_command_t结构
qq_62309585的博客
01-09 911
因为HTTP框架可以使用预设的14种方法自动 地将解析出的配置项写入HTTP模块代码定义的结构体中，但HTTP模块中可能会定义3个结 构体，分别用于存储main、srv、loc级别的配置项（对应于create_main_conf、 create_srv_conf、create_loc_conf方法创建的结构体），如果需要在解析完配置项后回调某个方法，就要实现 上面的ngx_conf_post_handler_pt，并将包含post_handler的ngx_conf_post_t结构体传给post指 针。
【Nginx源码】ngx_command_t学习
Edidaughter的博客
08-07 334
【代码】【Nginx源码】ngx_command_t学习。
ngx_command_t
weixin_41812346的博客
03-14 193
定义在void *post;
nginx基本数据结构ngx_module_t，ngx_module_s
大灰狼的专栏
05-28 3020
ngx_module_t是nginx的模块化架构最基本的数据结构。  其结构定义如下，其中的注释为功能说明：  查看文本打印 struct ngx_module_s {       ngx_uint_t            ctx_index；           /*分类的模块计数器      nginx模块可以分为四种：core、event、http和ma
C —— 结构体
奇妙的代码
03-13 420
在C语言中，结构体(struct)指的是一种数据结构，是C语言中聚合数据类型(aggregate data type)的一类。结构体可以被声明为变量、指针或数组等，用以实现较复杂的数据结构。结构体同时也是一些元素的集合，这些元素称为结构体的成员(member)，且这些成员可以为不同的类型，成员一般用名字访问。
nginx源码阅读(八).ngx_events_module模块
Move_now的博客
11-04 1142
前言在上一小节中我们对模块的整体有了一定的把握,本小节将进入到事件模块的分析中,了解nginx是如何收集、管理、分发事件的。nginx将网络事件以及定时事件集成到一起进行管理,由于各平台的I/O多路复用机制不同,但是nginx支持多个操作系统,因此在事件模块中也实现了多种针对不同平台下封装I/O多路复用机制的模块。由于我所用的环境主要关注的是linux,因此后面主要分析ngx_epoll_modul
Nginx专题（四、解析读取配置文件）
酱油师兄的博客
10-08 1978
nginx的强大功能就是可以通过配置文件来配置代码，全面只是简单的介绍了配置文件，现在这节要讲解一下怎么在模块中使用配置文件的参数。
ti共享内存技术_nginx共享内存机制详解
weixin_39550172的博客
12-22 264
nginx的共享内存，是其能够实现高性能的主要原因之一，而其主要是用于对文件的缓存。本文首先会讲解共享内存的使用方式，然后会讲解nginx是如何实现共享内存的管理的。1. 使用示例nginx声明共享内存的指令为：proxy_cache_path /Users/Mike/nginx-cache levels=1:2 keys_zone=one:10m max_size=10g inactive=60...
nginx 编写简单HTTP模块以及nginx http handler的hello world示例编写
chen
01-19 1341
编写nginx http handler模块以便开发自己模块，本文提供hello编写到编译的详细步骤 , 文章最后提供整个示例代码编写http handler模块的几个组成部分讲解：1、ngx_command_t示例：static ngx_command_t ngx_http_mytest_commands[] = { { ngx_string("mytest"),
nginx 模块相关配置及结构理解
qq_29750559的博客
11-23 1596
本文主要介绍nginx 模块相关配置及结构
nginx源码初读（11）--让烦恼从数据结构开始(ngx_command/ngx_module/ngx_conf)
wuchunlai_2012的博客
03-10 1213
第一点：ngx_command_t ngx_core_commands是nginx中的核心模块指令， 它的类型就是ngx_command_t。在每一个module的结构体中，也都有一个ngx_command_t。typedef struct ngx_command_s ngx_command_t;struct ngx_command_s { ngx_str_t
Nginx之配置文件的解析
weixin_30332241的博客
06-19 416
1. ngx_command_t 为了统一配置项目的解析，Nginx 定义了如下数据类型对所有的 Nginx 配置项进行了统一的描述。 typedef struct ngx_command_s ngx_command_t; struct ngx_command_s { /* * 该配置指令的名称，如 daemon, worker_processes 等 ...
nginx基础架构
多看多听多总结
11-20 1605
nginx基础架构
nginx模块编程学习笔记3–模块主要数据结构
域名空间商
12-03 472
在nginx模块编写种主要会涉及到下面3个数据结构，这一篇我就先来看看这3个数据结构的作用和意义。 ngx_command_t ngx_module_t ngx_http_module_t 前面这两个是定义在这个文件中：src/core/ngx_core.h typedef struct ngx_module_s ngx_module_t; typede
Nginx源码分析 - 主流程篇 - 解析配置文件（13）
alpha_love的博客
05-12 890
目录 一、Nginx的配置文件nginx.conf 二、数据结构逻辑关系图 三、相关数据结构 1. ngx_cycle_s的conf_ctx和modules 2. ngx_module_s的index和commands 3. ngx_command_s 命令集的结构 四、核心模块的定义 1. 核心模块在nginx.c的文件头部 2. 核心模块的配置结构ngx_core_conf_t 五、具体解析流程 1. 创建核心模块配置文件数据结构ngx_core_conf_t 2. 创建一个临时
nginx源码分析之ngx_core_commands
joescott的专栏
11-28 2347
ngx_core_commands是核心模块指令， 该变量的定义是在src/core/nginx.c中定义的。该变量为一个数组， 每个元素都是ngx_command_t类型，下面逐步解析这个变量。 ngx_command_t类型：(src/core/ngx_conf_file.h) typedef ngx_command_s ngx_command_t; struct ngx_c
Nginx模块开发系列1--预备知识
weixin_49406295的博客
12-04 3677
Nginx模块开发：ngx_command_t、ngx_module_t、ngx_http_module_t
nginx 源码学习笔记（四）——nginx精粹-模块
玩命写博客
03-15 6602
接下来，继续理解helloworld模块中的指令。 helloworld中的代码 /* Commands */ static ngx_command_t ngx_http_hello_world_commands[] = { { ngx_string("hello_world"), NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS, ngx_h
Nginx中ngx_str_t结构体的data字段如何初始化？
最新发布
07-19
在 Nginx 中，`ngx_str_t` 是一个常用的数据结构，用于表示字符串。它包含两个字段：`len` 表示字符串长度，`data` 指向字符串的起始地址。初始化 `ngx_str_t` 结构体的 `data` 字段时，需要确保其指向的字符串内容和长度匹配，并且内存分配合理。 ### 三级标题：初始化 ngx_str_t 的 data 字段 `ngx_str_t` 结构体的定义如下： ```c typedef struct { size_t len; u_char *data; } ngx_str_t; ``` 初始化 `data` 字段时，可以采用以下几种方式： 1. **静态初始化**：适用于已知字符串常量的情况，直接赋值字符串地址和长度。 ```c ngx_str_t str = ngx_string("example.com"); ``` 上述宏 `ngx_string` 是 Nginx 提供的便捷方式，用于将字符串常量转换为 `ngx_str_t` 结构体，自动计算 `len` 并赋值 `data` [^1]。 2. **动态分配内存**：当需要动态设置字符串内容时，应使用 Nginx 内存池分配内存，并手动设置 `data` 和 `len`。 ```c ngx_str_t str; str.len = 11; str.data = ngx_palloc(pool, str.len); ngx_memcpy(str.data, "dynamic", str.len); ``` 此方式通过 `ngx_palloc` 从内存池中分配指定长度的内存，并使用 `ngx_memcpy` 复制字符串内容到 `data` 所指向的内存区域 [^1]。 3. **从已有字符串复制**：使用 `ngx_str_set` 或 `ngx_str_null` 等宏来简化初始化过程。 ```c ngx_str_t str; ngx_str_set(&str, "test"); ``` `ngx_str_set` 宏会自动设置 `len` 和 `data`，适用于快速赋值字符串常量 [^1]。 ### 三级标题：注意事项 - **内存管理**：确保 `data` 指向的内存是有效的，避免使用局部变量或已释放的内存地址。 - **字符串长度**：`len` 应与 `data` 所指向的字符串实际长度一致，否则可能导致后续操作错误。 - **Nginx 工具宏**：推荐使用 `ngx_string`、`ngx_str_set` 等宏来简化初始化过程，提高代码可读性和安全性 。 通过上述方法，可以正确初始化 `ngx_str_t` 结构体的 `data` 字段，确保其在 Nginx 模块开发中的正常使用。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值