知识卡片
未设值才继承父配置
ngx_conf_merge_str_value(child, parent, default) 的典型语义是:子层已设置则保留;子层未设置才取父层;两层都未设置才用默认值。它要求创建配置时保留可识别的“未设”状态,不能把合法空值与缺省混同。模块仍可自定义合并策略,因此这是该宏的行为,不是所有配置项的统一继承法则,见 [[配置分层合并]]。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入理解Nginx:模块开发与架构解析(第2版)》第4章4.2.5节《合并配置项》(源文件:`_epub-src/EPUB/text00033.html`)
- 结论依据:原书逐行展示该宏在子值未设置时先检查父值,否则使用默认值,并说明模块可以自行选择父子合并策略;[Nginx官方开发指南](https://nginx.org/en/docs/dev/development_guide.html#configuration)也说明预设merge宏在没有显式配置时填充默认值。
- 原始内容:上面的例子对不同级别下的test_str配置项的处理是最简单的,下面我们使用Nginx预置的ngx_conf_merge_str_value宏来合并子配置块中ngx_str_t类型的my_str成员,看看ngx_conf_merge_str_value到底做了哪些事情。