NAME
Mojo::URL - Uniform Resource Locator
SYNOPSIS
use Mojo::URL;
# Parse
my $url = Mojo::URL->new(
'http://sri:foobar@kraih.com:3000/foo/bar?foo=bar#23'
);
print $url->scheme;
print $url->userinfo;
print $url->user;
print $url->password;
print $url->host;
print $url->port;
print $url->path;
print $url->query;
print $url->fragment;
# Build
my $url = Mojo::URL->new;
$url->scheme('http');
$url->userinfo('sri:foobar');
$url->host('kraih.com');
$url->port(3000);
$url->path->parts(qw/foo bar/);
$url->query->params(foo => 'bar');
$url->fragment(23);
print "$url";
DESCRIPTION
Mojo::URL implements a subset of RFC 3986 for Uniform Resource Locators.
ATTRIBUTES
authority
my $authority = $url->autority;
$url = $url->authority('root:pass%3Bw0rd@localhost:8080');
base
my $base = $url->base;
$url = $url->base(Mojo::URL->new);
fragment
my $fragment = $url->fragment;
$url = $url->fragment('foo');
host
my $host = $url->host;
$url = $url->host('127.0.0.1');
password
my $password = $url->password;
$url = $url->password('pass;w0rd');
path
my $path = $url->path;
$url = $url->path(Mojo::Path->new);
port
my $port = $url->port;
$url = $url->port(8080);
query
my $query = $url->query;
$url = $url->query(Mojo::Parameters->new);
scheme
my $scheme = $url->scheme;
$url = $url->scheme('http');
user
my $user = $url->user;
$url = $url->user('root');
userinfo
my $userinfo = $url->userinfo;
$url = $url->userinfo('root:pass%3Bw0rd');
Returns the userinfo part of the URL if called without arguments. Returns the invocant if called with arguments. Expects a string containing user credentials.
METHODS
Mojo::URL inherits all methods from Mojo::Base and implements the following new ones.
new
my $url = Mojo::URL->new;
my $url = Mojo::URL->new('http://127.0.0.1:3000/foo?f=b&baz=2#foo');
clone
my $url2 = $url->clone;
is_abs
my $is_abs = $url->is_abs;
parse
$url = $url->parse('http://127.0.0.1:3000/foo/bar?fo=o&baz=23#foo');
to_abs
my $abs = $url->to_abs;
my $abs = $url->to_abs(Mojo::URL->new('http://kraih.com/foo'));
to_rel
my $rel = $url->to_rel;
my $rel = $url->to_rel(Mojo::URL->new('http://kraih.com/foo'));
to_string
my $string = $url->to_string;