Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CGI::Session::Driver::UserlContributed Perl DocuCGI::Session::Driver::mysql(3)

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.

perl v5.32.0			  2011-07-11	CGI::Session::Driver::mysql(3)

NAME | SYNOPSIS | DESCRIPTION | LICENSING

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CGI::Session::Driver::mysql&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help