CGI::Session::Driver::sqlite(3pm)

CGI::Session::Driver::sqlite3pm

Cgi::session driver for sqlite

Usage

    $s = CGI::Session->new("driver:sqlite", $sid, {DataSource=>'/my/folder/sessions.sqlt'});
    $s = CGI::Session->new("driver:sqlite", $sid, {Handle=>$dbh});

or

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

Overview

sqlite driver stores session data in SQLite files using DBD::SQLite DBI driver. More details see CGI::Session::Driver::DBI, its parent class.

Driver arguments

Supported driver arguments are DataSource and Handle. At most only one of these arguments can be set while creating session object.

DataSource should be in the form of "dbi:SQLite:dbname=/path/to/db.sqlt". If "dbi:SQLite:" is missing it will be prepended for you. If Handle is present it should be database handle ($dbh) returned by DBI::connect().

As of version 1.7 of this driver, the third argument is NOT optional. Using a default database in the temporary directory is a security risk since anyone on the machine can create and/or read your session data. If you understand these risks and still want the old behavior, you can set the "DataSource" option to '/tmp/sessions.sqlt'.

Bugs and limitations

None known.

Licensing

For support and licensing see CGI::Session

Releases

11 releases since Debian 4.0 (Etch); the text changed 7 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9–11
  7. 12–13
  8. Arch

From perl-cgi-session 4.49-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.