• NAME
• SYNOPSIS
• DESCRIPTION
• DRIVER ARGUMENTS
• BACKWARDS COMPATIBILITY
• LICENSING

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
  );

To use different column names, change the 'create table' statement, and then simply do this:

    $s = new CGI::Session('driver:mysql', undef,
    {
        TableName=>'session',
        IdColName=>'my_id',
        DataColName=>'my_data',
        DataSource=>'dbi:mysql:project',
    });

or

    $s = new CGI::Session('driver:mysql', undef,
    {
        TableName=>'session',
        IdColName=>'my_id',
        DataColName=>'my_data',
        Handle=>$dbh,
    });

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.