Mojo::Headers - Headers
use Mojo::Headers; # Parse my $headers = Mojo::Headers->new; $headers->parse("Content-Length: 42\x0d\x0a"); $headers->parse("Content-Type: text/html\x0d\x0a\x0d\x0a"); say $headers->content_length; say $headers->content_type; # Build my $headers = Mojo::Headers->new; $headers->content_length(42); $headers->content_type('text/plain'); say $headers->to_string;
Mojo::Headers is a container for HTTP headers based on RFC 7230 and RFC 7231.
Mojo::Headers implements the following attributes.
my $size = $headers->max_line_size; $headers = $headers->max_line_size(1024);
Maximum header line size in bytes, defaults to the value of the MOJO_MAX_LINE_SIZE environment variable or 8192 (8KB).
MOJO_MAX_LINE_SIZE
8192
my $num = $headers->max_lines; $headers = $headers->max_lines(200);
Maximum number of header lines, defaults to the value of the MOJO_MAX_LINES environment variable or 100.
MOJO_MAX_LINES
100
Mojo::Headers inherits all methods from Mojo::Base and implements the following new ones.
my $accept = $headers->accept; $headers = $headers->accept('application/json');
Shortcut for the Accept header.
Accept
my $charset = $headers->accept_charset; $headers = $headers->accept_charset('UTF-8');
Shortcut for the Accept-Charset header.
Accept-Charset
my $encoding = $headers->accept_encoding; $headers = $headers->accept_encoding('gzip');
Shortcut for the Accept-Encoding header.
Accept-Encoding
my $language = $headers->accept_language; $headers = $headers->accept_language('de, en');
Shortcut for the Accept-Language header.
Accept-Language
my $ranges = $headers->accept_ranges; $headers = $headers->accept_ranges('bytes');
Shortcut for the Accept-Ranges header.
Accept-Ranges
my $origin = $headers->access_control_allow_origin; $headers = $headers->access_control_allow_origin('*');
Shortcut for the Access-Control-Allow-Origin header from Cross-Origin Resource Sharing.
Access-Control-Allow-Origin
$headers = $headers->add(Foo => 'one value'); $headers = $headers->add(Foo => 'first value', 'second value');
Add one or more header values with one or more lines.
# "Vary: Accept" # "Vary: Accept-Encoding" $headers->vary('Accept')->add(Vary => 'Accept-Encoding')->to_string;
my $allow = $headers->allow; $headers = $headers->allow('GET, POST');
Shortcut for the Allow header.
Allow
$headers = $headers->append(Vary => 'Accept-Encoding');
Append value to header and flatten it if necessary.
# "Vary: Accept" $headers->append(Vary => 'Accept')->to_string; # "Vary: Accept, Accept-Encoding" $headers->vary('Accept')->append(Vary => 'Accept-Encoding')->to_string;
my $authorization = $headers->authorization; $headers = $headers->authorization('Basic Zm9vOmJhcg==');
Shortcut for the Authorization header.
Authorization
my $cache_control = $headers->cache_control; $headers = $headers->cache_control('max-age=1, no-cache');
Shortcut for the Cache-Control header.
Cache-Control
my $clone = $headers->clone;
Clone headers.
my $connection = $headers->connection; $headers = $headers->connection('close');
Shortcut for the Connection header.
Connection
my $disposition = $headers->content_disposition; $headers = $headers->content_disposition('foo');
Shortcut for the Content-Disposition header.
Content-Disposition
my $encoding = $headers->content_encoding; $headers = $headers->content_encoding('gzip');
Shortcut for the Content-Encoding header.
Content-Encoding
my $language = $headers->content_language; $headers = $headers->content_language('en');
Shortcut for the Content-Language header.
Content-Language
my $len = $headers->content_length; $headers = $headers->content_length(4000);
Shortcut for the Content-Length header.
Content-Length
my $location = $headers->content_location; $headers = $headers->content_location('http://127.0.0.1/foo');
Shortcut for the Content-Location header.
Content-Location
my $range = $headers->content_range; $headers = $headers->content_range('bytes 2-8/100');
Shortcut for the Content-Range header.
Content-Range
my $policy = $headers->content_security_policy; $headers = $headers->content_security_policy('default-src https:');
Shortcut for the Content-Security-Policy header from Content Security Policy 1.0.
Content-Security-Policy
my $type = $headers->content_type; $headers = $headers->content_type('text/plain');
Shortcut for the Content-Type header.
Content-Type
my $cookie = $headers->cookie; $headers = $headers->cookie('f=b');
Shortcut for the Cookie header from RFC 6265.
Cookie
my $date = $headers->date; $headers = $headers->date('Sun, 17 Aug 2008 16:27:35 GMT');
Shortcut for the Date header.
Date
my $dnt = $headers->dnt; $headers = $headers->dnt(1);
Shortcut for the DNT (Do Not Track) header, which has no specification yet, but is very commonly used.
DNT
my $etag = $headers->etag; $headers = $headers->etag('"abc321"');
Shortcut for the ETag header.
ETag
my $expect = $headers->expect; $headers = $headers->expect('100-continue');
Shortcut for the Expect header.
Expect
my $expires = $headers->expires; $headers = $headers->expires('Thu, 01 Dec 1994 16:00:00 GMT');
Shortcut for the Expires header.
Expires
$headers = $headers->from_hash({'Cookie' => 'a=b'}); $headers = $headers->from_hash({'Cookie' => ['a=b', 'c=d']}); $headers = $headers->from_hash({});
Parse headers from a hash reference, an empty hash removes all headers.
my $value = $headers->header('Foo'); $headers = $headers->header(Foo => 'one value'); $headers = $headers->header(Foo => 'first value', 'second value');
Get or replace the current header values.
my $host = $headers->host; $headers = $headers->host('127.0.0.1');
Shortcut for the Host header.
Host
my $date = $headers->if_modified_since; $headers = $headers->if_modified_since('Sun, 17 Aug 2008 16:27:35 GMT');
Shortcut for the If-Modified-Since header.
If-Modified-Since
my $etag = $headers->if_none_match; $headers = $headers->if_none_match('"abc321"');
Shortcut for the If-None-Match header.
If-None-Match
my $bool = $headers->is_finished;
Check if header parser is finished.
my $bool = $headers->is_limit_exceeded;
Check if headers have exceeded "max_line_size" or "max_lines".
my $date = $headers->last_modified; $headers = $headers->last_modified('Sun, 17 Aug 2008 16:27:35 GMT');
Shortcut for the Last-Modified header.
Last-Modified
my $bytes = $headers->leftovers;
Get and remove leftover data from header parser.
my $link = $headers->link; $headers = $headers->link('<http://127.0.0.1/foo/3>; rel="next"');
Shortcut for the Link header from RFC 5988.
Link
my $location = $headers->location; $headers = $headers->location('http://127.0.0.1/foo');
Shortcut for the Location header.
Location
my $names = $headers->names;
Return a list of all currently defined headers.
# Names of all headers say for @{$headers->names};
my $origin = $headers->origin; $headers = $headers->origin('http://example.com');
Shortcut for the Origin header from RFC 6454.
Origin
$headers = $headers->parse("Content-Type: text/plain\x0d\x0a\x0d\x0a");
Parse formatted headers.
my $authenticate = $headers->proxy_authenticate; $headers = $headers->proxy_authenticate('Basic "realm"');
Shortcut for the Proxy-Authenticate header.
Proxy-Authenticate
my $authorization = $headers->proxy_authorization; $headers = $headers->proxy_authorization('Basic Zm9vOmJhcg==');
Shortcut for the Proxy-Authorization header.
Proxy-Authorization
my $range = $headers->range; $headers = $headers->range('bytes=2-8');
Shortcut for the Range header.
Range
my $referrer = $headers->referrer; $headers = $headers->referrer('http://example.com');
Shortcut for the Referer header, there was a typo in RFC 2068 which resulted in Referer becoming an official header.
Referer
$headers = $headers->remove('Foo');
Remove a header.
my $accept = $headers->sec_websocket_accept; $headers = $headers->sec_websocket_accept('s3pPLMBiTxaQ9kYGzzhZRbK+xOo=');
Shortcut for the Sec-WebSocket-Accept header from RFC 6455.
Sec-WebSocket-Accept
my $extensions = $headers->sec_websocket_extensions; $headers = $headers->sec_websocket_extensions('foo');
Shortcut for the Sec-WebSocket-Extensions header from RFC 6455.
Sec-WebSocket-Extensions
my $key = $headers->sec_websocket_key; $headers = $headers->sec_websocket_key('dGhlIHNhbXBsZSBub25jZQ==');
Shortcut for the Sec-WebSocket-Key header from RFC 6455.
Sec-WebSocket-Key
my $proto = $headers->sec_websocket_protocol; $headers = $headers->sec_websocket_protocol('sample');
Shortcut for the Sec-WebSocket-Protocol header from RFC 6455.
Sec-WebSocket-Protocol
my $version = $headers->sec_websocket_version; $headers = $headers->sec_websocket_version(13);
Shortcut for the Sec-WebSocket-Version header from RFC 6455.
Sec-WebSocket-Version
my $server = $headers->server; $headers = $headers->server('Mojo');
Shortcut for the Server header.
Server
my $cookie = $headers->set_cookie; $headers = $headers->set_cookie('f=b; path=/');
Shortcut for the Set-Cookie header from RFC 6265.
Set-Cookie
my $status = $headers->status; $headers = $headers->status('200 OK');
Shortcut for the Status header from RFC 3875.
Status
my $policy = $headers->strict_transport_security; $headers = $headers->strict_transport_security('max-age=31536000');
Shortcut for the Strict-Transport-Security header from RFC 6797.
Strict-Transport-Security
my $te = $headers->te; $headers = $headers->te('chunked');
Shortcut for the TE header.
TE
my $single = $headers->to_hash; my $multi = $headers->to_hash(1);
Turn headers into hash reference, array references to represent multiple headers with the same name are disabled by default.
say $headers->to_hash->{DNT};
my $str = $headers->to_string;
Turn headers into a string, suitable for HTTP messages.
my $trailer = $headers->trailer; $headers = $headers->trailer('X-Foo');
Shortcut for the Trailer header.
Trailer
my $encoding = $headers->transfer_encoding; $headers = $headers->transfer_encoding('chunked');
Shortcut for the Transfer-Encoding header.
Transfer-Encoding
my $upgrade = $headers->upgrade; $headers = $headers->upgrade('websocket');
Shortcut for the Upgrade header.
Upgrade
my $agent = $headers->user_agent; $headers = $headers->user_agent('Mojo/1.0');
Shortcut for the User-Agent header.
User-Agent
my $vary = $headers->vary; $headers = $headers->vary('*');
Shortcut for the Vary header.
Vary
my $authenticate = $headers->www_authenticate; $headers = $headers->www_authenticate('Basic realm="realm"');
Shortcut for the WWW-Authenticate header.
WWW-Authenticate
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.