知识卡片
重复指令按参数形态累积
同名指令要在一个作用域内保留多次配置时,应按每次的参数形态选择累积解析器:单字符串用 ngx_conf_set_str_array_slot,键值对用 ngx_conf_set_keyval_slot。两者都把多次出现的值追加到数组,区别在于元素类型及参数个数;普通单值解析器不表达这种累积语义。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入理解Nginx:模块开发与架构解析(第2版)》第4章4.2节《怎样使用http配置》(源文件:_epub-src/EPUB/text00033.html)
- 结论依据:原书4.2.3分别展示同名字符串指令和键值对指令的重复配置;[Nginx官方开发指南](https://nginx.org/en/docs/dev/development_guide.html#configuration)确认两个预设处理器分别追加 `ngx_str_t` 与 `ngx_keyval_t` 数组元素。[Nginx开发列表中的变更记录](https://mailman.nginx.org/pipermail/nginx-devel/2021-May/014006.html)表明槽位初值语义曾调整,原书的 `my_keyval=NULL` 不可跨版本照搬。
- 原始内容:ngx_conf_set_keyval_slot与ngx_conf_set_str_array_slot非常相似,唯一的不同点是ngx_conf_set_str_array_slot要求同名配置项后的参数个数是1,而ngx_conf_set_keyval_slot则要求配置项后的参数个数是2,分别表示key/value。