---
name: "MojoX::Dispatcher::Static"
section: "3pm"
platform: "linux"
package: "libmojolicious-perl"
version: "0.999926-1+squeeze2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/MojoX::Dispatcher::Static"
---

# MojoX::Dispatcher::Static(3pm)

Serve Static Files

## NAME

MojoX::Dispatcher::Static - Serve Static Files

## SYNOPSIS

```
    use MojoX::Dispatcher::Static;
    # New dispatcher
    my $dispatcher = MojoX::Dispatcher::Static->new(
        prefix => '/images',
        root   => '/ftp/pub/images'
    );
    # Dispatch
    my $success = $dispatcher->dispatch($c);
```

## DESCRIPTION

MojoX::Dispatcher::Static is a dispatcher for static files with `"RANGE"` and `"IF-MODIFIED-SINCE"` support.

## ATTRIBUTES

MojoX::Dispatcher::Static implements the following attributes.

### "prefix"

```
    my $prefix  = $dispatcher->prefix;
    $dispatcher = $dispatcher->prefix('/static');
```

Prefix path to remove from incoming paths before dispatching.

### "types"

```
    my $types   = $dispatcher->types;
    $dispatcher = $dispatcher->types(MojoX::Types->new);
```

MIME types, by default a MojoX::Types object.

### "root"

```
    my $root    = $dispatcher->root;
    $dispatcher = $dispatcher->root('/foo/bar/files');
```

Directory to serve static files from.

## METHODS

MojoX::Dispatcher::Static inherits all methods from Mojo::Base and implements the following ones.

### "dispatch"

```
    my $success = $dispatcher->dispatch($c);
```

Dispatch a MojoX::Controller object.

### "serve"

```
    my $success = $dispatcher->serve($c, 'foo/bar.html');
```

Serve a specific file.

### "serve\_404"

```
    my $success = $dispatcher->serve_404($c);
    my $success = $dispatcher->serve_404($c, '404.html');
```

Serve a `404` error page, guaranteed to render at least a default page.

### "serve\_500"

```
    my $success = $dispatcher->serve_500($c);
    my $success = $dispatcher->serve_500($c, '500.html');
```

Serve a `500` error page, guaranteed to render at least a default page.

### "serve\_error"

```
    my $success = $dispatcher->serve_error($c, 404);
    my $success = $dispatcher->serve_error($c, 404, '404.html');
```

Serve error page, guaranteed to render at least a default page.

## SEE ALSO

Mojolicious, Mojolicious::Guides, \<http://mojolicious.org\>.