NAME
    Apache::Session::Memorycached - An implementation of Apache::Session

SYNOPSIS
     use Apache::Session::Memorycached;
 
        tie %session, 'Apache::Session::Memorycached', $cookie, {
              'servers' => ["10.75.1.19:11211"], #all write operations
              'local'  =>  ["localhost:11211"],  #read-only operations
              'timeout' => '300'
         };

     tie %s, 'Apache::Session::Memorycached', undef,
        {servers  => ['mymemcachedserver:port'],
         'timeout' => '300',
         'updateOnly' => 1 ,
         'principal' => uid,  
            };

    In order to optimize the network ,you can use a local memcached server.
    All read-only opération are sending fisrt at local server .If you need
    write ou rewrite data , the data is sending at the principal memcached
    sever and local cache too for synchronisation.

    note : 'updateOnly' => 1 just realize up-date operation not init
    operation. Init operation is use in order to book and lock the number
    session but it's not available in this module

      'principal' => uid :  this  parameter is use to create reverse reference 
      like this : MD5_hex(uid) => id_session in memcached server . By this it usefull to retrieve id_session from principal name . And add uid_MD5 => MD5_hex(uid) in main session .
 
DESCRIPTION
    This module is an implementation of Apache::Session. It uses the
    memcached system backing store . You may specify servers (principal) and
    locals caches for locking in arguments to the constructor. See the
    example, and the documentation for Apache::Session::Store::Memorycached
    and Cache::Memcached .

    The lemonldap project (SSO under GPL) uses this module

AUTHOR
    This module was written by eric german <germanlinux@yahoo.fr>.

     Completed by  Habib ZITOUNI <zitouni.habib@gmail.com> and 
    Hamza AISSAT<asthamza@hotmail.fr>

SEE ALSO
    Apache::Session::DB_File, Apache::Session::Flex, Apache::Session::MySQL,
    Apache::Session::Postgres, Apache::Session