Timm Murray > Apache-GopherHandler-0.1 > Apache::GopherHandler



Annotate this POD


New  1
Open  0
View/Report Bugs
Module Version: 0.1   Source  


  Apache::GopherHandler - Gopher protocol implementation for Apache2


 # In your Apache2 configuration
 <VirtualHost _default_:70>
        DocumentRoot /home/www/data/gopher
                $Apache::GopherHandler::Config{doc_root} = '/home';
                $Apache::GopherHandler::Config{server}   = 'localhost';
                $Apache::GopherHandler::Config{port}     = 70;
                $Apache::GopherHandler::Config{handler}  =
        PerlModule                    Apache::GopherHandler
        PerlProcessConnectionHandler  Apache::GopherHandler


One of the earliest goals stated in the Gopher Manifesto (http://27.org/gopher-manifesto/) was to have an Apache plugin that would run a Gopher server. So here it is.

This requires Apache2/mod_perl. Sorry. The first version of Apache is too HTTP-centric. In Apache2, the project moved twards a more generalized server that was modular enough to support other protocols. Without that, making Gopher available on Apache servers would have been impossible, or at least very difficult.

For the moment, this isn't a very full-featured server. If you want a stand-alone Gopher server, you're probably better off using PyGopherd (http://gopher.quux.org:70/devel/gopher/Downloads/pygopherd). If you want to convert an existing Apache2 server into something that can support Gopher and you don't care about (or can wait for) some fancier features, then this will work fine.

This relies on the Gopher::Server module to take care most of the implementation details of the protocol. Apache::GopherHandler provides the glue between that module and Apache.


The best way to run Apache::GopherHandler is inside an Apache <VirtualHost>. Actual configuration is done either inside a <Perl> directive or your Apache startup file. This is done by accessing the hash %Apache::GopherHandler::Config. Keys can be specified here that will be passed to the Gopher::Server::Requesthandler you specify in the handler key. Currently, only Gopher::Server::RequestHandler::File is supported (but this will change).

At a minimum, the following keys are needed:


The Gopher::Server::RequestHandler class to use. Default: Gopher::Server::RequestHandler::File


The hostname of the server. Default: localhost


The TCP port of the server. Make sure your <VirtualHost> directive specifies this port and the Apache Listen option is set to listen on this port. Default: 70


The root of the Gopher server on your file system. Default: /noexists/




 Timm Murray
 E-Mail: tmurray@cpan.org
 Homepage: http://www.wumpus-cave.net


Apache::GopherHandler Copyright (C) 2004 Timm Murray




syntax highlighting: