This constructor method is used to create a new URL object.

my $url = Badger::URL->new(
    'http://abw@badgerpower.com:8080/under/ground?animal=badger#stripe'
);

You can also specify the individual parts of the URL using named paramters.

my $url = Badger::URL->new(
    scheme      => 'http',
    user        => 'abw',
    host        => 'badgerpower.com',
    port        => '8080',
    path        => '/under/ground',
    query       => 'animal=badger',
    fragment    => 'stripe',
);

This method creates and returns a new Badger::URL object as a copy of the current one.

my $copy = $url->copy;

Method to return the complete URL.

print $url->url;
    # http://abw@badgerpower.com:8080/under/ground?animal=badger#stripe

This method is called automatically whenever the URL object is stringified.

print $url;                 # same as above

An alias for the url() method.

Method to get or set the scheme part of the URL.

$url = Badger::URL->new('http://badgerpower.com/);
print $url->scheme();       # http
$url->scheme('ftp');
print $url->scheme();       # ftp

Method to get or set the authority part of the URL. This is comprised of a host with optional user and/or port.

$url->authority('badgerpower.com');
$url->authority('abw@badgerpower.com');
$url->authority('badgerpower.com:8080');
$url->authority('abw@badgerpower.com:8080');

print $url->authority();    # abw@badgerpower.com:8080

Method to get or set the optional user in the authority part of the URL.

$url->user('fred');
print $url->user();         # fred
print $url->authority();    # fred@badgerpower.com:8080

Get or set the host in the authority part of the URL.

$url->host('example.org');
print $url->host();         # example.org
print $url->authority();    # fred@example.org:8080

Get or set the port in the authority part of the URL.

$url->port(1234);
print $url->port();         # 1234
print $url->authority();    # fred@example.org:1234

Get or set the path part of the URL.

$url->path('/right/here');
print $url->path();         # /right/here

Get or set the query part of the URL. The leading '?' is not considered part of the query and should be should not be included when setting a new query.

$url->query('animal=ferret');
print $url->query();        # animal=ferret

Get or set the query parameters.

# get params
my $params = $url->params;

# set params
$url->params(
    x => 10
);

Get or set the fragment part of the URL. The leading '#' is not considered part of the fragment and should be should not be included when setting a new fragment.

$url->fragment('feet');
print $url->fragment();     # feet

Returns a composite of the scheme and authority.

print $url->server();
    # http://fred@example.org:1234

Returns a composite of the server (scheme and authority) and path (in other words, everything up to the query or fragment).

print $url->server();
    # http://fred@example.org:1234/right/here

Returns a composite of the service (scheme, authority and path) and query (in other words, everything except the fragment).

print $url->request();
    # http://fred@example.org:1234/right/here?animal=badger

Returns a new URL with the relative path specified.

my $base = Badger::URL->new('http://badgerpower.com/example');
my $rel  = $base->relative('foo/bar');

print $rel;     # http://badgerpower.com/example/foo/bar

Returns a new URL with the absolute path specified. The leading / on the path provided as an argument is option. It will be assumed if not present.

my $base = Badger::URL->new('http://badgerpower.com/example');
my $rel  = $base->absolute('foo/bar');

print $rel;     # http://badgerpower.com/foo/bar

This method is used to set internal values.

This method reconstructs the authority from the host, port and user.

This method reconstructs the query from the query parameters.

This method reconstructs the complete URL from its constituent parts.

This method splits the authority into host, port and user.

This method splits the query string into query parameters.

Return a text representation of the structure of the URL object, for debugging purposes.

This constructor function can be used to create a new URL. If the argument is already a Badger::URL object then it is copied to create a new object. Otherwise a new Badger::URL object is created from scratch.

use Badger::URL 'URL';
my $url1 = URL('http://example.com/foo');
my $url2 = URL($url1);