HTTP::Server::Simple::CGI (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/HTTP::Server::Simple::CGI.3pm".)

NAME

HTTP::Server::Simple::CGI - CGI.pm-style version of HTTP::Server::Simple

DESCRIPTION

HTTP::Server::Simple was already simple, but some smart-ass pointed out that there is no in and so this module was born to isolate the .pm-related parts of this handler.

accept_hook

The accept_hook in this sub-class clears the environment to the start-up state.

post_setup_hook

Initializes the global object, as well as other environment settings.

cgi_class [Classname]

Gets or sets the class to use for creating the $cgi object passed to "handle_request".

Called with a single argument, it sets the coderef. Called with no arguments, it returns this field's current value.

To provide an initialization subroutine to be run in the post_setup_hook, see ``cgi_init''.

e.g.

    $server->cgi_class('CGI');

    $server->cgi_init(sub {
        require CGI;
        CGI::initialize_globals();
    });

or, if you want to use CGI::Simple,

    $server->cgi_class('CGI::Simple');
    $server->cgi_init(sub {
        require CGI::Simple;
    });

cgi_init [

CODEREF

]

A coderef to run in the post_setup_hook.

Called with a single argument, it sets the coderef. Called with no arguments, it returns this field's current value.

setup

This method sets up environment variables based on various meta-headers, like the protocol, remote host name, request path, etc.

See the docs in HTTP::Server::Simple for more detail.

handle_request

CGI

This routine is called whenever your server gets a request it can handle.

It's called with a

object that's been pre-initialized. You want to override this method in your subclass

handler

Handler implemented as part of HTTP::Server::Simple