Search:

Search all manuals
Search this manual
Manual
Couchbase Client Library: PHP 1.1
Community Wiki and Resources
Wiki: PHP Client Library
PHP Client Library
Couchbase Developer Guide 2.0
Couchbase Server Manual 2.0
SDK Forum
Additional Resources
Community Wiki
Community Forums
Couchbase SDKs
Parent Section
7 Update Operations
Chapter Sections
Chapters

7.1. Append and Prepend Operations

API Call$object->append($key, $value [, $expiry ] [, $casunique ] [, $persistto ] [, $replicateto ])
Asynchronousno
Description Append a value to an existing key
Returnsscalar; supported values:
 COUCHBASE_E2BIGThe Object is too big to be stored on the server 
 COUCHBASE_ENOMEMOut of Resources 
 COUCHBASE_ETMPFAILTemporary failure; try the operation again 
 COUCHBASE_KEY_ENOENTRequested document ID does not exist 
 COUCHBASE_NOT_MY_VBUCKETThe command was sent to the wrong server; may be triggered during a rebalance or failover operation. Retry the operation 
 COUCHBASE_NOT_STOREDThe object was not stored 
 docidDocument ID on success 
Arguments 
string $key Document ID used to identify the value
object $value Value to be stored
$expiry Expiry time for key. Values larger than 30*24*60*60 seconds (30 days) are interpreted as absolute times (from the epoch).
$casunique Unique value used to verify a key/value combination
$persistto Specify the number of nodes on which the document must be persisted to before returning.
$replicateto Specify the number of nodes on which the document must be replicated to before returning
Errors 
CouchbaseAuthenticationException Authentication to the Couchbase cluster failed
CouchbaseException Base exception class for all Couchbase exceptions
CouchbaseIllegalKeyException The key provided is not a legal key identifier
CouchbaseLibcouchbaseException An error occurred within the libcouchbase library used by th PHP extension
CouchbaseServerException An error occurred within the Couchbase cluster
API Call$object->prepend($key, $value [, $expiry ] [, $casunique ] [, $persistto ] [, $replicateto ])
Asynchronousno
Description Prepend a value to an existing key
Returnsscalar; supported values:
 COUCHBASE_E2BIGThe Object is too big to be stored on the server 
 COUCHBASE_ENOMEMOut of Resources 
 COUCHBASE_ETMPFAILTemporary failure; try the operation again 
 COUCHBASE_KEY_ENOENTRequested document ID does not exist 
 COUCHBASE_NOT_MY_VBUCKETThe command was sent to the wrong server; may be triggered during a rebalance or failover operation. Retry the operation 
 COUCHBASE_NOT_STOREDThe object was not stored 
 docidDocument ID on success 
Arguments 
string $key Document ID used to identify the value
object $value Value to be stored
$expiry Expiry time for key. Values larger than 30*24*60*60 seconds (30 days) are interpreted as absolute times (from the epoch).
$casunique Unique value used to verify a key/value combination
$persistto Specify the number of nodes on which the document must be persisted to before returning.
$replicateto Specify the number of nodes on which the document must be replicated to before returning
Errors 
CouchbaseAuthenticationException Authentication to the Couchbase cluster failed
CouchbaseException Base exception class for all Couchbase exceptions
CouchbaseIllegalKeyException The key provided is not a legal key identifier
CouchbaseLibcouchbaseException An error occurred within the libcouchbase library used by th PHP extension
CouchbaseServerException An error occurred within the Couchbase cluster