Documentation

設定

セッションクラスは、 fuel/core/config/session.php 設定ファイルで設定されています。それは、デフォルト設定が入力されています。この config ファイルをあなたのアプリケーションの 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'
 )

それぞれのセッションストレージドライバについて、個別の設定のセクションが存在します。 このセクションでは、ドライバ固有のパラメータが含まれており、そして、 その特定のストレージドライバのためのグローバルなパラメータを上書きするために利用することができます。

セッションクラスは、セッション ID の以下のような場所をこの順番で確認します。 この時点では検証されまず、 それは最初に見つかった値が使用され、それが有効ではないと判明した場合に新しいセッションが作成されます：

• POST データ、それは "post_cookie_name" で定義された Input::post の変数を確認します。
• クッキー、それは "cookie_name" で定義された名前を持つ有効なクッキーを確認します。
• GET データ、それは "cookie_name" で定義された名前を持つ Input::get の変数を確認します。
• HTTP ヘッダ、それは "http_header_name" で定義された名前を持つヘッダをチェックします。

セッションクラスの設定は、 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 コマンドを使い、セッションテーブルを作成/制御する

oil コマンドラインユーティリティを使って、 sessions テーブルを作成、削除、クリアできるように、 oil タスクが提供されています。

# メニューを表示する
$ php oil r session

# sessions テーブルを作成する
$ php oil r session:create

# sessions テーブルを削除する
$ php oil r session:remove

# sessions テーブルをクリア (truncate) する
$ php oil r session:clear

PHP ネイティブセッションのエミュレーション

設定をアクティブにして起動すると、セッションクラスは、 $_SESSION グローバル変数を介してアクセスすることができ、 PHP のネイティブなセッション機構のいくつかの基本的なエミュレーションが可能になります。 これは、デフォルトのセッションインスタンス上で静的インタフェースを介してアクセス可能なもの限定で動作します。

有効にすると、セッションクラスは PHP の関数 session_start() 、 session_close() および session_write_close() への呼び出しをキャプチャするように、 カスタムセッションハンドラをセットアップします。 もしネイティブセッションが開かれているのを検出したときはシャットダウン時に強制的に 閉じられます。

• session_start() が呼び出された場合、設定した Fuel セッションストアに格納されているすべてのセッションデータは $_SESSION 配列にコピーされるため、セッションを必要とする Fuel ではないコードからアクセスできます。
• セッションが閉じられると、 $_SESSION の変化の差分が作られ Fuel セッションストアにコピーされます。

このメカニズムでは、 Fuel の内側と Fuel の外側の両方に変更されたセッション変数を持っている場合、どちらの変更が保存されるか未確定であることを意味します。 それはコードの最後の session_close() の呼び出し位置に依存します。 セッションが閉じられていない場合、 Fuel のシャットダウンイベントはそれを閉じ、そしてそれは、標準的なセッションの呼び出しを経由した任意のデータセットを上書きしてしまいます！