# Package =
**extends** `CGI::Session::Driver::DBI `
=head1 NAME
CGI::Session::Driver::mysql - CGI::Session driver for [[MySQL]] database
=head1 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 \} );
=head1 DESCRIPTION
B stores session records in a [[MySQL]] table. For details see L<CGI::Session::Driver::DBI|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 );
=head2 DRIVER ARGUMENTS
B driver supports all the arguments documented in L<CGI::Session::Driver::DBI|CGI::Session::Driver::DBI>. In addition, I 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'\});
=head2 BACKWARDS COMPATIBILITY
For backwards compatibility, you can also set the table like this before calling C<new()>. However, it is not recommended because it can cause conflicts in a persistent environment.
$CGI::Session::MySQL::TABLE\_NAME = 'my\_sessions';
=head1 LICENSING
For support and licensing see L<CGI::Session|CGI::Session>.