gitpan / apache-session-generate-modusertrack Goto Github PK

NAME
    Apache::Session::Generate::ModUsertrack - mod_usertrack for session ID
    generation

SYNOPSIS
      use Apache::Session::Flex;

      tie %session, 'Apache::Session::Flex', $id, {
          Store     => 'MySQL',
          Lock      => 'Null',
          Generate  => 'ModUsertrack',
          Serialize => 'Storable',
          ModUsertrackCookieName => 'usertrack', # optional
      };

DESCRIPTION
    Apache::Session::Generate::ModUsertrack enables you to use cookie tracked
    by mod_usertrack as session id for Apache::Session framework. This module
    fits well with long-term sessions, so better using RDBMS like MySQL for
    its storage.

CONFIGURATION
    This module accepts one extra configuration option.

    ModUsertrackCookieName
        Specifies cookie name used in mod_usertrack. `Apache' for default, so
        change this if you change it via `CookieName' directive in
        mod_usertrack.

LIMITATION WITHOUT MOD_PERL
    This module first tries to fetch named cookie, but will in vain ONLY WHEN
    the HTTP request is the first one from specific client to the
    mod_usertrack enabled Apache web server. It is because if the request is
    for the first time, cookies are not yet baked on clients.

    If you run scripts under mod_perl, this module tries to steal (not yet
    baked) cookie from Apache request notes.

    See the Apache manpage for details.

AUTHOR
    Tatsuhiko Miyagawa <[email protected]>

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

SEE ALSO
    the Apache::Session manpage, the Apache::Session::Flex manpage,
    mod_usertrack