plack::app::file(3pm) [debian man page]

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)

Plack::App::CGIBin(3pm) 				User Contributed Perl Documentation				   Plack::App::CGIBin(3pm)

NAME

       Plack::App::CGIBin - cgi-bin replacement for Plack servers

SYNOPSIS

	 use Plack::App::CGIBin;
	 use Plack::Builder;

	 my $app = Plack::App::CGIBin->new(root => "/path/to/cgi-bin")->to_app;
	 builder {
	     mount "/cgi-bin" => $app;
	 };

	 # Or from the command line
	 plackup -MPlack::App::CGIBin -e 'Plack::App::CGIBin->new(root => "/path/to/cgi-bin")->to_app'

DESCRIPTION

       Plack::App::CGIBin allows you to load CGI scripts from a directory and convert them into a PSGI application.

       This would give you the extreme easiness when you have bunch of old CGI scripts that is loaded using cgi-bin of Apache web server.

HOW IT WORKS

       This application checks if a given file path is a perl script and if so, uses CGI::Compile to compile a CGI script into a sub (like
       ModPerl::Registry) and then run it as a persistent application using CGI::Emulate::PSGI.

       If the given file is not a perl script, it executes the script just like a normal CGI script with fork & exec. This is like a normal web
       server mode and no performance benefit is achieved.

       The default mechanism to determine if a given file is a Perl script is as follows:

       o   Check if the filename ends with ".pl". If yes, it is a Perl script.

       o   Open the file and see if the shebang (first line of the file) contains the word "perl" (like "#!/usr/bin/perl"). If yes, it is a Perl
	   script.

       You can customize this behavior by passing "exec_cb" callback, which takes a file path to its first argument.

       For example, if your perl-based CGI script uses lots of global variables and such and are not ready to run on a persistent environment, you
       can do:

	 my $app = Plack::App::CGIBin->new(
	     root => "/path/to/cgi-bin",
	     exec_cb => sub { 1 },
	 )->to_app;

       to always force the execute option for any files.

AUTHOR

       Tatsuhiko Miyagawa

SEE ALSO

       Plack::App::File CGI::Emulate::PSGI CGI::Compile Plack::App::WrapCGI

       See also Plack::App::WrapCGI if you compile one CGI script into a PSGI application without serving CGI scripts from a directory, to remove
       overhead of filesystem lookups, etc.

perl v5.14.2							    2011-11-02						   Plack::App::CGIBin(3pm)