view release on metacpan or  search on metacpan

SQLite.pm  view on Meta::CPAN

CGI::Session::SQLite - CGI::Session driver for SQLite

=head1 SYNOPSIS
    
    use CGI::Session::SQLite
    $session = new CGI::Session("driver:SQLite", undef, {...});

For more examples, consult L<CGI::Session> manual

=head1 DESCRIPTION

CGI::Session::SQLite is a CGI::Session driver utilizing the SQLite DBMS.
To write your own drivers for B<CGI::Session> refer to the L<CGI::Session> manual.

=head1 STORAGE

To store session data in SQLite database, you first need to create a
suitable table for it with the following command:

    CREATE TABLE sessions (
        id CHAR(32) NOT NULL UNIQUE,
        a_session TEXT NOT NULL
    );

You can also add any number of additional columns to the table, but the
above "id" and "a_session" are required.

If you want to store the session data in other table than "sessions",
before creating the session object you need to set the special variable
$CGI::Session::SQLite::TABLE_NAME to the name of the table:

    use CGI::Session;
    $CGI::Session::SQLite::TABLE_NAME = 'my_sessions';
    $session = new CGI::Session("driver:SQLite", undef, {Handle=>$dbh});

=head1 COPYRIGHT

Copyright (C) 2004 Brian Moyles <bmoyles@gmail.com>. All rights reserved.

This library is free software and can be modified and distributed under the same
terms as Perl itself. 

=head1 AUTHOR

Brian Moyles <bmoyles@gmail.com>

=head1 SEE ALSO

=over 4

=item *

L<CGI::Session|CGI::Session> - CGI::Session manual

=item *

L<CGI::Session::Tutorial|CGI::Session::Tutorial> - extended CGI::Session manual

=item *

L<CGI::Session::CookBook|CGI::Session::CookBook> - practical solutions for real life problems

=item *

B<RFC 2965> - "HTTP State Management Mechanism" found at ftp://ftp.isi.edu/in-notes/rfc2965.txt

=item *

L<CGI|CGI> - standard CGI library

=item *

L<Apache::Session|Apache::Session> - another fine alternative to CGI::Session

=back

=cut


# $Id: SQLite.pm,v 1.7 2004/10/21 23:10:32 bmoyles Exp $