http-parser 快速集成：从零跑通 HTTP 解析

http-parser 快速集成：从零跑通 HTTP 解析

【免费下载链接】http-parserhttp request/response parser for c项目地址: https://gitcode.com/gh_mirrors/ht/http-parser

写过 socket 程序的人，多半被 HTTP 报文折腾过：头尾怎么分、chunked 分块怎么拼、连接要不要复用。http-parser 就是来解决这件事的：一个纯 C 实现的 HTTP 请求/响应解析库，MIT 协议，Node.js 的底层当年就靠它拆包。它只干一件事——把字节流按协议拆成 URL、头部和 body 片段，通过回调交给你。

原理其实不复杂。

它怎么工作：状态机喂字节，回调吐零件

parser 内部就是一台状态机。每次调用核心函数，把刚读到的数据丢进去，它返回消化了多少字节，剩下的下次接着喂；每识别出一个部件就触发对应回调：消息开始、URL、头部字段、头部值、body 分片、消息完成。类比一条流水线：原料从进料口进，零件从不同出口出来，你在每个出口放个收集箱就行。

核心调用就两行：

http_parser_init(&parser, HTTP_REQUEST); size_t done = http_parser_execute(&parser, &settings, buf, len);

剩下的就是体力活了。

把 http-parser 挂进你的构建链

集成路径很短。先把源码拿下来：

git clone https://gitcode.com/gh_mirrors/ht/http-parser

真正参与编译的只有http_parser.c和http_parser.h两个文件。直接把 .c 拷进工程编译是最省事的做法；想做成库也行，仓库自带 Makefile，make package出静态库，make library出动态库，make install装进系统。

回调注册同样直接：用http_parser_settings_init初始化配置结构，把回调函数逐个填进去。最后跑一遍make test，它分严格模式和快速模式各执行一次，能顺手验证你的编译选项没配错。

跑通之前，有两个坑先说清楚。

写回调时最容易被忽略的两件事

一个坑出在回调次数上：一个字段可能触发多次回调。on_url这类回调可以被调任意多次，每次只给几个字符——把每段当成完整 URL 来用，拿到的就是一堆碎片，正确做法是在回调里做追加拼接。

另一个坑出在返回值上，语义并不对称。普通回调返回非零，parser 立刻停摆，相当于你按了急停；唯独on_headers_complete是例外：返回 1 表示后面没有 body（比如 HEAD 请求的响应），返回 2 表示没有 body 且这条连接上也不会有后续消息（CONNECT 场景）。

还有个隐性开关：头文件顶部的两个宏。HTTP_PARSER_STRICT管检查的严格程度，关掉更快；HTTP_MAX_HEADER_SIZE默认 80KB，Cookie 特别大的场景要自己调大。

代码写得不顺时，还有两样东西比翻文档管用。

卡住时值得翻的两个文件

test.c 有四千多行，按类别整理了海量的请求/响应样例，想看某个回调在什么时机、带什么参数触发，翻它最快。contrib 目录里的 parsertrace 更实用：编译运行后它会打印 parser 的每次状态跳转，遇到"解析到一半就停了"这类问题，它就是示波器。

动手时最省事的起点：从 test.c 里拷一份完整的回调实现当模板，填上自己的逻辑，再跑make test验证。

【免费下载链接】http-parserhttp request/response parser for c项目地址: https://gitcode.com/gh_mirrors/ht/http-parser