SDK Release Notes

Updated core to 1.0.6 (#206). Release notes: C++ SDK 1.0.6.

PCBC-992: New APIs added to allow getting KV documents from a preferred server group. This feature allows the implementation of network optimization when traffic cost between server groups is higher than in the local group. In this case the application might select preferred server group in the connection options, and later opt-in for local operations during replica reads (#201).

PCBC-1018: In some cases, when the extension was configured aggressively close persistent connections (e.g. with couchbase.max_persistent=0 and couchbase.persistent_timeout=0), the connections might be considered expired and scheduled for destruction even if the application has references to them. This patch changes this behavior to skip such actions and destroy them later, when the reference counter reaches zero (#200).

PCBC-1016: Fixed trustCertificate option that was ignored previously (#195).

Updated core to 1.0.5 (#203). Release notes: C++ SDK 1.0.5.

Fixed PHP 8.4 deprecation warnings (#198).

Fixed Undefined constant error (#196).

Core updated to 1.0.4. Release notes: C++ SDK 1.0.4.

PCBC-1004: Insert ABI version tag into PHP extension namespace (#187). At this moment this feature is optional and does not break existing ABI. The extension namespace will become versioned by default from 4.3.0.

$ wget \
    https://packages.couchbase.com/clients/php/couchbase-4.2.5-php8.3-nts-linux-x86_64.tgz \
    https://packages.couchbase.com/clients/php/couchbase-4.2.5-php8.3-nts-linux-x86_64-abi.tgz

$ for t in *.tgz; do tar zxf $t; done

$ php \
        -d extension=$(realpath couchbase-4.2.5-php8.3-nts-linux-x86_64-abi/couchbase_4_2_5.so) \
        -d extension=$(realpath couchbase-4.2.5-php8.3-nts-linux-x86_64/couchbase.so) \
        -i \
    | grep couchbase
couchbase
couchbase => enabled
couchbase_extension_abi => unspecified
couchbase_extension_version => 4.2.5
couchbase_extension_revision => c9704a8aa5ca50475c5fe8ee64166fa164cbd43e
couchbase_client_revision => 5355b0fdc221d87f0d6adbbf7e7f8826d819ea22
couchbase_4_2_5
couchbase => enabled
couchbase_extension_abi => 4_2_5
couchbase_extension_version => 4.2.5
couchbase_extension_revision => c9704a8aa5ca50475c5fe8ee64166fa164cbd43e
couchbase_client_revision => 5355b0fdc221d87f0d6adbbf7e7f8826d819ea22
...

$ php \
        -d extension=$(realpath couchbase-4.2.5-php8.3-nts-linux-x86_64-abi/couchbase_4_2_5.so) \
        --re couchbase_4_2_5 \
    | grep createConnection
Function [ <internal:couchbase_4_2_5> function Couchbase\Extension_4_2_5\createConnection ] {

$ php \
        -d extension=$(realpath couchbase-4.2.5-php8.3-nts-linux-x86_64/couchbase.so) \
        --re couchbase \
    | grep createConnection
Function [ <internal:couchbase> function Couchbase\Extension\createConnection ] {

PCBC-975: Fixed expiry with upsertMulti. The option is now applied to all documents.

PCBC-1017: Updated user agent generation. It now uses the common SDK format.

PCBC-832: Management API - Analytics Management (#177).

Core updated to 1.0.3. Release notes: C++ SDK 1.0.3.

PCBC-1009: IS_RESOURCE has been removed from function signatures of the extension, so that they compile with 8.4.

PCBC-1010: implicit marking of certain parameters as nullable has now been deprecated. Use explicit nullable types where applicable to avoid deprecation warning in PHP 8.4.

Fixed SearchQuery API docs link in API reference.

Core updated to 1.0.1. Release notes: C++ SDK 1.0.1.

PCBC-997: Excluded C++ files, tests, and development scripts, so that Packagist will not install them to the application ./vendor directory #172).

PCBC-991: Added consistency utility for testing (#168).

PCBC-989: Rollback to cmake 3.19 (#167).

PCBC-988: Fixed type annotation for JsonSerializable implementations (#166).

PCBC-994: Support for base64 encoded vector types added (#169, #170).

Core updated to 1.0.0. Release notes: C++ SDK 1.0.0

PCBC-859: Updated build scripts and instructions for Windows (#158, #164).

PCBC-984, PCBC-987: Improved compatiblity with pcntl_fork() (#157, #162).

PCBC-987: Fixed consistency vector encoding for FTS (#163).

PCBC-985: Use system DNS config by default, and disable DNS-SRV if system does not provide DNS server (#159).

CXXCBC-447: This version of the SDK will not be able to connect to a cluster utilizing alternate addressing. The recommendation is to wait to upgrade to a version of the PHP SDK that contains C++ 1.0.0-dp.15 (or later).

PCBC-979: Added static helpers to SearchQuery types (#149).

PCBC-970: SDK support added for Scoped Search Indexes (#147).

PCBC-968: Support addd for maxTTL value of -1 for collection 'no expiry' (#144).

PCBC-967: Support added for vector search (#143).

PCBC-965: Adedd DocumentNotLocked error to corresponds with the C++ error code couchbase::errc::key_value::document_not_locked (#142).

PCBC-960: Merge protostellar branch to master, in preparation for couchbase2 protocol (#138, #153).

PCBC-964: The SDK no longer fires the close operation asynchronously, instead it will now wait until the core instance is completely destroyed Wait until the core connection is closed (#141).

PCBC-972: Fixed C++ detection on MacOS X, so that the SDK now installs correctly on Sonoma (#145).

Added missing use statement in class DecrementOptions (#146).

Updated core and renamed query_index_create fields to keys (#148).

PCBC-956: Updated wrapper-side bucket settings — to now use new BucketSettings optional fields in underlying C++ core (#132).

PCBC-950: Added support to bucket settings for no dedup feature (#131).

PCBC-955: Preventing trailing garbage in encoded CAS value (#134).

Updates to support PHP 8.3: zend_bool was removed from 8.3.

CXXCBC-376: Changed what 'create' and 'update' bucket operations send to the server. Unrequired BucketSettings fields are now set to optional, and are not sent unless the settings are explicitly specified. (#451).

CXXCBC-374: The SDK should now return a 'bucket_exists' error when the bucket already exists during a 'create' operation. (#449).

CXXCBC-359: Reduced the default timeout for idle HTTP connections to 1 second. The previous default (4.5 seconds) was too close to the 5-second server-side timeout, and could lead to spurious request failures. (#448).

CXXCBC-367, CXXCBC-370: Added history retention settings to buckets/collection management (#446).

CXXCBC-119: Return booleans for subdocument 'exists' operation, instead of error code (#444, #452).

Detect collection_not_found error in update_collection response (#450).

PCBC-939: Added support for query with Read from Replica (#118).

PCBC-831: Implemented search index management (#115).

PCBC-945: Expiry options for increment/decrement are now exposed, as they were before 4.0.0 (#120).

PCBC-937: Fixed removeMulti, which now correctly removes documents (#123).

PCBC-938: Override exception constructor in PHP Extension, which allows to initialize context in derived classes (#117).

PCBC-940: Added support for subdoc Read from Replica (#121).

PCBC-884: Added support for Native KV range scans (#122, #127).

CXXCBC-333: Fixed parsing 'resolv.conf' on Linux (#416).

CXXCBC-335: now logging connection options for visibility (#417).

CXXCBC-343: Continue bootsrap if DNS-SRV resolution fails (#422).

CXXCBC-242: SDK Support for Native KV Range Scans (#419, #423, #424, #426, #428, #431, #432, #433, #434).

CXXCBC-339: Disable older TLS protocols (#418).

Added couchbase:: namespace to durability_level, which fixes using Sync Durability. (#102)

PCBC-934: Fixed setting timeout for transactions.

CXXCBC-327: Bundled Mozilla certificates with the library (#405, #408). Source: https://curl.se/docs/caextract.html. Use the disable_mozilla_ca_certificates connection string option to disable the bundled certificates.

CXXCBC-324: Port and network name now checked on session restart, improving performance during rebalance (#401).

CXXCBC-323: bootstrap_timeout and resolve_timeout can now be used in the connection string (#400).

Introduced dump_configuration option for debugging. (#398) It logs cluster configuration at trace level.

PCBC-915: Fixed incorrect handling of timestamps as expiry in mutation options (#88).

PCBC-828: Implemented collection management (#89).

PCBC-918: Extra attributes in ExistsResult (deleted, expiry, flags, and sequenceNumber) are now optional (#95).

CXXCBC-31: Allow the use of schemaless connection strings (e.g. "cb1.example.com,cb2.example.com") (#394).

CXXCBC-318: Always try TCP if UDP fails in DNS-SRV resolver (#390).

CXXCBC-320: Negative expiry in atr was leaving docs in a stuck state — this has been fixed, with expiry atr now becoming an int32_t (#393).

CXXCBC-310: Improved shutdown of the LostTxnCleanup thread (#389).

PCBC-888: Added new method Collection#queryIndexes that allows to manage query indexes defined for the collection (#68).

Added optional context to CouchbaseException constructor (#85).

CXXCBC-144: Search query on collections no longer requires you to pass in the scope name — it is inferred from the index (#379).

CXXCBC-145: Search query request, raw option added (#380).

CXXCBC-194: The SDK now supports the ExtThreadSafe transaction extension (#374, #376).

CXXCBC-316: When a document is removed in a transaction, and then a call made to get_optional, we expect to just get an empty optional. However, the handling was raising a transaction_operation_failed This has been fixed, and an empty optional will now be returned (#385).

CXXCBC-310: Fixed race condition in transaction_context state machine (#386, #378).

PCBC-869: Implemented changePassword for management API (#55, #56)

PCBC-891: Append extension version info to HELLO indentifier (#58)

PCBC-901: Attach error details to management exceptions (#71)

Increase required PHP version up to 8.0 (#76)

PCBC-890: Scope must implement ScopeInterface (#57)

PCBC-899: Ensure the connection will be closed on error (#70)

PCBC-900: Don’t set "function" property on exceptions. (#74)

PCBC-905: Don’t dereference empty optional if option is not set (#75)

PCBC-907: Assign meta to view query result (#79)

Fix missing header for GCC 13 (#63)

CXXCBC-275: Update implementation query context fields passed to the server. In future versions of the server versions it will become mandatory to specify context of the statement (bucket, scope and collection). This change ensures that both future and current server releases supported transparently.

CXXCBC-296: Force PLAIN SASL auth if TLS enabled. Using SCRAM SASL mechanisms over TLS protocol is unnecesary complication, that slows down initial connection bootstrap and potentially limits server ability to improve security and evolve credentials management.

CXXCBC-295: The get with projections opration should not fail if one of the the paths is missing in the document, because the semantics is "get the partial document" and not "get individual fields" like in lookup_in operation.

CXXCBC-294: In the Public API, if get operation requested to return expiry time, zero expiry should not be interpreted as absolute expiry timestamp (zero seconds from UNIX epoch), but rather as absense of the expiry.

CXXCBC-291: Allow to disable mutation tokens for Key/Value mutations (use enable_mutation_tokens in connection string).

Resource management and performance improvements:

Build system fixes:

Enhancements:

PCBC-824: Implemented replica reads.

PCBC-630: Implemented legacy durability for mutations (replicateTo/persistTo options)

PCBC-880: Support for configuration profiles

PCBC-889: Fixed behaviour of 'skip' SearchOption.

Bug fixes: logger and build improvements

PCBC-806: Migrated core to Couchbase++.

PCBC-797: Updated the Query Index management API to use scopes and collections.

PCBC-836: Added support for the Transactions API.