NAME
Apache::RewritingProxy - proxy that works by rewriting requested
documents with no client proxy config needed.
SYNOPSIS
# Configuration in httpd.conf
<Location /foo>
SetHandler perl-script
PerlHandler Apache::RewritingProxy
Options ExecCGI
PerlSendHeader On
</Location>
requests to /foo/
http://domain.dom/ will return the resource
located at
http://domain.dom with all links pointing to
/foo/
http://otherlink.dom
DESCRIPTION
This module allows proxying of web sites without any
configuration changes on the client's part. The client is simply
pointed to a URL using this module and it fetches the resource
and rewrites all links to continue using this proxy.
INSTALLATION
perl Makefile.PL; make; make install;
REQUIREMENTS
You need the following modules installed for this module to
work:
LWP::UserAgent
HTML::TokeParser
URI::URL
Of course, mod_perl and Apache would also help greatly.
Mod_Perl needs to have lots of hooks enabled. Preferably ALL_HOOKS
If not, the proxy will just give lots of server errors and not really
do that much. In particular, the Apache::Table and Apache::Util
are necessary for the module to run properly.
TODO/BUGS
Make cookies work better.
Eat fewer cookies in real life.
Make sites that rely on redirects and meta refreshes work
better.
Add caching or incorporate some other caching mechanism.
Add an external script to enable this to be called as a cgi or a
mod_perl module (for testing without restarting web daemons)
SEE ALSO
mod_perl(3), Apache(3), LWP::UserAgent(3)
AUTHOR
Apache::RewritingProxy by Ken Hagan <
[email protected]>
Debugging, suggestions, and helpful comments courtesy of
Mike Reiling <
[email protected]>
Tim DiLauro <
[email protected]>
and a couple other random people foolish enough to download
and run this thing.
COPYRIGHT
The Apache::RewritingProxy module is free software; you can
redistribute it and/or modify it under the same terms as Perl
itself.
