セッション¶

セッションの設定¶

セッションの設定は Configure に格納されます。トップレベルの Session キー下に格納され、いくつかのオプションが用意されています:

• Session.cookie - セッションクッキーの名前を変更します。

• Session.timeout - CakePHP のセッションハンドラがセッションを破棄するまでの時間を 分 単位で指定します。この値は下記の Session.autoRegenerate に影響を与えます。 これは CakeSession により処理されています。

• Session.cookieTimeout - 任意のセッション継続時間を 分 単位で指定します。 もしこれが未定義の場合、 Session.timeout の値が使用されます。これは、 セッションクッキーに影響を与え、PHP 自体により処理されています。

• Session.checkAgent - ユーザーエージェントはチェックされるべきです。 ユーザーエージェントがセッションとマッチしない場合、そのセッションは破棄されます。

• Session.autoRegenerate - この設定を有効にするとセッションとセッション ID の 自動更新が有効になります。この値はリクエストの継続的な追跡にセッションの Config.countdown の値を使用します。カウントダウンが 0 になると、セッション ID が 再生成されます。これはセキュリティ上の理由でセッション ID を頻繁に変更する場合に有用な オプションです。セッションの再生成が必要なリクエスト数のコントロールは、 CakeSession::$requestCountdown の変更によって可能です。

• Session.defaults - セッションの設定の基礎としてビルトインのデフォルト設定を使用出来ます。

• Session.handler - カスタムセッションハンドラーの定義が可能です。コアデータベースと キャッシュセッションハンドラーが使います。このオプションは以前のバージョンの Session.save を置き換えます。詳しくはセッションハンドラーの追加情報をご覧下さい。

• Session.ini - 追加のセッション ini 設定を config に加えることが出来ます。 これは Session.handler と合わせて以前のバージョンのカスタムセッションハンドリング機能を 置き換えます。

• Session.cacheLimiter - セッションクッキーで使用するキャッシュ制御ヘッダーを定義できます。 デフォルトは、 must-revalidate です。このオプションは 2.8.0 で追加されました。

CakePHP のデフォルトは、アプリケーションが SSL プロトコル上にある時、 session.cookie_secure が有効 (true) です。SSL と SSL 以外のプロトコルで アプリケーションを動かす場合、セッション消失の問題が発生するかも知れません。 SSL と SSL 以外のドメイン両方でセッションにアクセスする必要がある場合、 これを無効にします:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.cookie_secure' => false
    )
));

2.0 において、セッションクッキーパスのデフォルトは / です。これを変更する場合は session.cookie_path ini フラグにアプリケーションのディレクトリパス を指定することが出来ます:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.cookie_path' => '/app/dir'
    )
));

もし、php のデフォルトのセッション設定を使用している場合、session.gc_maxlifetime で タイムアウトの設定を上書きすることができます。デフォルトは、24 分です。 より長いセッションに合わせるために ini 設定を変更してください:

Configure::write('Session', array(
    'defaults' => 'php',
    'timeout' => 2160, // 36 hours
    'ini' => array(
        'session.gc_maxlifetime' => 129600 // 36 hours
    )
));

ビルトインセッションハンドラーと設定¶

CakePHP にはいくつかビルトインなセッションの設定があります。 これらをセッションの設定の基本として使用するか、完全にカスタマイズした ソリューションを作成するかは自由です。デフォルトを使用する場合、単純に 'defaults' キーに使用したいデフォルト名をセットします。セッション config で宣言をすればサブセッティングだけを上書きすることも出来ます:

Configure::write('Session', array(
    'defaults' => 'php'
));

上記はビルトインの 'php' 設定を使用します。下記のように全てまたは部分的に 設定を上書きすることも出来ます:

Configure::write('Session', array(
    'defaults' => 'php',
    'cookie' => 'my_app',
    'timeout' => 4320 //3 days
));

上記は 'php' 設定のタイムアウトとクッキー名を上書きします。ビルトイン設定は:

• php - php.ini ファイルの標準設定に沿ってセッションを保存します。

• cake - セッションをファイルとして app/tmp/sessions に保存します。 ホストの設定がホームディレクトリ以外の書き込みを禁止している場合、有効なオプションです。

• database ビルトインデータベースのセッションを使用します。詳しくは下記をご覧下さい。

• cache - ビルトインキャッシュのセッションを使用します。詳しくは下記をご覧下さい。

