Session 配置 - 类別

配置

Session 是透过 fuel/core/config/session.php 配置档案进行配置。它已经填充了一个预设配置群组。你可以藉由複製此配置档案到你的应用程序 config 目录，并根据需求修改该档案，以覆写此配置群组并添加新群组。

以下的全域配置值可以被定义：

true

'cookie'

false

true

''

'/'

false

7200

false

300

'flash'

true

''

'Session-Id'

true

false

array(
	'cookie_name'    => 'fuelcid',
	'write_on_set'   => true
 )

array(
	'cookie_name'    => 'fuelfid',
	'path'           => '/tmp',
	'gc_probability' => 5
 )

array(
	'cookie_name'    => 'fueldid',
	'database'       => 'development',
	'table'          => 'sessions',
	'gc_probability' => 5
 )

array(
	'cookie_name'    => 'fuelmid',
	'servers'        => array( 'default' =>
				array(
					'host' => '127.0.0.1',
					'port' => 11211,
					'weight' => 100
				)
			)
 )

array(
	'cookie_name'    => 'fuelrid',
	'database'       => 'default'
 )

对于每个 session 储存驱动来说，存在一个单独的配置段落。 这个段落包含驱动特定参数， 而且你可以用它来覆盖特定储存驱动的全域参数。

Session 类别在以下列表中的位置检查 session id。它不在此时验证， 第一个找到的值会被使用，而且如果证明它无效，新的 session 会被建立：

• Post 资料，它会检查 Input::post 定义在 "post_cookie_name" 中的变数
• Cookie，它会检查名称定义在 "cookie_name" 中的有效 cookie。
• Get 资料，它会检查 Input::get 名称定义在 "cookie_name" 中的变数。
• http 表头，它会检查名称定义在 "http_header_name" 中的表头。

session 类别配置与 cookie 类别配置是独立的。 重要的是你正确地配置 cookie_domain 及 cookie_path 项目。 值得注意的是，'localhost' 网域不被多数现代浏览器接受是有效值！

'fuelcid'

'fuelfid'

'/tmp'

5

'fueldid'

null

'sessions'

CREATE TABLE IF NOT EXISTS `sessions` (
  `session_id` varchar(40) NOT NULL,
  `previous_id` varchar(40) NOT NULL,
  `user_agent` text NOT NULL,
  `ip_hash` char(32) NOT NULL DEFAULT '',
  `created` int(10) unsigned NOT NULL DEFAULT '0',
  `updated` int(10) unsigned NOT NULL DEFAULT '0',
  `payload` longtext NOT NULL,
  PRIMARY KEY (`session_id`),
  UNIQUE KEY `PREVIOUS` (`previous_id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

5

'fuelmid'

array (
	'default' =>
		array(
'host' => '127.0.0.1',
'port' => 11211,
'weight' => 100
		)
)

'fuelrid'

'default'

使用 Oil 来建立／控制你的 sessions 资料表

一个 oil 任务提供你能使用 oil 命令列实用工具， 来建立、移除以及清空你的 session 资料表。

# 显示选单
$ php oil r session

# 建立 sessions 资料表
$ php oil r session:create

# 移除 sessions 资料表
$ php oil r session:remove

# 清空（truncate）sessions 资料表
$ php oil r session:clear

PHP 原生 session 模拟

When activated via the configuration, the Session class will enable some basic emulation of PHP's native session mechanism that can be accessed via the $_SESSION global variable. This only works on the default session instance, the one accessable via the static interface.

When enabled, the Session class will setup a custom session handler, that will capture the calls to the PHP functions session_start(), session_close() and session_write_close(). If will force a close at shutdown when an open native session is detected.

• When session_start() is called, all session data stored in the Fuel session store you have configured will be copied into the $_SESSION array, so it can be accessed by non-Fuel code requiring sessions.
• When the session is closed, a diff is made and changes in $_SESSION are copied back into the Fuel session store.

This mechanism means that if you have a session variable that is modified both inside- and outside Fuel, it is undetermined which of the changes will be saved. This depends on the position of the last session_close() call in the code. If the session is not closed, Fuel's shutdown event will close it, and it will overwrite any data set via standard Session calls!