2024 日本 PHP 研討會

Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append將資料附加到現有項目

說明

public Memcached::append(字串 $key, 字串 $value): ?布林值

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 則註解

mattsch at gmail dot com
9 年前
如果 OPT_COMPRESSION 沒有明確設定為 false,這個方法會發出這個 php 警告 (使用 libmemcached 1.0.18 和 pecl-memcached 2.1.0 測試)

PHP 警告: Memcached::append(): 無法在啟用壓縮的情況下附加/前置資料
To Top