FuelPHP，PHP 5.3 框架 简体中文手册

配置

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!