# Apache::Session::Generate::ModUsertrack - phpMan

## 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 Apache for details.

## AUTHOR
    Tatsuhiko Miyagawa <<miyagawa@bulknews.net>>

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

## SEE ALSO
    [Apache::Session], [Apache::Session::Flex], mod_usertrack