PHP 7.0.6 Released

Memcached::append

(PECL memcached >= 0.1.0)

Memcached::appendAppend data to an existing item

Description

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

Memcached::append() appends the given value string to the value of an existing item. The reason that value is forced to be a string is that appending mixed types is not well-defined.

Note:

If the Memcached::OPT_COMPRESSION is enabled, the operation will fail and a warning will be issued, because appending compressed data to a value that is potentially already compressed is not possible.

Parameters

key

The key under which to store the value.

value

The string to append.

Return Values

Returns TRUE on success or FALSE on failure. The Memcached::getResultCode() will return Memcached::RES_NOTSTORED if the key does not exist.

Examples

Example #1 Memcached::append() example

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

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

The above example will output:

string(6) "abcdef"

See Also

User Contributed Notes

mattsch at gmail dot com
1 year ago
This method emits this php warning if OPT_COMPRESSION is not explicitly set to false (tested with libmemcached 1.0.18 & pecl-memcached 2.1.0):

PHP Warning:  Memcached::append(): cannot append/prepend with compression turned on
To Top