知识卡片
自定义解析回调校验
预设槽位无法表达指令参数组合时,ngx_command_t.set 可指向自定义回调。示例用 NGX_CONF_TAKE12 允许一或两个参数,从 cf->args->elts 取字符串;第二个参数转整数失败时返回错误文本,成功则填入 conf 对应结构并返回 NGX_CONF_OK。不能只声明参数个数而省略转换失败路径,见 [[解析回调复用]]。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入理解Nginx:模块开发与架构解析(第2版)》第4章4.2.4节《自定义配置项处理方法》(源文件:`_epub-src/EPUB/text00033.html`)
- 结论依据:原书给出`set`函数签名、`NGX_CONF_TAKE12`声明及跨单元连续实现:`cf->args`提供参数、`ngx_atoi`负责转换并在`NGX_ERROR`时返回`invalid number`;本卡只保留回调契约与失败边界。
- 原始内容:除了使用Nginx已经实现的14个通用配置项处理方法外,还可以自己编写专用的配置项处理方法。事实上,3.5节中的ngx_http_mytest就是自定义的处理mytest配置项的方法,只是没有去处理配置项的参数而已。本节举例说明如何编写方法来解析配置项。