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.