actix-extras/guide/src/qs_12.md

Static file handling

Individual file

It is possible to serve static files with custom path pattern and NamedFile. To match path tail we can use [.*] regex.

# extern crate actix_web;
use actix_web::*;
use std::path::PathBuf;

fn index(req: HttpRequest) -> Result<fs::NamedFile> {
    let path: PathBuf = req.match_info().query("tail")?;
    Ok(fs::NamedFile::open(path)?)
}

fn main() {
    Application::new()
        .resource(r"/a/{tail:.*}", |r| r.method(Method::GET).f(index))
        .finish();
}

Directory

To serve files from specific directory and sub-directories StaticFiles could be used. StaticFiles must be registered with Application::handler() method otherwise it won't be able to server sub-paths.

# extern crate actix_web;
use actix_web::*;

fn main() {
    Application::new()
        .handler("/static", fs::StaticFiles::new(".", true))
        .finish();
}

First parameter is a base directory. Second parameter is show_index, if it is set to true directory listing would be returned for directories, if it is set to false then 404 Not Found would be returned instead of directory listing.

Instead of showing files listing for directory, it is possible to redirect to specific index file. Use StaticFiles::index_file() method to configure this redirect.