Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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)

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)
Man Page