array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'memcached.set.php', 1 => 'Memcached::set', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.resetserverlist.php', 1 => 'Memcached::resetServerList', ), 'next' => array ( 0 => 'memcached.setbykey.php', 1 => 'Memcached::setByKey', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/memcached/memcached/set.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PECL memcached >= 0.1.0)
Memcached::set — アイテムを格納する
Memcached::set() は、
指定したキー key
で memcache サーバー上に
value
を格納します。
expiration
パラメータで、
この値をいつ有効期限切れにするのかを制御することができます。
値に指定できるのは、リソース型以外の PHP の任意の型です。
リソース型はシリアライズすることができないため、使用することができません。
Memcached::OPT_COMPRESSION
オプションをオンにすると、
シリアライズしたデータを格納する前に圧縮を行います。
成功した場合に 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) { }