---
name: "CGI::Session::Driver::mysql"
section: "3pm"
platform: "linux"
package: "perl-cgi-session"
version: "4.49-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/CGI::Session::Driver::mysql"
---

# CGI::Session::Driver::mysql(3pm)

CGI::Session driver for MySQL database

## NAME

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

## SYNOPSIS

```
    $s = CGI::Session->new( 'driver:mysql', $sid);
    $s = CGI::Session->new( 'driver:mysql', $sid, { DataSource  => 'dbi:mysql:test',
                                                   User        => 'sherzodr',
                                                   Password    => 'hello' });
    $s = CGI::Session->new( '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 = CGI::Session->new('driver:mysql', undef,
    {
        TableName=>'session',
        IdColName=>'my_id',
        DataColName=>'my_data',
        DataSource=>'dbi:mysql:project',
    });
```

or

```
    $s = CGI::Session->new('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 = CGI::Session->new( 'driver:mysql', $sid, {DataSource=>'shopping_cart'});
    # is the same as:
    $s = CGI::Session->new( 'driver:mysql', $sid, {DataSource=>'dbi:mysql:shopping_cart'});
```

### BACKWARDS COMPATIBILITY

As of V 4.30, the global variable `$CGI::Session::MySQL::TABLE_NAME` cannot be used to set the session table's name.

This is due to changes in CGI::Session::Driver's **new()** method, which now allows the table's name to be changed (as well as allowing both the 'id' column name and the 'a\_session' column name to be changed).

See the documentation for CGI::Session::Driver::DBI for details.

In particular, the new syntax for `new()` applies to all database drivers, whereas the old - and bad - global variable method only applied to MySQL.

Alternately, call `$session` -\> table\_name('new\_name') just after creating the session object if you wish to change the session table's name.

## LICENSING

For support and licensing see CGI::Session.