NAME

        Apache::CookieToQuery - Rewrite query string by adding cookie information

SYNOPSIS

        In httpd.conf or similiar
        
        <Location /YourLocation>
                PerlAddVar IncludeCookie WSID
                PerlAddVar IncludeCookie SID
                PerlAddVar IncludeCookie QID
                PerlAddVar CookieAlias WSID:WebSiteId
                PerlAddVar CookieAlias QID:QueryId
                PerlFixupHandler Apache::CookieToQuery  
        </Location>

        Requests for http://yourhost/YourLocation?extra_params=12345
        
        Will now become rewritten so they look similiar to:
        
        http://yourhost/YourLocation?WebSiteId=<cookie WSID>;SID=<cookie SID>;QueryId=<cookie QID>;extra_params=12345
        
        Where <cookie WSID> for example is the value of cookie named WSID

DESCRIPTION

        This module will aid in adding cookie information to your query strings
        so that cgi scripts or handlers underneath can have immidate benefit
        
        It requires mod_perl + Apache web server with PERL_FIXUP callback hook enabled
        for more information on callback hooks refer to: 
        http://perl.apache.org/docs/1.0/guide/install.html#Callback_Hooks
        
        IncludeCookie specifies cookie names that will be added, if none are specified
        any cookie name is taken into consideration
        
        CookieAlias specifies cookie name to look for and cookie name to alias it with 
        when query string is rewritten, if alias for a cookie name does not exist, 
        original cookie name will be used 
        
        Please note that in the current implementation cookies always take precedence 
        over query string paramaters 
        
        This package should always be installed as PerlFixupHandler so that it can execute before
        standard PerlResponseHandler is called

BUGS

        If you find any, please let the author know

AUTHOR

        Alex Pavlovic
        CPAN ID: ALEXP
        alex.pavlovic@taskforce-1.com
        

COPYRIGHT

        Copyright (c) 2002 Alex Pavlovic. All rights reserved.
        This program is free software; you can redistribute
        it and/or modify it under the same terms as Perl itself.
        
        The full text of the license can be found in the
        LICENSE file included with this module.

SEE ALSO

        perl(1).

PUBLIC METHODS

        Each public function/method is described here.
        These are how you should interact with this module.

handler

        Usage     : handler ( $apache ) 
        Purpose   : rewrites the query string of the original request
        Returns   : Server constant OK
        Argument  : apache instance