PHP:Memcached::set()的用法

Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — 存储一个元素

说明

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

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

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

参数

key

用于存储值的键名。

存储的值。

到期时间，默认为 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下的元素