Annoucing the Apache::No404Proxy module, which serves as 404-free
HTTP proxy server! 

Note that you should be careful before really start using this...
Read the whole document!


The URL

    http://bulknews.net/lib/archives/Apache-No404Proxy-0.03.tar.gz

has entered CPAN as

  file: $CPAN/authors/id/M/MI/MIYAGAWA/Apache-No404Proxy-0.03.tar.gz
  size: 3204 bytes
   md5: 9c35ea3a8c5f8c852ccf5ac244c15b8a

--

NAME
    Apache::No404Proxy - 404 Redirecting Proxy

SYNOPSIS
      # in httpd.conf
      PerlTransHandler Apache::No404Proxy # default uses ::Google

DESCRIPTION
    Oops, 404 Not found. But wait..., there is a Google cache!

    Apache::No404Proxy serves as a proxy server, which automaticaly detects
    404 responses and redirects your browser to Google cache.

    Set your browser's proxy setting to Apache::No404Proxy based server, and
    it becomes 404 free now!

    See also the section on "RESRICTIONS FOR USE" before you use this.

SUBCLASSING
    Default cache archive is Google's one. Here is how you customize this.

    *   Declare your URL translator class.

    *   Inherit from Apache::No404Proxy.

    *   Define "translate()" method.

    That's all. Here is an example of implementation, extracted from
    Apache::No404Proxy::Google.

      package Apache::No404Proxy::Google;

      use WWW::Cache::Google;
      use base qw(Apache::No404Proxy);

      sub translate {
          my($class, $uri) = @_;
          return WWW::Cache::Google->new($uri)->as_string;
      }

    Define "translate()" method as a class method. Argument $uri is a string
    that represents URI.

    At last, remember to add the following line to httpd.conf:

      PerlTransHandler Apache::No404Proxy::Google

RESTRICTIONS FOR USE
    READ THIS before you use this proxy, especially for the default Google
    implementation.

    This proxy may or may not break terms of service of Google. In fact,
    Google prohibits *Automatic Query* without their permissions. See
    http://www.google.com/terms_of_service.html for details.

    Yes, this means you are recommended to contact staff at Google,
    otherwise your IP address would be blacklisted from Google :( The one
    you should get contact with is Ray Sidney, whose email addy is
    <[EMAIL PROTECTED]>. Thanks to Ray for his kindness.

AUTHOR
    Tastuhiko Miyagawa <[EMAIL PROTECTED]>

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

    This module comes WITHOUT ANY WARRANTY.

SEE ALSO
    the Apache::ProxyPassThru manpage, the LWP::UserAgent manpage, the
    Apache::No404Proxy::Google manpage



--
Tatsuhiko Miyagawa <[EMAIL PROTECTED]>

Reply via email to