NAME

Mojo::Message::Request - HTTP 1.1 Request Container

SYNOPSIS

    use Mojo::Message::Request;

    my $req = Mojo::Message::Request->new;
    $req->url->parse('http://127.0.0.1/foo/bar');
    $req->method('GET');

    print "$req";

    $req->parse('GET /foo/bar HTTP/1.1');

DESCRIPTION

Mojo::Message::Request is a container for HTTP 1.1 requests.

ATTRIBUTES

Mojo::Message::Request inherits all attributes from Mojo::Message and implements the following new ones.

env

    my $env = $req->env;
    $req    = $req->env({});

Direct access to the environment hash if available.

method

    my $method = $req->method;
    $req       = $req->method('GET');

HTTP request method.

params

    my $params = $req->params;

All GET and POST parameters, defaults to a Mojo::Parameters object.

query_params

    my $params = $req->query_params;

All GET parameters, defaults to a Mojo::Parameters object.

url

    my $url = $req->url;
    $req    = $req->url(Mojo::URL->new);

HTTP request URL, defaults to a Mojo::URL object.

METHODS

Mojo::Message::Request inherits all methods from Mojo::Message and implements the following new ones.

cookies

    my $cookies = $req->cookies;
    $req        = $req->cookies(Mojo::Cookie::Request->new);
    $req        = $req->cookies({name => 'foo', value => 'bar'});

Access request cookies.

fix_headers

    $req = $req->fix_headers;

Make sure message has all required headers for the current HTTP version.

is_secure

    my $secure = $req->is_secure;

Check if connection is secure.

param

    my $param = $req->param('foo');

Access GET and POST parameters, defaults to a Mojo::Parameters object.

parse

    $req = $req->parse('GET /foo/bar HTTP/1.1');
    $req = $req->parse(REQUEST_METHOD => 'GET');
    $req = $req->parse({REQUEST_METHOD => 'GET'});

Parse HTTP request chunks or environment hash.

proxy

    my $proxy = $req->proxy;
    $req      = $req->proxy('http://foo:bar@127.0.0.1:3000');
    $req      = $req->proxy(Mojo::URL->new('http://127.0.0.1:3000'));

Proxy URL for message.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicious.org.