SYNOPSIS

Want to run PSGI application as a CGI script? Rename .psgi to .cgi and change the shebang line like:

#!/usr/bin/env plackup
# rest of the file can be the same as other .psgi file

You can alternatively create a .cgi file that contains something like:

  #!/usr/bin/perl
  use Plack::Loader;
  my $app = Plack::Util::load_psgi("/path/to/app.psgi");
  Plack::Loader->auto->run($app);

This will auto-recognize the CGI environment variable to load this class.

If you really want to explicitly load the CGI handler, you can. For instance you might do this when you want to embed a PSGI application server built into CGI-compatible perl-based web server:

  use Plack::Handler::CGI;
  Plack::Handler::CGI->new->run($app);

DESCRIPTION

This is a handler module to run any PSGI application as a CGI script.

UTILITY METHODS

setup_env()

  my $env = Plack::Handler::CGI->setup_env();
  my $env = Plack::Handler::CGI->setup_env(\%override_env);

Sets up the PSGI environment hash for a CGI request from %ENV> and returns it. You can provide a hashref of key/value pairs to override the defaults if you would like.