Php/docs/memcached.set

• PHP Manual
• Memcached
• アイテムを格納する

Memcached::set

(PECL memcached >= 0.1.0)

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

説明

public Memcached::set ( string $key , mixed $value [, int $expiration ] ) : 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() - 既存のキーのアイテムを入れ替える