Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CGI::Application::DispUser:Contributed PeCGI::Application::Dispatch::Server(3)

NAME
       CGI::Application::Dispatch::Server - A simple HTTP server for
       developing with CGI::Application::Dispatch

SYNOPSIS
       This module is no longer	maintained or recommended. Use
       CGI::Application::Server	instead, which can do all this can and more.

	 use CGI::Application::Dispatch::Server;

	 my $server = CGI::Application::Dispatch::Server->new(
		    class    =>	'MyClass::Dispatch'
		    root_dir =>	'/home/project/www',
	  );
	 $server->run;

DESCRIPTION
       This is a simple	HTTP server for	for use	during development with
       CGI::Application::Dispatch.

       It's a helpful tool for working on a private copy of a website on a
       personal	computer. It's especially useful for working offline when you
       don't have easy access to a full-blown webserver.

       If you have customized dispatch args, it's recommended that you put
       them in their own class,	as described in	the CGI::Application::Dispatch
       docs.  That way,	they can be accessed directly through
       CGI::Application::Dispatch, or through here.

METHODS
   new()
	 my $server = CGI::Application::Dispatch::Server->new(
	       port	=> '80',		# optional, defaults to	8080
	       class	=> 'MyClass::Dispatch',	# optional, defaults CGI::Application::Dispatch
	       root_dir	=> './alphasite',	# optional, defaults to	"."
	 );

       Initialize the server. If you've	subclassed CGI::Application::Dispatch
       to provide your own "dispatch_args()", let us know that here.

       If you are also serving some static content, define "root_dir" with the
       root directory of this content.

Other Methods You Probably Don't Need to Know About
   dispatch_args()
	$server->dispatch_args(\%override_args);

       This accepts a hashref of arguments and merges it into
       CGI::Application::Dispatch's dispatch() arguments.

       Be aware	that this is a shallow merge, so a top level key name in the
       new hash	will completely	replace	one in the old hash with the same
       name.

       It is recommended that you put your dispatch args in a separate class
       instead,	as mentioned in	the DESCRIPTION.

   handle_request()
	 $self->handle_request($cgi);

       This will check the request URI and handle  it appropriately, printing
       to STDOUT upon success. There's generally no reason to call this
       directly.

CAVEATS
       This is a subclass of HTTP::Server::Simple and all of its caveats apply
       here as well.

BUGS
       If you are not sure the behavior	is a bug, please discuss it on the
       cgiapp mailing list ( cgiapp@lists.erlbaum.net ). If you	feel certain
       if you have found a bug,	please report it through rt.cpan.org.

ACKNOWLEDGEMENTS
       This module was cloned from CGI::Application::Server, which in turn
       borrowed	significant parts from HTTP::Request::AsCGI.

CONTRIBUTORS
       George Hartzell <hartzell@alerce.com> Mark Stosberg

COPYRIGHT AND LICENSE
       Copyright 2006 by George	Hartzell

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

perl v5.32.0			  2010-01CGI::Application::Dispatch::Server(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | Other Methods You Probably Don't Need to Know About | CAVEATS | BUGS | ACKNOWLEDGEMENTS | CONTRIBUTORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CGI::Application::Dispatch::Server&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help