RegistryFilter(3)

NAME

       Apache::RegistryFilter - run Perl scripts in an Apache::Filter chain

SYNOPSIS

        #in httpd.conf

        PerlModule Apache::RegistryFilter

        # Run the output of scripts through Apache::SSI
        <Files ~ "\.pl$">
         PerlSetVar Filter on
         SetHandler perl-script
         PerlHandler Apache::RegistryFilter Apache::SSI
        </Files>

        # Generate some Perl code using templates, then execute it
        <Files ~ "\.tmpl$">
         PerlSetVar Filter on
         SetHandler perl-script
         PerlHandler YourModule::GenCode Apache::RegistryFilter
        </Files>

DESCRIPTION

       This module is a subclass of Apache::RegistryNG, and contains all of
       its functionality.  The only difference between the two is that this
       module can be used in conjunction with the Apache::Filter module,
       whereas Apache::RegistryNG cannot.

       For information on how to set up filters, please see the codumentation
       for Apache::Filter.

INCOMPATIBILITIES

       At this point the only changes you might have to make to your Registry
       scripts are quite minor and obscure.  That is, unless I haven't thought
       of something.  Please let me know if any other changes are needed.

       * Don't call send_fd()
           If you call Apache's $r->send_fd($filehandle) method, the output
           will be sent directly to the browser instead of filtered through
           the filter chain.  This is okay if your script is the last filter
           in the chain, but clearly it won't work otherwise.

CAVEATS

       This is a subclass of Apache::RegistryNG, not Apache::Registry (which
       is not easily subclassible).  Apache::RegistryNG is supposed to be
       functionally equivalent to Apache::Registry, but it's a little less
       well-tested.

SEE ALSO

       perl(1), mod_perl(3), Apache::Filter(3)

AUTHOR

       Ken Williams <ken@forum.swarthmore.edu>

perl v5.8.6                       2003-01-31         Apache::RegistryFilter(3)