/ 
Mojolicious-3.21
⭐ Starred 2674
/ Mojolicious::Routes
Security Advisories (10)
CPANSA-Mojolicious-2022-03 (2022-12-10)

Mojo::DOM did not correctly parse <script> tags.

CPANSA-Mojolicious-2021-02 (2021-06-01)

Small sessions could be used as part of a brute-force attack to decode the session secret.

CVE-2021-47208 (2021-03-16)

A bug in format detection can potentially be exploited for a DoS attack.

CVE-2018-25100 (2018-02-13)

Mojo::UserAgent::CookieJar leaks old cookies because of the missing host_only flag on empty domain.

CPANSA-Mojolicious-2015-01 (2015-02-02)

Directory traversal on Windows

CPANSA-Mojolicious-2018-03 (2018-05-19)

Mojo::UserAgent was not checking peer SSL certificates by default.

CVE-2020-36829 (2020-11-10)

Mojo::Util secure_compare can leak the string length. By immediately returning when the two strings are not the same length, the function allows an attacker to guess the length of the secret string using timing attacks.

CPANSA-Mojolicious-2018-02 (2018-05-11)

GET requests with embedded backslashes can be used to access local files on Windows hosts

CPANSA-Mojolicious-2014-01 (2014-10-07)

Context sensitivity of method param could lead to parameter injection attacks.

CVE-2024-58134 (2025-05-03)

Mojolicious versions from 0.999922 for Perl uses a hard coded string, or the application's class name, as an HMAC session cookie secret by default. These predictable default secrets can be exploited by an attacker to forge session cookies.  An attacker who knows or guesses the secret could compute valid HMAC signatures for the session cookie, allowing them to tamper with or hijack another user’s session.

NAME

Mojolicious::Routes - Always find your destination with routes!

SYNOPSIS

use Mojolicious::Routes;

# New routes tree
my $r = Mojolicious::Routes->new;

# Normal route matching "/articles" with parameters "controller" and
# "action"
$r->route('/articles')->to(controller => 'article', action => 'list');

# Route with a placeholder matching everything but "/" and "."
$r->route('/:controller')->to(action => 'list');

# Route with a placeholder and regex constraint
$r->route('/articles/:id', id => qr/\d+/)
  ->to(controller => 'article', action => 'view');

# Route with an optional parameter "year"
$r->route('/archive/:year')
  ->to(controller => 'archive', action => 'list', year => undef);

# Nested route for two actions sharing the same "controller" parameter
my $books = $r->route('/books/:id')->to(controller => 'book');
$books->route('/edit')->to(action => 'edit');
$books->route('/delete')->to(action => 'delete');

# Bridges can be used to chain multiple routes
$r->bridge->to(controller => 'foo', action =>'auth')
  ->route('/blog')->to(action => 'list');

# Simplified Mojolicious::Lite style route generation is also possible
$r->get('/')->to(controller => 'blog', action => 'welcome');
my $blog = $r->under('/blog');
$blog->post('/list')->to('blog#list');
$blog->get(sub { shift->render(text => 'Go away!') });

DESCRIPTION

Mojolicious::Routes is the core of the Mojolicious web framework.

See Mojolicious::Guides::Routing for more.

ATTRIBUTES

Mojolicious::Routes inherits all attributes from Mojolicious::Routes::Route and implements the following new ones.

base_classes

my $classes = $r->base_classes;
$r          = $r->base_classes(['MyApp::Controller']);

Base classes used to identify controllers, defaults to Mojolicious::Controller and Mojo.

cache

my $cache = $r->cache;
$r        = $r->cache(Mojo::Cache->new);

Routing cache, defaults to a Mojo::Cache object.

# Disable caching
$r->cache(0);

conditions

my $conditions = $r->conditions;
$r             = $r->conditions({foo => sub {...}});

Contains all available conditions.

hidden

my $hidden = $r->hidden;
$r         = $r->hidden([qw(attr has new)]);

Controller methods and attributes that are hidden from routes, defaults to attr, has and new.

namespace

my $namespace = $r->namespace;
$r            = $r->namespace('Foo::Bar::Controller');

Namespace used by dispatch to search for controllers.

shortcuts

my $shortcuts = $r->shortcuts;
$r            = $r->shortcuts({foo => sub {...}});

Contains all available shortcuts.

METHODS

Mojolicious::Routes inherits all methods from Mojolicious::Routes::Route and implements the following ones.

add_condition

$r = $r->add_condition(foo => sub {...});

Add a new condition.

add_shortcut

$r = $r->add_shortcut(foo => sub {...});

Add a new shortcut.

auto_render

$r->auto_render(Mojolicious::Controller->new);

Automatic rendering.

dispatch

my $success = $r->dispatch(Mojolicious::Controller->new);

Match routes with Mojolicious::Routes::Match and dispatch.

hide

$r = $r->hide(qw(foo bar));

Hide controller methods and attributes from routes.

route

my $route = $r->route;
my $route = $r->route('/:action');
my $route = $r->route('/:action', action => qr/\w+/);
my $route = $r->route(format => 0);

Generate route matching all HTTP request methods.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.