Skip to content
PSGI compliant HTTP Entity Parser
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
eg
lib/HTTP/Entity
t
.gitignore
.travis.yml
Build.PL
Changes
LICENSE
META.json
README.md
cpanfile
minil.toml

README.md

NAME

HTTP::Entity::Parser - PSGI compliant HTTP Entity Parser

SYNOPSIS

use HTTP::Entity::Parser;

my $parser = HTTP::Entity::Parser->new;
$parser->register('application/x-www-form-urlencoded','HTTP::Entity::Parser::UrlEncoded');
$parser->register('multipart/form-data','HTTP::Entity::Parser::MultiPart');
$parser->register('application/json','HTTP::Entity::Parser::JSON');

sub app {
    my $env = shift;
    my ( $params, $uploads) = $parser->parse($env);
}

DESCRIPTION

HTTP::Entity::Parser is PSGI compliant HTTP Entity parser. This module also has compatibility with HTTP::Body. Unlike HTTP::Body, HTTP::Entity::Parser reads HTTP entity from PSGI's env $env->{'psgi.input'} and parse it. This module support application/x-www-form-urlencoded, multipart/form-data and application/json.

METHODS

  • new( buffer_length => $length:Intger)

    Create the instance.

    • buffer_length

      buffer length, HTTP::Entity::Parser read from psgi.input. 16384 by default.

  • register($content_type:String, $class:String, $opts:HashRef)

    Register parser class.

    $parser->register('application/x-www-form-urlencoded','HTTP::Entity::Parser::UrlEncoded');
    $parser->register('multipart/form-data','HTTP::Entity::Parser::MultiPart');
    $parser->register('application/json','HTTP::Entity::Parser::JSON');
    

    If the request content_type match registered type, HTTP::Entity::Parser uses registered parser class. If content_type does not match any registered type, HTTP::Entity::Parser::OctetStream is used.

  • parse($env:HashRef)

    parse HTTP entity from PSGI's env.

    my ( $params:ArrayRef, $uploads:ArrayRef) = $parser->parse($env);
    

    $param is key-value pair list.

    my ( $params, $uploads) = $parser->parse($env);
    my $body_parameters = Hash::MultiValue->new(@$params);
    

    $uploads is ArrayRef of HashRef.

    my ( $params, $uploads) = $parser->parse($env);
    warn Dumper($uploads->[0]);
    {
        "name" => "upload", #field name
        "headeres" => [
            "Content-Type" => "application/octet-stream",
            "Content-Disposition" => "form-data; name=\"upload\"; filename=\"hello.pl\""           
        ],
        "size" => 78, #size of upload content
        "filename" => "hello.png", #original filename in the client
        "tempname" => "/tmp/XXXXX", # path to the temporary file where uploaded file is saved
    }
    

    use with Plack::Request::Upload

    my ( $params, $uploads) = $parser->parse($env);
     my $upload_hmv = Hash::MultiValue->new();
     while ( my ($k,$v) = splice @$uploads, 0, 2 ) {
         my %copy = %$v;
         $copy{headers} = HTTP::Headers::Fast->new(@{$v->{headers}});
         $upload_hmv->add($k, Plack::Request::Upload->new(%copy));
     }
    

PARSERS

  • OctetStream

    Default parser, This parser does not parse entity, always return empty list.

  • UrlEncoded

    For application/x-www-form-urlencoded. It is used for HTTP POST without file upload

  • MultiPart

    For multipart/form-data. It is used for HTTP POST contains file upload.

    MultiPart parser use HTTP::MultiPartParser.

  • JSON

    For application/json. This parser decode JSON body automatically.

    It is convenient to use with Ajax form.

WHAT'S DIFFERENT FROM HTTP::Body

HTTP::Entity::Parser accept PSGI's env and read body from it.

HTTP::Entity::Parser is able to choose parsers by the instance, HTTP::Body requires to modify global variables.

SEE ALSO

LICENSE

Copyright (C) Masahiro Nagano.

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

AUTHOR

Masahiro Nagano kazeburo@gmail.com

Tokuhiro Matsuno tokuhirom@gmail.com

This module is based on tokuhirom's code, see https://github.com/plack/Plack/pull/434

Something went wrong with that request. Please try again.