知识卡片

普通读书笔记卡 · 3559.e

重复指令按参数形态累积

理解等级:中级

同名指令要在一个作用域内保留多次配置时,应按每次的参数形态选择累积解析器:单字符串用 ngx_conf_set_str_array_slot,键值对用 ngx_conf_set_keyval_slot。两者都把多次出现的值追加到数组,区别在于元素类型及参数个数;普通单值解析器不表达这种累积语义。

这张卡片看不懂?

已有反馈 · 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。