NAME
Mojo::Message::Request - HTTP 1.1 Request Container
SYNOPSIS
use Mojo::Message::Request;
# Parse
my $req = Mojo::Message::Request->new;
$req->parse("GET /foo HTTP/1.0\x0a\x0d");
$req->parse("Content-Length: 12\x0a\x0d\x0a\x0d");
$req->parse("Content-Type: text/plain\x0a\x0d\x0a\x0d");
$req->parse('Hello World!');
print $req->body;
# Build
my $req = Mojo::Message::Request->new;
$req->url->parse('http://127.0.0.1/foo/bar');
$req->method('GET');
print $req->to_string;
DESCRIPTION
Mojo::Message::Request is a container for HTTP 1.1 requests as described in RFC 2616.
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.
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, usually Mojo::Cookie::Request objects.
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.
is_xhr
my $xhr = $req->is_xhr;
Check X-Requested-With
header for XMLHttpRequest
value.
param
my $param = $req->param('foo');
Access GET
and POST
parameters.
params
my $params = $req->params;
All GET
and POST
parameters, usually 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.
query_params
my $params = $req->query_params;
All GET
parameters, usually a Mojo::Parameters object.