Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append将数据追加到现有项

说明

public Memcached::append(string $key, string $value): ?bool

Memcached::append() 将给定的 value 字符串追加到现有项的值。value 强制为字符串的原因是,追加混合类型没有明确定义。

注意:

如果启用 Memcached::OPT_COMPRESSION,操作将失败并发出警告,因为无法将压缩数据追加到可能已经压缩的值。

参数

key

要存储值的键。

value

要追加的字符串。

返回值

成功时返回 true,失败时返回 false。当压缩开启时,返回 null

错误/异常

当压缩开启时,返回 null 并引发 E_WARNING

范例

范例 #1 Memcached::append() 范例

<?php
$m
= new Memcached();
$m->addServer('localhost', 11211);
$m->setOption(Memcached::OPT_COMPRESSION, false);

$m->set('foo', 'abc');
$m->append('foo', 'def');
var_dump($m->get('foo'));
?>

上面的例子将输出

string(6) "abcdef"

参见

添加注释

用户贡献的注释 1 条注释

1
mattsch at gmail dot com
9 年前
如果 OPT_COMPRESSION 未显式设置为 false,此方法会发出以下 php 警告(使用 libmemcached 1.0.18 & pecl-memcached 2.1.0 测试)

PHP 警告:Memcached::append(): 无法在压缩开启的情况下追加/预先添加
To Top