Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
a legacy-code-friendly PSGI adapter for CGI::Application
tree: 8f88f88395

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/CGI/Application/Emulate
t
MANIFEST.SKIP
Makefile.PL
README

README

NAME
    CGI::Application::Emulate::PSGI - a legacy-code-friendly PSGI adapter
    for CGI::Application

SYNOPSIS
    Create a PSGI application from a CGI::Application project:

        # if using CGI::Application
        my $psgi_app = CGI::Application::Emulate::PSGI->handler(sub {
            my $webapp = WebApp->new();
            $webapp->run();
        });

        # if using CGI::Application::Dispatch
        my $psgi_app = CGI::Application::Emulate::PSGI->handler(sub {
            WebApp::Dispatch->dispatch();
        });

    See plackup for options for running a PSGI application.

DESCRIPTION
    CGI::Application::Emulate::PSGI allows a project based on
    CGI::Application to run as a PSGI application. Differences from
    CGI::Application::PSGI are:

    uses CGI.pm directly instead of CGI::PSGI
        CGI::Application::PSGI (that uses CGI::PSGI) does not support
        programs calling CGI.pm in func-style (like CGI::virtual_host()).
        CGI::Application::Emulate::PSGI sets up environment variables so
        that code using CGI.pm will work. Both approaches explictly use
        CGI.pm as the query object.

    compatible with CGI::Application::Dispatch
        The interface of CGI::Application::Emulate::PSGI is different from
        CGI::Application::PSGI, and is compatible with
        CGI::Application::Dispatch.

    headers are parsed and re-generated.
        This difference is in favor of CGI::Application::PSGI, which more
        directly generates the HTTP headers in PSGI format. This module
        requires additional processing: First CGI::Application builds the
        full response including the headers and body, then we parse the
        final result back into the header and body format called for by the
        PSGI spec.

AUTHOR
    Kazuho Oku <kazuhooku@gmail.com>

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    CGI::Application::PSGI, CGI

Something went wrong with that request. Please try again.