Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — アイテムを格納する

説明

public Memcached::set(string $key, mixed $value, int $expiration = 0): bool

Memcached::set() は、指定したキー key で memcache サーバー上に value を格納します。 expiration パラメータで、この値をいつ有効期限切れにするのかを制御することができます。

値に指定できるのは、リソース型以外の PHP の任意の型です。リソース型はシリアライズすることができないため、使用することができません。 Memcached::OPT_COMPRESSION オプションをオンにすると、シリアライズしたデータを格納する前に圧縮を行います。

パラメータ

key: 値の格納先のキー。
value: 格納する値。
expiration: 期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限を参照ください。

戻り値

成功した場合に true を、失敗した場合に false を返します。必要に応じて Memcached::getResultCode() を使用しましょう。

例

例1 Memcached::set() の例

<?php
$m = new Memcached();
$m->addServer('localhost', 11211);

$m->set('int', 99);
$m->set('string', 'a simple string');
$m->set('array', array(11, 12));
/* expire 'object' key in 5 minutes */
$m->set('object', new stdClass, time() + 300);


var_dump($m->get('int'));
var_dump($m->get('string'));
var_dump($m->get('array'));
var_dump($m->get('object'));
?>

上の例の出力は、たとえば以下のようになります。

int(99)
string(15) "a simple string"
array(2) {
  [0]=>
  int(11)
  [1]=>
  int(12)
}
object(stdClass)#1 (0) {
}

参考

Memcached::setByKey() - 指定したサーバーにアイテムを格納する
Memcached::add() - アイテムを新しいキーで追加する
Memcached::replace() - 既存のキーのアイテムを入れ替える