HTTP Parser
===========
http-parser is [**not** actively maintained](https://github.com/nodejs/http-parser/issues/522).
New projects and projects looking to migrate should consider [llhttp](https://github.com/nodejs/llhttp).
[![Build Status](https://api.travis-ci.org/nodejs/http-parser.svg?branch=master)](https://travis-ci.org/nodejs/http-parser)
This is a parser for HTTP messages written in C. It parses both requests and
responses. The parser is designed to be used in performance HTTP
applications. It does not make any syscalls nor allocations, it does not
buffer data, it can be interrupted at anytime. Depending on your
architecture, it only requires about 40 bytes of data per message
stream (in a web server that is per connection).
Features:
* No dependencies
* Handles persistent streams (keep-alive).
* Decodes chunked encoding.
* Upgrade support
* Defends against buffer overflow attacks.
The parser extracts the following information from HTTP messages:
* Header fields and values
* Content-Length
* Request method
* Response status code
* Transfer-Encoding
* HTTP version
* Request URL
* Message body
Usage
-----
One `http_parser` object is used per TCP connection. Initialize the struct
using `http_parser_init()` and set the callbacks. That might look something
like this for a request parser:
```c
http_parser_settings settings;
settings.on_url = my_url_callback;
settings.on_header_field = my_header_field_callback;
/* ... */
http_parser *parser = malloc(sizeof(http_parser));
http_parser_init(parser, HTTP_REQUEST);
parser->data = my_socket;
```
When data is received on the socket execute the parser and check for errors.
```c
size_t len = 80*1024, nparsed;
char buf[len];
ssize_t recved;
recved = recv(fd, buf, len, 0);
if (recved < 0) {
/* Handle error. */
}
/* Start up / continue the parser.
* Note we pass recved==0 to signal that EOF has been received.
*/
nparsed = http_parser_execute(parser, &settings, buf, recved);
if (parser->upgrade) {
/* handle new protocol */
} else if (nparsed != recved) {
/* Handle error. Usually just close the connection. */
}
```
`http_parser` needs to know where the end of the stream is. For example, sometimes
servers send responses without Content-Length and expect the client to
consume input (for the body) until EOF. To tell `http_parser` about EOF, give
`0` as the fourth parameter to `http_parser_execute()`. Callbacks and errors
can still be encountered during an EOF, so one must still be prepared
to receive them.
Scalar valued message information such as `status_code`, `method`, and the
HTTP version are stored in the parser structure. This data is only
temporally stored in `http_parser` and gets reset on each new message. If
this information is needed later, copy it out of the structure during the
`headers_complete` callback.
The parser decodes the transfer-encoding for both requests and responses
transparently. That is, a chunked encoding is decoded before being sent to
the on_body callback.
The Special Problem of Upgrade
------------------------------
`http_parser` supports upgrading the connection to a different protocol. An
increasingly common example of this is the WebSocket protocol which sends
a request like
GET /demo HTTP/1.1
Upgrade: WebSocket
Connection: Upgrade
Host: example.com
Origin: http://example.com
WebSocket-Protocol: sample
followed by non-HTTP data.
(See [RFC6455](https://tools.ietf.org/html/rfc6455) for more information the
WebSocket protocol.)
To support this, the parser will treat this as a normal HTTP message without a
body, issuing both on_headers_complete and on_message_complete callbacks. However
http_parser_execute() will stop parsing at the end of the headers and return.
The user is expected to check if `parser->upgrade` has been set to 1 after
`http_parser_execute()` returns. Non-HTTP data begins at the buffer supplied
offset by the return value of `http_parser_execute()`.
Callbacks
---------
During the `http_parser_execute()` call, the callbacks set in
`http_parser_settings` will be executed. The parser maintains state and
never looks behind, so buffering the data is not necessary. If you need to
save certain data for later usage, you can do that from the callbacks.
There are two types of callbacks:
* notification `typedef int (*http_cb) (http_parser*);`
Callbacks: on_message_begin, on_headers_complete, on_message_complete.
* data `typedef int (*http_data_cb) (http_parser*, const char *at, size_t length);`
Callbacks: (requests only) on_url,
(common) on_header_field, on_header_value, on_body;
Callbacks must return 0 on success. Returning a non-zero value indicates
error to the parser, making it exit immediately.
For cases where it is necessary to pass local information to/from a callback,
the `http_parser` object's `data` field can be used.
An example of such a case is when using threads to handle a socket connection,
parse a request, and then give a response over that socket. By instantiation
of a thread-local struct containing relevant data (e.g. accepted socket,
allocated memory for callbacks to write into, etc), a parser's callbacks are
able to communicate data between the scope of the thread and the scope of the
callback in a threadsafe manner. This allows `http_parser` to be used in
multi-threaded contexts.
Example:
```c
typedef struct {
socket_t sock;
void* buffer;
int buf_len;
} custom_data_t;
int my_url_callback(http_parser* parser, const char *at, size_t length) {
/* access to thread local custom_data_t struct.
Use this access save parsed data for later use into thread local
buffer, or communicate over socket
*/
parser->data;
...
return 0;
}
...
void http_parser_thread(socket_t sock) {
int nparsed = 0;
/* allocate memory for user data */
custom_data_t *my_data = malloc(sizeof(custom_data_t));
/* some information for use by callbacks.
* achieves thread -> callback information flow */
my_data->sock = sock;
/* instantiate a thread-local parser */
http_parser *parser = malloc(sizeof(http_parser));
http_parser_init(parser, HTTP_REQUEST); /* initialise parser */
/* this custom data reference is accessible through the reference to the
parser supplied to callback functions */
parser->data = my_data;
http_parser_settings settings; /* set up callbacks */
settings.on_url = my_url_callback;
/* execute parser */
nparsed = http_parser_execute(parser, &settings, buf, recved);
...
/* parsed information copied from callback.
can now perform action on data copied into thread-local memory from callbacks.
achieves callback -> thread information flow */
my_data->buffer;
...
}
```
In case you parse HTTP message in chunks (i.e. `read()` request line
from socket, parse, read half headers, parse, etc) your data callbacks
may be called more than once. `http_parser` guarantees that data pointer is only
valid for the lifetime of callback. You can also `read()` into a heap allocated
buffer to avoid copying memory around if this fits your application.
Reading headers may be a tricky task if you read/parse headers partially.
Basically, you need to remember whether last header callback was field or value
and apply the following logic:
(on_header_field and on_header_value shortened to on_h_*)
------------------------ ------------ --------------------------------------------
| State (prev. callback) | Callback | Description/action |
------------------------ ------------ --------------------------------------------
| nothing (first call) | on_h_field | Allocate new buffer and copy callback data |
| | | into it |
------------------------ ------------ --------------------------------------------
| value | on_h_field | New header started. |
|
没有合适的资源?快使用搜索试试~ 我知道了~
资源详情
资源评论
资源推荐
收起资源包目录
QtHttpServer库文件,测试用例,所需ssl文件 (264个子文件)
AUTHORS 2KB
target_wrapper.bat 345B
target_wrapper.bat 345B
target_wrapper.bat 345B
target_wrapper.bat 345B
target_wrapper.bat 345B
test.c 124KB
http_parser.c 74KB
parsertrace.c 4KB
bench.c 4KB
url_parser.c 1KB
fuzz_parser.c 601B
fuzz_url.c 322B
.qmake.cache 0B
my.cert 1KB
Qt5HttpServerConfig.cmake 10KB
Qt5HttpServerConfig.cmake 10KB
Qt5SslServerConfig.cmake 10KB
Qt5SslServerConfig.cmake 10KB
ExtraSourceIncludes.cmake 353B
ExtraSourceIncludes.cmake 353B
ExtraSourceIncludes.cmake 347B
ExtraSourceIncludes.cmake 347B
Qt5HttpServerConfigVersion.cmake 299B
Qt5SslServerConfigVersion.cmake 299B
Qt5HttpServerConfigVersion.cmake 299B
Qt5SslServerConfigVersion.cmake 299B
.qmake.conf 47B
tst_qhttpserver.cpp 29KB
tst_qhttpserverrouter.cpp 23KB
qhttpserverresponder.cpp 13KB
qhttpserverresponse.cpp 11KB
tst_qhttpserverresponder.cpp 10KB
qabstracthttpserver.cpp 10KB
qhttpserverrequest.cpp 10KB
qhttpserverrouterrule.cpp 10KB
qhttpserverrouter.cpp 10KB
tst_qabstracthttpserver.cpp 10KB
tst_qhttpserverresponse.cpp 7KB
qhttpserver.cpp 6KB
qhttpserverfutureresponse.cpp 5KB
main.cpp 5KB
main.cpp 3KB
moc_mainwindow.cpp 3KB
qsslserver.cpp 2KB
main.cpp 2KB
qhttpserverliterals.cpp 2KB
main.cpp 2KB
mainwindow.cpp 236B
Makefile.Debug 70KB
Makefile.Debug 53KB
Makefile.Debug 52KB
Makefile.Debug 52KB
Makefile.Debug 52KB
Makefile.Debug 51KB
Makefile.Debug 39KB
Makefile.Debug 38KB
libcrypto-1_1.dll 2.41MB
libssl-1_1.dll 520KB
Qt5HttpServerd.dll 326KB
Qt5HttpServerd.dll 326KB
Qt5HttpServerd.dll 326KB
Qt5HttpServer.dll 106KB
Qt5HttpServer.dll 106KB
Qt5HttpServer.dll 106KB
Qt5SslServerd.dll 75KB
Qt5SslServerd.dll 75KB
Qt5SslServerd.dll 75KB
Qt5SslServerd.dll 75KB
Qt5SslServerd.dll 75KB
Qt5SslServer.dll 24KB
Qt5SslServer.dll 24KB
Qt5SslServer.dll 24KB
Qt5SslServer.dll 24KB
Qt5SslServer.dll 24KB
empty 0B
QtHttpServerTest.exe 28KB
Qt5HttpServerd.exp 45KB
Qt5HttpServer.exp 45KB
Qt5SslServerd.exp 4KB
Qt5SslServerd.exp 4KB
Qt5SslServer.exp 4KB
Qt5SslServer.exp 4KB
.gitignore 2KB
.gitignore 255B
.gitmodules 121B
LICENSE.GPL3 34KB
http_parser.gyp 3KB
http_parser.h 19KB
qhttpserver.h 9KB
qhttpserver.h 9KB
qhttpserverviewtraits_impl.h 6KB
qhttpserverviewtraits_impl.h 6KB
qhttpserverrouterviewtraits.h 6KB
qhttpserverrouterviewtraits.h 6KB
qhttpserverrouter.h 6KB
qhttpserverrouter.h 6KB
qhttpserverresponder.h 5KB
qhttpserverresponder.h 5KB
qhttpserverfutureresponse.h 5KB
共 264 条
- 1
- 2
- 3
大陈1108
- 粉丝: 54
- 资源: 4
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论0