Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append — データを既存のアイテムに追記する

説明

public function 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"

参考

Memcached::appendByKey() - 指定したサーバーでデータを既存のアイテムに追記する
Memcached::prepend() - 既存のアイテムの前にデータを付加する

関連キーワード:

Memcached 既存アイテム append 圧縮 appendByKey addServers memcached 強制理由挙動操作可能性格納先キー成功 addServer localhost setOption dump abcdef 参考サーバー prepend 付加