HTTP::Parser::XS(3pm)

NAME

HTTP::Parser::XS - a fast, primitive HTTP request parser

SYNOPSIS

use HTTP::Parser::XS qw(parse_http_request);

my $ret = parse_http_request(
    "GET / HTTP/1.0\r\nHost: ...\r\n\r\n",
    \%env,
);
if ($ret == -2) {
    # request is incomplete
    ...
} elsif ($ret == -1) {
    # request is broken
    ...
} else {
    # $ret includes the size of the request, %env now contains a PSGI
    # request, if it is a POST / PUT request, read request content by
    # yourself
    ...
}

DESCRIPTION

HTTP::Parser::XS is a fast, primitive HTTP request parser that can be
used either for writing a synchronous HTTP server or a event-driven
server.

METHODS

parse_http_request($request_string, \%env)

Tries to parse given request string, and if successful, inserts
variables into %env. For the name of the variables inserted,
please refer to the PSGI specification. The return values are:

>=0 length of the request (request line and the request

headers), in bytes

-1 given request is corrupt

-2 given request is incomplete

COPYRIGHT

Copyright 2009- Kazuho Oku

AUTHOR

Kazuho Oku

THANKS TO

nothingmuch charsbar

SEE ALSO

HTTP::Parser HTTP::HeaderParser::XS

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1 2010-03-02 HTTP::Parser::XS(3pm)