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.

SEE ALSO

Test::WWW::Mechanize::CGI

WWW::Mechanize

LWP::UserAgent

HTTP::Request::AsCGI

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.