网上关于Nginx配置的教程很多，但真正理解其内部运作机制的却很少。今天，让我们用轻松的方式揭开Nginx处理HTTP请求的神秘面纱。
当我们访问一个网站时，简单的一次点击背后，是Web服务器繁忙而精细的处理过程。作为高性能Web服务器的代表，Nginx以其卓越的效率著称，而这很大程度上得益于其精巧的请求处理机制。
一个HTTP请求的"一生"
当一个HTTP请求抵达Nginx，它就像一位走进豪华酒店的客人，从入门到离开，经历了一系列精心设计的服务流程。
首先，Nginx的工作进程会接收这个请求，并为其创建一个身份档案——在Nginx中，这个档案就是ngx_http_request_t结构体。这个结构体完整地记录了这个请求的所有信息，从请求行、请求头到请求体，无所不包。
想象一下，这个结构体就像是酒店客人的专属档案，记录了客人的所有需求和特征。
核心档案：ngx_http_request_t揭秘
ngx_http_request_t是Nginx中对HTTP请求的完整封装，它就像一个万能收纳盒，把请求相关的所有信息都整理得井井有条。这个结构体非常庞大，但我们先来认识几个关键的"家庭成员"：
struct ngx_http_request_s {
ngx_uint_t method; // 请求方法，如GET、POST
ngx_uint_t http_version; // HTTP协议版本
ngx_str_t request_line; // 完整的请求行
ngx_str_t uri; // 请求的URI
ngx_str_t args; // 查询参数
ngx_str_t unparsed_uri; // 未解析的原始URI
ngx_str_t method_name; // 请求方法名
ngx_str_t http_protocol; // 协议字符串
// 指针成员，指向请求中各个部分的位置
u_char *uri_start;
u_char *uri_end;
u_char *args_start;
// ... 还有很多其他成员
};
其中，ngx_str_t是Nginx实现的字符串结构，与C语言的原生字符串不同：
typedef struct {
size_t len; // 字符串长度
u_char *data; // 指向字符串数据的指针
} ngx_str_t;
这种设计避免了字符串拷贝，直接通过指针和长度来引用原始数据，大大提高了处理效率。
请求处理：一场精心编排的舞台剧
Nginx处理HTTP请求的过程，就像一场精心编排的舞台剧，每个角色都有明确的出场顺序：
第一幕：解析请求行 请求处理从ngx_http_process_request_line函数开始。Nginx使用状态机来高效解析请求行，比较方法时并非使用字符串比较，而是将四个字符转换成整型后一次比较，减少CPU指令数。
第二幕：解析请求头 完成请求行解析后，Nginx设置读事件的handler为ngx_http_process_request_headers，开始读取和解析请求头。解析到的请求头会保存到ngx_http_request_t的headers_in域中，这是一个链表结构，保存所有的请求头。
第三幕：处理请求 当Nginx解析到两个回车换行符时，表示请求头结束，此时调用ngx_http_process_request来处理请求。这个函数会设置当前连接的读写事件处理函数，然后开始执行多阶段请求处理。
舞台背后：Nginx的多阶段处理
Nginx将HTTP请求处理划分为多个阶段，这种多阶段架构是其高性能的关键：
- POST_ACCEPT：接受连接后的初始阶段
- SSL：SSL/TLS处理阶段
- PRE_ACCESS：访问控制前阶段
- ACCESS：访问控制阶段
- CONTENT：内容生成阶段，最常被自定义模块使用的阶段
- LOG：日志记录阶段
在CONTENT阶段，Nginx会调用注册的处理函数来生成响应内容。这些函数接收ngx_http_request_t指针作为参数，并返回处理结果。
实战：看看请求信息如何获取
让我们来看一个实际的例子，了解如何从ngx_http_request_t结构中提取请求信息：
假设我们需要获取客户端请求的URI和参数，我们可以这样做：
static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r)
{
// 检查请求方法
if (r->method != NGX_HTTP_GET) {
return NGX_HTTP_NOT_ALLOWED;
}
// 获取URI和参数
ngx_str_t uri = r->uri;
ngx_str_t args = r->args;
// 记录日志
ngx_log_error(NGX_LOG_INFO, r->connection->log, 0,
"Request URI: %.*s, Args: %.*s",
uri.len, uri.data,
args.len, args.data);
// ... 处理请求并生成响应
}
在这个示例中，我们可以直接访问r->uri和r->args来获取请求的URI和查询参数。注意，由于Nginx使用ngx_str_t结构存储字符串，我们需要使用%.*s格式说明符并指定长度来打印这些字符串。
响应生成：给请求一个完美的答复
处理完请求后，我们需要向客户端发送响应。Nginx提供了简单的接口来完成这个任务：
static ngx_int_t ngx_http_mytest_handler(ngx_http_request_t *r)
{
// 设置响应头
r->headers_out.status = NGX_HTTP_OK;
r->headers_out.content_length_n = response_content.length;
// 发送响应头
ngx_int_t rc = ngx_http_send_header(r);
if (rc == NGX_ERROR || rc > NGX_OK || r->header_only) {
return rc;
}
// 准备响应体
ngx_buf_t *b;
b = ngx_create_temp_buf(r->pool, response_content.length);
if (b == NULL) {
return NGX_HTTP_INTERNAL_SERVER_ERROR;
}
// 复制响应数据到缓冲区
ngx_memcpy(b->pos, response_content.data, response_content.length);
b->last = b->pos + response_content.length;
b->last_buf = 1;
// 发送响应体
ngx_chain_t out;
out.buf = b;
out.next = NULL;
return ngx_http_output_filter(r, &out);
}
错误处理：当事情不如预期时
在处理HTTP请求时，并不是所有事情都会一帆风顺。Nginx定义了一系列的HTTP状态码，帮助我们告知客户端当前的处理状态：
// 常见的HTTP状态码
#define NGX_HTTP_OK 200
#define NGX_HTTP_NOT_FOUND 404
#define NGX_HTTP_METHOD_NOT_ALLOWED 405
#define NGX_HTTP_INTERNAL_SERVER_ERROR 500
#define NGX_HTTP_SERVICE_UNAVAILABLE 503
此外，Nginx还有自己特殊的返回码，如NGX_DECLINED表示拒绝处理，继续寻找下一个处理模块，NGX_DONE表示处理完成。
完整示例：简易请求处理模块
下面是一个完整的简单示例，演示如何处理请求并返回一个简单的JSON响应：
#include <ngx_config.h>
#include <ngx_core.h>
#include <ngx_http.h>
static ngx_int_t ngx_http_json_handler(ngx_http_request_t *r);
static char* ngx_http_json(ngx_conf_t *cf, ngx_command_t *cmd, void *conf);
// 模块指令定义
static ngx_command_t ngx_http_json_commands[] = {
{
ngx_string("json_interface"),
NGX_HTTP_LOC_CONF|NGX_CONF_NOARGS,
ngx_http_json,
0,
0,
NULL
},
ngx_null_command
};
// HTTP模块上下文
static ngx_http_module_t ngx_http_json_module_ctx = {
NULL, /* preconfiguration */
NULL, /* postconfiguration */
NULL, /* create main configuration */
NULL, /* init main configuration */
NULL, /* create server configuration */
NULL, /* merge server configuration */
NULL, /* create location configuration */
NULL /* merge location configuration */
};
// 模块定义
ngx_module_t ngx_http_json_module = {
NGX_MODULE_V1,
&ngx_http_json_module_ctx, /* module context */
ngx_http_json_commands, /* module directives */
NGX_HTTP_MODULE, /* module type */
NULL, /* init master */
NULL, /* init module */
NULL, /* init process */
NULL, /* init thread */
NULL, /* exit thread */
NULL, /* exit process */
NULL, /* exit master */
NGX_MODULE_V1_PADDING
};
// 配置指令处理函数
static char* ngx_http_json(ngx_conf_t *cf, ngx_command_t *cmd, void *conf)
{
ngx_http_core_loc_conf_t *clcf;
clcf = ngx_http_conf_get_module_loc_conf(cf, ngx_http_core_module);
clcf->handler = ngx_http_json_handler;
return NGX_CONF_OK;
}
// 请求处理函数
static ngx_int_t ngx_http_json_handler(ngx_http_request_t *r)
{
// 只支持GET请求
if (r->method != NGX_HTTP_GET) {
return NGX_HTTP_NOT_ALLOWED;
}
// 记录请求信息
ngx_log_error(NGX_LOG_INFO, r->connection->log, 0,
"处理JSON请求, URI: %.*s, 参数: %.*s",
r->uri.len, r->uri.data,
r->args.len, r->args.data);
// 准备JSON响应
char *json_response = "{\"status\":\"success\",\"message\":\"Hello from Nginx!\",\"timestamp\":123456789}";
size_t json_len = ngx_strlen(json_response);
// 设置响应头
r->headers_out.status = NGX_HTTP_OK;
r->headers_out.content_type_len = sizeof("application/json") - 1;
r->headers_out.content_type.data = (u_char *)"application/json";
r->headers_out.content_length_n = json_len;
// 发送响应头
ngx_int_t rc = ngx_http_send_header(r);
if (rc == NGX_ERROR || rc > NGX_OK || r->header_only) {
return rc;
}
// 创建缓冲区并发送响应体
ngx_buf_t *b;
b = ngx_create_temp_buf(r->pool, json_len);
if (b == NULL) {
return NGX_HTTP_INTERNAL_SERVER_ERROR;
}
ngx_memcpy(b->pos, json_response, json_len);
b->last = b->pos + json_len;
b->last_buf = 1;
ngx_chain_t out;
out.buf = b;
out.next = NULL;
return ngx_http_output_filter(r, &out);
}
这个简单的Nginx模块会在配置的location中返回一个固定的JSON响应。要使用这个模块，需要在Nginx配置文件中添加：
location /api/status {
json_interface;
}
优化之道：Nginx高性能的秘诀
Nginx之所以能高效处理大量并发请求，得益于几个关键设计：
- 单一连接的多请求处理：HTTP/1.1的持久连接允许在单个连接上处理多个请求
- 智能缓冲管理：Nginx使用缓冲区来存储请求和响应数据，通过
client_header_buffer_size和large_client_header_buffers等指令优化内存使用 - 事件驱动架构：基于事件的非阻塞I/O处理模式，使Nginx能够高效处理大量并发连接
- 内存池管理：使用
ngx_pool_t结构管理内存分配，减少内存碎片和提高分配效率
结语：从理解到实践
通过深入了解ngx_http_request_t结构体和Nginx的请求处理机制，我们不仅能更好地理解Nginx的高性能原理，还能编写更高效的定制模块。就像熟悉了汽车的内部结构后，你不仅能开车，还能进行保养和改装。
Nginx的请求处理就像一个精心设计的流水线，每个环节都经过优化，而ngx_http_request_t就是这个流水线上的核心载体，携带着请求的所有信息，经历从接收到响应的完整旅程。
下次当你使用Nginx时，不妨想想这个默默工作的ngx_http_request_t结构体，它正是Nginx高效处理能力的核心所在。
扫一扫
1681
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
