Apache::CookieToQuery(3U)ser Contributed Perl DocumentatiAopnache::CookieToQuery(3)


NNAAMMEE
               Apache::CookieToQuery - Rewrite query string by adding cookie information

SSYYNNOOPPSSIISS
               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

DDEESSCCRRIIPPTTIIOONN
               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

BBUUGGSS
               If you find any, please let the author know

AAUUTTHHOORR
               Alex Pavlovic
               CPAN ID: ALEXP
               alex.pavlovic@taskforce-1.com

CCOOPPYYRRIIGGHHTT
               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.

SSEEEE AALLSSOO
               perl(1).

PPUUBBLLIICC MMEETTHHOODDSS
               Each public function/method is described here.
               These are how you should interact with this module.

       hhaannddlleerr

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


perl v5.8.7                       2006-01-24          Apache::CookieToQuery(3)