(no commit message)
[openafs-wiki.git] / TWiki / CGISessionDriverSqliteDotPm.mdwn
1 # <a name="Package &lt;code&gt;="></a> Package =
2
3 <div>
4   <ul>
5     <li><a href="#Package =="> Package ==</a></li>
6   </ul>
7 </div>
8
9 =head1 NAME
10
11 CGI::Session::Driver::sqlite - CGI::Session driver for SQLite
12
13 =head1 SYNOPSIS
14
15 $s = new CGI::Session("driver:sqlite", $sid, \{DataSource=&gt;'/my/folder/sessions.sqlt'\}); $s = new CGI::Session("driver:sqlite", $sid, \{Handle=&gt;$dbh\});
16
17 =head1 DESCRIPTION
18
19 B driver stores session data in SQLite files using L&lt;DBD::SQLite|DBD::SQLite&gt; DBI driver. More details see L&lt;CGI::Session::Driver::DBI|CGI::Session::Driver::DBI&gt;, its parent class.
20
21 =head1 DRIVER ARGUMENTS
22
23 Supported driver arguments are I and I. B only one of these arguments can be set while creating session object.
24
25 I should be in the form of C&lt;dbi:SQLite:dbname=/path/to/db.sqlt&gt;. If C&lt;dbi:SQLite:&gt; is missing it will be prepended for you. If I is present it should be database handle (C&lt;$dbh&gt;) returned by L&lt;DBI::connect()|DBI/connect()&gt;.
26
27 As of version 1.7 of this driver, the third argument is B 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 option to I&lt;'/tmp/sessions.sqlt'&gt;.
28
29 =head1 BUGS AND LIMITATIONS
30
31 None known.
32
33 =head1 LICENSING
34
35 For support and licensing see L&lt;CGI::Session|CGI::Session&gt;