ngx_http_process_user_agent

1 定义

ngx_http_process_user_agent 函数 定义在 ./nginx-1.24.0/src/http/ngx_http_request.c

2 作用

`ngx_http_process_user_agent` 函数负责 解析 `User-Agent` 头部， 识别浏览器类型（如 MSIE、Chrome、Firefox 等）并在请求中设置相应标志位。

3 详解

1 函数签名

staticngx_int_tngx_http_process_user_agent(ngx_http_request_t*r,ngx_table_elt_t*h,ngx_uint_toffset)

1 返回值

用于统一表示操作状态码。

NGX_OK：User-Agent 头部处理成功。

NGX_ERROR：处理失败。

2 函数名

命名空间前缀ngx_：Nginx 函数的标准前缀。

http：表明该函数属于 HTTP 模块。

process_user_agent：
直接揭示了函数的功能——处理User-Agent请求头。
User-Agent头部是客户端（如浏览器）标识自身软件类型和版本的信息，
Nginx 通过解析该头部来识别特定的浏览器，以便后续执行针对性的优化或兼容处理。

整体语义：
该函数是 Nginx 中专门用于处理HTTP User-Agent头部的回调。
它在请求头解析阶段被调用，负责解析该头部的值，
并将其转化为请求结构体中易于使用的浏览器标识标志位。

3 第一个参数ngx_http_request_t *r
代表当前正在处理的 HTTP 请求。

4 第二个参数ngx_table_elt_t *h

该结构体表示一个已解析的 HTTP 头部。

5 第三个参数ngx_uint_t offset

表示User-Agent字段在结构体ngx_http_headers_in_t中的偏移量。

2 逻辑流程

1 保存 2 Internet Explorer（MSIE）浏览器 3 Opera 浏览器 4 非 MSIE，Opera 5 返回成功

{u_char*user_agent,*msie;

局部变量声明

1 保存

if(ngx_http_process_header_line(r,h,offset)!=NGX_OK){returnNGX_ERROR;}

将当前已解析的 HTTP 头部（h）保存到请求结构体（r）中正确的位置。

2 Internet Explorer（MSIE）浏览器

/* check some widespread browsers while the header is in CPU cache */user_agent=h->value.data;msie=ngx_strstrn(user_agent,"MSIE ",5-1);if(msie&&msie+7<user_agent+h->value.len){r->headers_in.msie=1;if(msie[6]=='.'){switch(msie[5]){case'4':case'5':r->headers_in.msie6=1;break;case'6':if(ngx_strstrn(msie+8,"SV1",3-1)==NULL){r->headers_in.msie6=1;}break;}}#if0/* MSIE ignores the SSL "close notify" alert */if(c->ssl){c->ssl->no_send_shutdown=1;}#endif}

3 Opera 浏览器

if(ngx_strstrn(user_agent,"Opera",5-1)){r->headers_in.opera=1;r->headers_in.msie=0;r->headers_in.msie6=0;}

4 非 MSIE，Opera

if(!r->headers_in.msie&&!r->headers_in.opera){if(ngx_strstrn(user_agent,"Gecko/",6-1)){r->headers_in.gecko=1;}elseif(ngx_strstrn(user_agent,"Chrome/",7-1)){r->headers_in.chrome=1;}elseif(ngx_strstrn(user_agent,"Safari/",7-1)&&ngx_strstrn(user_agent,"Mac OS X",8-1)){r->headers_in.safari=1;}elseif(ngx_strstrn(user_agent,"Konqueror",9-1)){r->headers_in.konqueror=1;}}

只有当请求既没有被识别为 MSIE，也没有被识别为 Opera 时，
才进入下面的浏览器检测。

检测除 MSIE 和 Opera 之外的四种主流浏览器：
Gecko（例如 Firefox）、Chrome、Safari 和 Konqueror。
检测通过用户代理字符串中的特征子串完成，并设置请求中相应的标识位。

5 返回成功

returnNGX_OK;}