root/Apache-StickyQuery/trunk/README

Revision 294 (checked in by miyagawa, 19 years ago)

Initial revision

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
Line 
1 NAME
2     Apache::StickyQuery - rewrites links using sticky query
3
4 SYNOPSIS
5       # in httpd.conf
6       <Location /stickyquery>
7       SetHandler perl-script
8       PerlHandler Apache::StickyQuery
9       </Location>
10
11       # filter aware
12       PerlModule Apache::StickyQuery
13       SetHandler perl-script
14       PerlSetVar Filter On
15       PerlHandler Apache::RegistryFilter Apache::StickyQuery Apache::Compress
16
17 DESCRIPTION
18     Suppose page transactions like this:
19
20            foo.cgi       =>   bar.html       =>   baz.cgi
21          ?sid=0123456                           ?sid=0123456
22
23     It is difficult to keep sid query parameter between two cgis without
24     cookies (or mod_rewrite hacks).
25
26     Apache::StickyQuery is a filter that rewrites all links in HTML file using
27     "sticky query". It would be useful in keeping state (ie. like Session IDs)
28     without using Cookies. See the HTML::StickyQuery manpage for details.
29
30     This module is Filter aware, meaning that it can work within
31     Apache::Filter framework without modification.
32
33 CONFIGURATION
34     StickyQuery parameters are automatically retrieved via current query
35     string. Options to change this is one of TODOs. (Hint: inherit from
36     Apache::StickyQuery and override `retrieve_param')
37
38     Apache::StickyQuery has the following configuration variables.
39
40       PerlSetVar StickyQueryAbs 0
41       PerlSetVar StickyQueryOverride 1
42       PerlSetVar StickyQueryRegexp ^/cgi-bin/
43
44     each of which corresponds to those of HTML::StickyQuery. See the
45     HTML::StickyQuery manpage for details.
46
47 AUTHOR
48     Tatsuhiko Miyagawa <miyagawa@bulknews.net>
49
50     This library is free software; you can redistribute it and/or modify it
51     under the same terms as Perl itself.
52
53 SEE ALSO
54     the HTML::StickyQuery manpage, the Apache::Filter manpage
55
Note: See TracBrowser for help on using the browser.