Memcached::set

(PECL memcached >= 0.1.0)

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

説明

public bool Memcached::set ( string $key , mixed $value [, int $expiration ] )

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() - 既存のキーのアイテムを入れ替える

add a note User Contributed Notes Memcached::set

miha at hribar dot info 16-Jul-2009 02:26


The method correctly returns false if you set the value to false. This means that in order to have proper fault checking mechanism in place you need to check the result code.



<?php

$Memcached = new Memcached();

$Memcached->addServer('localhost', 11211);

$Memcached->set('key', false);

var_dump($Memcached->get('key'));      // boolean false

var_dump($Memcached->getResultCode()); // int 0 which is  Memcached::RES_SUCCESS  

?>

add a note