ngx_http_join_exact_locations

1 定义

ngx_http_join_exact_locations 函数 定义在 ./nginx-1.24.0/src/http/ngx_http.c

staticngx_int_tngx_http_join_exact_locations(ngx_conf_t*cf,ngx_queue_t*locations){ngx_queue_t*q,*x;ngx_http_location_queue_t*lq,*lx;q=ngx_queue_head(locations);while(q!=ngx_queue_last(locations)){x=ngx_queue_next(q);lq=(ngx_http_location_queue_t*)q;lx=(ngx_http_location_queue_t*)x;if(lq->name->len==lx->name->len&&ngx_filename_cmp(lq->name->data,lx->name->data,lx->name->len)==0){if((lq->exact&&lx->exact)||(lq->inclusive&&lx->inclusive)){ngx_log_error(NGX_LOG_EMERG,cf->log,0,"duplicate location \"%V\" in %s:%ui",lx->name,lx->file_name,lx->line);returnNGX_ERROR;}lq->inclusive=lx->inclusive;ngx_queue_remove(x);continue;}q=ngx_queue_next(q);}returnNGX_OK;}

ngx_http_join_exact_locations 函数的作用是 将 URI 相同的精确匹配（location = /uri）和前缀匹配（location /uri）合并到同一个链表节点中。

2 详解

1 函数签名

staticngx_int_tngx_http_join_exact_locations(ngx_conf_t*cf,ngx_queue_t*locations)

返回值 返回 NGX_OK（通常为 0）表示成功。 返回 NGX_ERROR（通常为 -1）表示失败。

参数 ngx_conf_t *cf 指向配置解析上下文 ngx_queue_t *locations location 配置链表的头节点（哨兵节点）

2 逻辑流程

1 局部变量 2 遍历查找 URI 相同的相邻节点 3 返回成功

1 局部变量

{ngx_queue_t*q,*x;ngx_http_location_queue_t*lq,*lx;

2 遍历查找 URI 相同的相邻节点

q=ngx_queue_head(locations);while(q!=ngx_queue_last(locations)){x=ngx_queue_next(q);lq=(ngx_http_location_queue_t*)q;lx=(ngx_http_location_queue_t*)x;if(lq->name->len==lx->name->len&&ngx_filename_cmp(lq->name->data,lx->name->data,lx->name->len)==0){if((lq->exact&&lx->exact)||(lq->inclusive&&lx->inclusive)){ngx_log_error(NGX_LOG_EMERG,cf->log,0,"duplicate location \"%V\" in %s:%ui",lx->name,lx->file_name,lx->line);returnNGX_ERROR;}lq->inclusive=lx->inclusive;ngx_queue_remove(x);continue;}q=ngx_queue_next(q);}

#1 获取队列 locations 的头节点指针，赋值给 q

#2 循环条件，判断当前节点 q 是否是队列的最后一个节点

#3 获取当前节点 q 的下一个节点指针，赋值给 x

#4 将通用的 ngx_queue_t 节点指针强制转换为具体的 ngx_http_location_queue_t 类型指针

#5 判断相邻两个 location 的路径是否完全相同。

#6 检查两个 location 的匹配类型是否冲突 完全重复的类型定义，这是配置错误 输出错误日志 返回错误码

#7 将后一个节点 lx 的 inclusive 标志赋值给前一个节点 lq

#8 从队列中删除节点 x

#9 当相邻两个节点路径不同时， 将 q 移动到下一个节点

3 返回成功

returnNGX_OK;}