array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'memcached.append.php', 1 => 'Memcached::append', 2 => '向已存在元素追加数据', ), 'up' => array ( 0 => 'class.memcached.php', 1 => 'Memcached', ), 'prev' => array ( 0 => 'memcached.addservers.php', 1 => 'Memcached::addServers', ), 'next' => array ( 0 => 'memcached.appendbykey.php', 1 => 'Memcached::appendByKey', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/memcached/memcached/append.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append — 向已存在元素追加数据

说明

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

Memcached::append() 向已存在的元素值末尾追加 value 字符串。value 强制为字符串的原因是因为对于 mix 类型的追加没有明确定义。

注意:

如果启用 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"

参见