data/TWiki/CGISessionDriverSqliteDotPm.txt,v
author Colas Nahaboo <colas@nahaboo.net>
Sat, 26 Jan 2008 15:50:53 +0100
changeset 0 414e01d06fd5
permissions -rw-r--r--
RELEASE 4.2.0 freetown
     1 head	1.1;
     2 access;
     3 symbols;
     4 locks; strict;
     5 comment	@# @;
     6 
     7 
     8 1.1
     9 date	2008.01.22.03.21.36;	author TWikiContributor;	state Exp;
    10 branches;
    11 next	;
    12 
    13 
    14 desc
    15 @buildrelease
    16 @
    17 
    18 
    19 1.1
    20 log
    21 @buildrelease
    22 @
    23 text
    24 @---+ Package ==
    25 
    26 %TOC%
    27 =head1 NAME
    28 
    29 CGI::Session::Driver::sqlite - CGI::Session driver for SQLite
    30 
    31 =head1 SYNOPSIS
    32 
    33     $s = new CGI::Session("driver:sqlite", $sid, {DataSource=>'/my/folder/sessions.sqlt'});
    34     $s = new CGI::Session("driver:sqlite", $sid, {Handle=>$dbh});
    35 
    36 =head1 DESCRIPTION
    37 
    38 B<sqlite> driver stores session data in SQLite files using L<DBD::SQLite|DBD::SQLite> DBI driver. More details see L<CGI::Session::Driver::DBI|CGI::Session::Driver::DBI>, its parent class.
    39 
    40 =head1 DRIVER ARGUMENTS
    41 
    42 Supported driver arguments are I<DataSource> and I<Handle>. B<At most> only one of these arguments can be set while creating session object.
    43 
    44 I<DataSource> should be in the form of C<dbi:SQLite:dbname=/path/to/db.sqlt>. If C<dbi:SQLite:> is missing it will be prepended for you. If I<Handle> is present it should be database handle (C<$dbh>) returned by L<DBI::connect()|DBI/connect()>.
    45 
    46 As of version 1.7 of this driver, the third argument is B<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 C<DataSource> option to I<'/tmp/sessions.sqlt'>.
    47 
    48 =head1 BUGS AND LIMITATIONS
    49 
    50 None known.
    51 
    52 =head1 LICENSING
    53 
    54 For support and licensing see L<CGI::Session|CGI::Session>
    55 
    56 @