Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — 存储一个元素

说明

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

Memcached::set()将value 存储在一个memcached服务器上的key下。expiration参数用于控制值的过期时间。

值可以是任何有效的非资源型php类型，因为资源类型不能被序列化存储。如果Memcached::OPT_COMPRESSION 选项开启，序列化的值同样会被压缩存储。

参数

key: 用于存储值的键名。
value: 存储的值。
expiration: 到期时间，默认为 0。更多信息请参见到期时间。

返回值

成功时返回 TRUE，或者在失败时返回 FALSE。如需要则使用 Memcached::getResultCode()。

范例

Example #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));
/* 'object'这个key将在5分钟后过期 */
$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() - Store an item on a specific server
Memcached::add() - 向一个新的key下面增加一个元素
Memcached::replace() - 替换已存在key下的元素