NAME

WWW::Mechanize::CGI - Use WWW::Mechanize with CGI applications.

SYNOPSIS

    use CGI;
    use WWW::Mechanize::CGI;
    
    # Using a external CGI application
    
    $mech = WWW::Mechanize::CGI->new;
    $mech->cgi_application('/path/to/cgi/executable.cgi');
    
    $response = $mech->get('http://localhost/');
    
    
    # Using a inline CGI callback
    
    $mech = WWW::Mechanize::CGI->new;
    $mech->cgi( sub {
        
        my $q = CGI->new;
        
        print $q->header,
              $q->start_html('Hello World'),
              $q->h1('Hello World'),
              $q->end_html;
    });
    
    $response = $mech->get('http://localhost/');

DESCRIPTION

Provides a convenient way of using CGI applications with WWW::Mechanize.

METHODS

new

Behaves like, and calls, WWW::Mechanize's "new" method. Any parms passed in get passed to WWW::Mechanize's constructor.

cgi

Coderef to be used to execute the CGI application.

cgi_application('/path/to/cgi/executable.cgi')

Path to CGI executable.

env( [, key => value ] )

Set/Get additional environment variables to be used in CGI. Takes a hash and returns a hash.

    $mech->env( DOCUMENT_ROOT => '/export/www/myapp' );

fork

Set to a true value if you want to fork() before executing CGI.

AUTHOR

Christian Hansen, "ch@ngmedia.com"

LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as perl itself.