Configure::write('Session', array(
    'userAgent' => false,
    'cookie' => 'my_cookie',
    'timeout' => 600,
    'handler' => array(
        array('Foo', 'open'),
        array('Foo', 'close'),
        array('Foo', 'read'),
        array('Foo', 'write'),
        array('Foo', 'destroy'),
        array('Foo', 'gc'),
    ),
    'ini' => array(
        'cookie_secure' => 1,
        'use_trans_sid' => 0
    )
));

Configure::write('Session', array(
    'defaults' => 'database',
    'handler' => array(
        'model' => 'CustomSession'
    )
));

Configure::write('Session', array(
    'defaults' => 'database'
));

CREATE TABLE `cake_sessions` (
  `id` varchar(255) NOT NULL DEFAULT '',
  `data` text,
  `expires` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`)
);

$ Console/cake schema create sessions

Configure::write('Session', array(
    'defaults' => 'cache',
    'handler' => array(
        'config' => 'session'
    )
));

ini ディレクティブの設定¶

デフォルト設定はセッション用に共通の土台を提供します。必要に応じて 特定の ini フラグを微調整することもあります。 CakePHP ではデフォルト 設定にしろ、カスタム設定にしろ、両者の ini 設定をカスタマイズ 出来ます。セッション設定の ini キーで、個別の設定値を指定 することが可能です。例えば session.gc_divisor のような設定を コントロールするのに使えます:

Configure::write('Session', array(
    'defaults' => 'php',
    'ini' => array(
        'session.gc_divisor' => 1000,
        'session.cookie_httponly' => true
    )
));

カスタムセッションハンドラーの作成¶

カスタムセッションハンドラーの作成は CakePHP で容易に出来ます。 この例で、セッションをキャッシュ (apc) とデータベースの両方に 格納するセッションハンドラーを作成します。これは apc による、 キャッシュ限度を超過した際の消失について心配が不要な、最善で 高速な IO をもたらします。

まずカスタムクラスを作成し app/Model/Datasource/Session/ComboSession.php として保存する必要があります。クラスは以下のようになります:

App::uses('DatabaseSession', 'Model/Datasource/Session');

class ComboSession extends DatabaseSession implements CakeSessionHandlerInterface {
    public $cacheKey;

    public function __construct() {
        $this->cacheKey = Configure::read('Session.handler.cache');
        parent::__construct();
    }

    // セッションからデータ読み込み
    public function read($id) {
        $result = Cache::read($id, $this->cacheKey);
        if ($result) {
            return $result;
        }
        return parent::read($id);
    }

    // セッションへデータ書き込み
    public function write($id, $data) {
        Cache::write($id, $data, $this->cacheKey);
        return parent::write($id, $data);
    }

    // セッションの破棄
    public function destroy($id) {
        Cache::delete($id, $this->cacheKey);
        return parent::destroy($id);
    }

    // 期限切れセッションの削除
    public function gc($expires = null) {
        Cache::gc($this->cacheKey);
        return parent::gc($expires);
    }
}

このクラスはビルトインの DatabaseSession を継承しそのロジックや振る舞いを 重複して定義することを避けています。それぞれのオペレーションを Cache オペレーションでラップします。これで高速なキャッシュからセッションを取得しつつ、 キャッシュ限度の考慮を不要にしています。このセッションハンドラーを使うのもまた簡単です。 core.php のセッションブロックを以下のように設定します:

Configure::write('Session', array(
    'defaults' => 'database',
    'handler' => array(
        'engine' => 'ComboSession',
        'model' => 'Session',
        'cache' => 'apc'
    )
));

// apc キャッシュ config を追加すること
Cache::config('apc', array('engine' => 'Apc'));

これでアプリケーションはカスタムセッションハンドラーを使ったセッションデータの読み書きを行います。

class CakeSession¶

セッションデータの読み込みと書き込み¶

アプリケーション内のコンテキストにより、セッションへのアクセスを提供するクラスが異なります。 コントローラーでは SessionComponent を使用します。 ビューでは SessionHelper を使用します。どこからでも使用可能な CakeSession をでセッションにアクセスすることも出来ます。他のインターフェースと同じく、 CakeSession はシンプルな CRUD インターフェースを提供します。

static CakeSession::read($key)¶

Set::classicExtract() 互換記法を用いてセッションから値を読み込みます:

CakeSession::read('Config.language');

static CakeSession::write($key, $value)¶

$key はドット区切りで $value の書き込み先を指定します:

CakeSession::write('Config.language', 'eng');

static CakeSession::delete($key)¶

セッションからデータ削除が必要なら削除も可能です:

CakeSession::delete('Config.language');

コントローラーとビューからのセッションデータへのアクセス方法については、 セッション と SessionHelper を合わせてご覧下さい。