Cookie¶

コントローラーのセットアップ¶

Cookie の発行や操作の設定をすることができる値を以下に示します。これらの値によって Cookie コンポーネントがどのように動くかは、コントローラーの beforeFilter() メソッドでも特別に設定できます。

以下のサンプルコードは、 Cookie コンポーネントをコントローラーにインクルードする方法と、 セキュアな接続でのみ、 'example.com' というドメインの ‘/bakers/preferences/’ というパス以下で、1時間だけ有効な 'baker_id' という名前の HTTP のみで有効な Cookie の初期設定をするための例です。

public $components = array('Cookie');

public function beforeFilter() {
    parent::beforeFilter();
    $this->Cookie->name = 'baker_id';
    $this->Cookie->time = 3600;  // または '1 hour'
    $this->Cookie->path = '/bakers/preferences/';
    $this->Cookie->domain = 'example.com';
    $this->Cookie->secure = true;  // セキュアな HTTPS で接続している時のみ発行されます
    $this->Cookie->key = 'qSI232qs*&sXOw!adre@34SAv!@*(XSL#$%)asGb$@11~_+!@#HKis~#^';
    $this->Cookie->httpOnly = true;
}

それでは、その他の Cookie コンポーネントのメソッドの使い方を見ていきましょう。

コンポーネントの使い方¶

CookieComponent は Cookie を使った動作をするためにいくつかのメソッドを提供します。

CookieComponent::write(mixed $key, mixed $value = null, boolean $encrypt = true, mixed $expires = null)¶

write() は Cookie コンポーネントの中核をなすメソッドです。 $key は必要な Cookie の値につける名前を、$value は保存しておきたい情報を設定します。

$this->Cookie->write('name', 'Larry');

$key にドット記法を使うことで値をグルーピングすることもできます。

$this->Cookie->write('User.name', 'Larry');
$this->Cookie->write('User.role', 'Lead');

一度に2つ以上の Cookie を書き込みたい場合は、配列を渡すことができます。

$this->Cookie->write('User',
    array('name' => 'Larry', 'role' => 'Lead')
);

すべての Cookie の値は、既定では暗号化されます。平文で値を保存したい場合は、3つ目の引数に false を設定します。 値の暗号化をよりセキュアにするためには暗号化モードを 'aes' に設定してください。

$this->Cookie->write('name', 'Larry', false);

最後の引数 $expires は無効になる秒数を数値で指定します。使いやすくするために、 PHP の関数 strtotime() が解釈できる文字列を渡すこともできます。

// いずれの Cookie も1時間で無効になります。
$this->Cookie->write('first_name', 'Larry', false, 3600);
$this->Cookie->write('last_name', 'Masters', false, '1 hour');

CookieComponent::read(mixed $key = null)¶

このメソッドは、 $key で指定した名前をつけた Cookie の値を得るために使われます。

// “Larry” を出力します
echo $this->Cookie->read('name');

// ドット記法も使うことができます
echo $this->Cookie->read('User.name');

// ドット記法でグループにした値を配列として得る場合、例えば、
$this->Cookie->read('User');

// であれば、array('name' => 'Larry', 'role' => 'Lead') のような出力結果となります

CookieComponent::check($key)¶

パラメータ

• $key (string) -- 確認のためのキー。

key/path が存在し、値が null でない事を確認するために使われます。

バージョン 2.3 で追加: CookieComponent::check() は 2.3 で追加されました。

CookieComponent::delete(mixed $key)¶

$key で指定した名前の Cookie の値を削除します。ドット記法を使うことができます。

// ひとつの値を削除
$this->Cookie->delete('bar');

// bar という値を削除しますが、foo 以下のすべてを削除するわけではありません
$this->Cookie->delete('foo.bar');

CookieComponent::destroy()¶

現在の Cookie を破棄します。

CookieComponent::type($type)¶

暗号化の方法を変更することができます。デフォルトでは、後方互換性のために 'cipher' 方式が使われます。しかし、より安全にするためには 'rijndael' 方式や 'aes' 方式を使うべきです。

バージョン 2.2 で変更: 'rijndael' タイプが追加されました。

バージョン 2.5 で追加: 'aes' タイプが追加されました。