# 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"

### 参见

- Memcached::appendByKey() - 向指定服务器上已存在元素追加数据
- Memcached::prepend() - 向一个已存在的元素前面追加数据

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open