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.5. Observing Document Durability

API Call$object->observe($key, $casunique, $observedetails)
Asynchronousno
Description Get the durability of a document
Returnsboolean; supported values:
 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_SUCCESSOperation succeeded 
Arguments 
string $key Document ID used to identify the value
$casunique Unique value used to verify a key/value combination
array $observedetails List of returned observe details
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->observeMulti($keycollection, $observedetails)
Asynchronousno
Description Get the durability of a document
Returnsscalar; supported values:
 COUCHBASE_ETMPFAILTemporary failure; try the operation again 
 COUCHBASE_NOT_MY_VBUCKETThe command was sent to the wrong server; may be triggered during a rebalance or failover operation. Retry the operation 
 arrayArray of result state for each requested document 
Arguments 
array $keycollection One or more keys used to reference a value
array $observedetails List of returned observe details
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

The durability functions enable you to specify the durability parameters of one or more keys. The values should be specified as an associative array of the following values:

NameDescription
persist_toThe number of nodes the document should be persisted to
replicate_toThe number of nodes the document should be replicated to
timeoutThe max time in milliseconds to wait for durability
intervalThe interval between each poll request
API Call$object->keyDurability($key, $casunique, $durability)
Asynchronousno
Description Wait until the durability of a document has been reached
Returnsboolean; supported values:
 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_SUCCESSOperation succeeded 
Arguments 
string $key Document ID used to identify the value
$casunique Unique value used to verify a key/value combination
array $durability List of required durability values
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->keyDurabilityMulti($keycollection, $durability)
Asynchronousno
Description Wait until the durability of a document has been reached
Returnsscalar; supported values:
 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 
 arrayArray of result state for each requested document 
Arguments 
array $keycollection One or more keys used to reference a value
array $durability List of required durability values
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