Plack::App::File(3pm) User Contributed Perl Documentation Plack::App::File(3pm)NAME
Plack::App::File - Serve static files from root directory
SYNOPSIS
use Plack::App::File;
my $app = Plack::App::File->new(root => "/path/to/htdocs")->to_app;
# Or map the path to a specific file
use Plack::Builder;
builder {
mount "/favicon.ico" => Plack::App::File->new(file => '/path/to/favicon.ico');
};
DESCRIPTION
This is a static file server PSGI application, and internally used by Plack::Middleware::Static. This application serves file from document
root if the path matches with the local file. Use Plack::App::Directory if you want to list files in the directory as well.
CONFIGURATION
root
Document root directory. Defaults to "." (current directory)
file
The file path to create responses from. Optional.
If it's set the application would ALWAYS create a response out of the file and there will be no security check etc. (hence fast). If
it's not set, the application uses "root" to find the matching file.
encoding
Set the file encoding for text files. Defaults to "utf-8".
content_type
Set the file content type. If not set Plack::MIME will try to detect it based on the file extension or fall back to "text/plain".
AUTHOR
Tatsuhiko Miyagawa
SEE ALSO
Plack::Middleware::Static Plack::App::Directory
perl v5.14.2 2014-10-09 Plack::App::File(3pm)
Check Out this Related Man Page
Plack::Middleware::File::Sass(3pm) User Contributed Perl Documentation Plack::Middleware::File::Sass(3pm)NAME
Plack::Middleware::File::Sass - Sass and SCSS support for all Plack frameworks
SYNOPSIS
use Plack::App::File;
use Plack::Builder;
builder {
mount "/stylesheets" => builder {
enable "File::Sass";
Plack::App::File->new(root => "./stylesheets");
};
};
# Or with Middleware::Static
enable "File::Sass", syntax => "scss";
enable "Static", path => qr/.css$/, root => "./static";
DESCRIPTION
Plack::Middleware::File::Sass is a Plack middleware component that works with Plack::App::File or Plack::Middleware::Static to compile Sass
<http://sass-lang.com/> templates into CSS stylesheet in every request.
When a request comes in for .css file, this middleware changes the internal path to .sass or .scss, depending on the configuration, in the
same directory. If the Sass template is found, a new CSS stylesheet is built on memory and served to the browsers. Otherwise, it falls
back to the original .css file in the directory.
This middleware should be very handy for the development. While Sass to CSS rendering is reasonably fast, for the production environment
you might want to precompile Sass templates to CSS files on disk and serves them with a real web server like nginx or lighttpd.
SASS BACKENDS
If you have the sass gem version higher than 3 installed and have the "sass" executable available in your PATH, this module automatically
uses the command to convert Sass or SCSS into CSS. If the command is not available and you have Text::Sass perl module available, it will
be used. Otherwise you'll get an exception during the initialization of this middleware component.
OPTIONS
syntax
Defines which syntax to use. Valid values are sass and scss. Defaults to sass.
AUTHOR
Tatsuhiko Miyagawa <miyagawa@bulknews.net>
LICENSE
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
Plack::App::File Text::Sass http://sass-lang.com/ <http://sass-lang.com/>
perl v5.12.4 2011-02-14 Plack::Middleware::File::Sass(3pm)