CGI::Session::Driver::mysql.3pm

Langue: en

Version: 2006-11-24 (mandriva - 22/10/07)

Section: 3 (Bibliothèques de fonctions)

NAME

CGI::Session::Driver::mysql - CGI::Session driver for MySQL database

SYNOPSIS

     $s = new CGI::Session( "driver:mysql", $sid);
     $s = new CGI::Session( "driver:mysql", $sid, { DataSource  => 'dbi:mysql:test',
                                                    User        => 'sherzodr',
                                                    Password    => 'hello' });
     $s = new CGI::Session( "driver:mysql", $sid, { Handle => $dbh } );
 
 

DESCRIPTION

mysql stores session records in a MySQL table. For details see CGI::Session::Driver::DBI, its parent class.

It's especially important for the MySQL driver that the session ID column be defined as a primary key, or at least ``unique'', like this:

  CREATE TABLE sessions (
      id CHAR(32) NOT NULL PRIMARY KEY,
      a_session TEXT NOT NULL
   );
 
 

DRIVER ARGUMENTS

mysql driver supports all the arguments documented in CGI::Session::Driver::DBI. In addition, DataSource argument can optionally leave leading ``dbi:mysql:'' string out:

     $s = new CGI::Session( "driver:mysql", $sid, {DataSource=>'shopping_cart'});
     # is the same as:
     $s = new CGI::Session( "driver:mysql", $sid, {DataSource=>'dbi:mysql:shopping_cart'});
 
 

BACKWARDS COMPATIBILITY

For backwards compatibility, you can also set the table like this before calling "new()". However, it is not recommended because it can cause conflicts in a persistent environment.

     $CGI::Session::MySQL::TABLE_NAME = 'my_sessions';
 
 

LICENSING

For support and licensing see CGI::Session.