NAME¶

SYNOPSIS¶

    use Plack::Request::WithEncoding;

    my $app_or_middleware = sub {
        my $env = shift; # PSGI env

        # Example of $env
        #
        # $env = {
        #     QUERY_STRING   => 'query=%82%d9%82%b0', # <= encoded by 'cp932'
        #     REQUEST_METHOD => 'GET',
        #     HTTP_HOST      => 'example.com',
        #     PATH_INFO      => '/foo/bar',
        # };

        my $req = Plack::Request::WithEncoding->new($env);

        $req->env->{'plack.request.withencoding.encoding'} = 'cp932'; # <= specify the encoding method.

        my $query = $req->param('query'); # <= get parameters of 'query' that is decoded by 'cp932'.

        my $res = $req->new_response(200); # new Plack::Response
        $res->finalize;
    };

DESCRIPTION¶

Please refer also "SPECIFICATION OF THE ENCODING METHOD".

ATTRIBUTES¶

• encoding

  Returns a encoding method to use to decode parameters.

• query_parameters

  Returns a reference to a hash containing decoded query string (GET) parameters. This hash reference is Hash::MultiValue object.

• body_parameters

  Returns a reference to a hash containing decoded posted parameters in the request body (POST). As with "query_parameters", the hash reference is a Hash::MultiValue object.

• parameters

  Returns a Hash::MultiValue hash reference containing decoded (and merged) GET and POST parameters.

• param

  Returns decoded GET and POST parameters with a CGI.pm-compatible param method. This is an alternative method for accessing parameters in "$req->parameters". Unlike CGI.pm, it does not allow setting or modifying query parameters.

      $value  = $req->param( 'foo' );
      @values = $req->param( 'foo' );
      @params = $req->param;
      

• raw_query_parameters

  This attribute is the same as "query_parameters" of Plack::Request.

• raw_body_parameters

  This attribute is the same as "body_parameters" of Plack::Request.

• raw_parameters

  This attribute is the same as "parameters" of Plack::Request.

• raw_param

  This attribute is the same as "param" of Plack::Request.

SPECIFICATION OF THE ENCODING METHOD¶

    $req->env->{'plack.request.withencoding.encoding'} = 'utf-7'; # <= set utf-7

And this encoding method will be used to decode.

When not once substituted for "$req->env->{'plack.request.withencoding.encoding'}", this module will use "utf-8" as encoding method. However the behavior of a program will become unclear if this function is used. Therefore YOU SHOULD NOT USE THIS. You should specify the encoding method explicitly.

In case of false value (e.g. `undef`, 0, '') is explicitly substituted for "$req->env->{'plack.request.withencoding.encoding'}", then this module will return raw value (with no encoding).

The example of a code is shown below.

    print exists $req->env->{'plack.request.withencoding.encoding'} ? 'EXISTS'
                                                                    : 'NOT EXISTS'; # <= NOT EXISTS
    $query = $req->param('query'); # <= get parameters of 'query' that is decoded by 'utf-8' (*** YOU SHOULD NOT USE LIKE THIS ***)

    $req->env->{'plack.request.withencoding.encoding'} = undef; # <= explicitly specify the `undef`
    $query = $req->param('query'); # <= get parameters of 'query' that is not decoded (raw value)

    $req->env->{'plack.request.withencoding.encoding'} = 'cp932'; # <= specify the 'cp932' as encoding method
    $query = $req->param('query'); # <= get parameters of 'query' that is decoded by 'cp932'

SEE ALSO¶

LICENSE¶

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

AUTHOR¶