From f9e3fa2ee7bb6c4e6c5478c4e18ce3bb313cac6a Mon Sep 17 00:00:00 2001 From: rustagir Date: Fri, 21 Mar 2025 10:21:59 -0400 Subject: [PATCH 1/4] DOCSP-48606: builderEncoder Database --- .../method/MongoDBCollection-withOptions.txt | 12 ++++++++++-- .../reference/method/MongoDBDatabase-withOptions.txt | 8 ++++++++ source/whats-new.txt | 4 ++++ 3 files changed, 22 insertions(+), 2 deletions(-) diff --git a/source/reference/method/MongoDBCollection-withOptions.txt b/source/reference/method/MongoDBCollection-withOptions.txt index 1893b9db..f7077e03 100644 --- a/source/reference/method/MongoDBCollection-withOptions.txt +++ b/source/reference/method/MongoDBCollection-withOptions.txt @@ -34,9 +34,17 @@ Parameters - Type - Description + * - builderEncoder + - ``MongoDB\Codec\Encoder`` + - The encoder used to serialize native PHP types to BSON data in + query and aggregation options. If omitted, the ``Collection`` + instance uses the default encoder. + + .. versionadded:: 1.21 + * - codec - - MongoDB\\Codec\\DocumentCodec - - The default :doc:`codec ` to use for collection + - ``MongoDB\Codec\DocumentCodec`` + - The default :ref:`codec ` to use for collection operations. Defaults to the original collection's codec. .. versionadded:: 1.17 diff --git a/source/reference/method/MongoDBDatabase-withOptions.txt b/source/reference/method/MongoDBDatabase-withOptions.txt index 681c044d..ecbc3499 100644 --- a/source/reference/method/MongoDBDatabase-withOptions.txt +++ b/source/reference/method/MongoDBDatabase-withOptions.txt @@ -34,6 +34,14 @@ Parameters - Type - Description + * - builderEncoder + - ``MongoDB\Codec\Encoder`` + - The encoder used to serialize native PHP types to BSON data in + query and aggregation options. If omitted, the ``Database`` + instance uses the default encoder. + + .. versionadded:: 1.21.1 + * - readConcern - :php:`MongoDB\Driver\ReadConcern ` - The default read concern to use for database operations. Defaults to diff --git a/source/whats-new.txt b/source/whats-new.txt index 3965921a..33547c58 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -160,6 +160,10 @@ improvements, and fixes: change also allows you to set a sort order as an option when performing update and replace operations in a bulk operation. +- Adds the ``builderEncoder`` option to the + :phpmethod:`MongoDB\Database::withOptions()` and + :phpmethod:`MongoDB\Collection::withOptions()` methods. + For more information about the changes in this version, see the :github:`v1.21 release notes ` on GitHub. From 60fb65cf91141279a2c2870f25c4128abed14e68 Mon Sep 17 00:00:00 2001 From: rustagir Date: Fri, 21 Mar 2025 10:35:29 -0400 Subject: [PATCH 2/4] wip --- source/whats-new.txt | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/source/whats-new.txt b/source/whats-new.txt index 33547c58..f11c5ee0 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -160,9 +160,12 @@ improvements, and fixes: change also allows you to set a sort order as an option when performing update and replace operations in a bulk operation. -- Adds the ``builderEncoder`` option to the - :phpmethod:`MongoDB\Database::withOptions()` and - :phpmethod:`MongoDB\Collection::withOptions()` methods. +- Adds the ``builderEncoder`` option to the following methods: + + - :phpmethod:`Database constructor ` + - :phpmethod:`MongoDB\Database::withOptions()` + - :phpmethod:`Collection constructor ` + - :phpmethod:`MongoDB\Collection::withOptions()` methods For more information about the changes in this version, see the :github:`v1.21 release notes From 2a90657505e49ba81f9ae2830f0b7152f4d67139 Mon Sep 17 00:00:00 2001 From: rustagir Date: Fri, 21 Mar 2025 13:02:36 -0400 Subject: [PATCH 3/4] AS PR fixes 1 --- source/whats-new.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/whats-new.txt b/source/whats-new.txt index f11c5ee0..3183d6a1 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -165,7 +165,7 @@ improvements, and fixes: - :phpmethod:`Database constructor ` - :phpmethod:`MongoDB\Database::withOptions()` - :phpmethod:`Collection constructor ` - - :phpmethod:`MongoDB\Collection::withOptions()` methods + - :phpmethod:`MongoDB\Collection::withOptions()` For more information about the changes in this version, see the :github:`v1.21 release notes From 6f4667a16caf7e39bd2414f6794573220ce0e8e8 Mon Sep 17 00:00:00 2001 From: rustagir Date: Fri, 21 Mar 2025 13:24:20 -0400 Subject: [PATCH 4/4] JM small fix --- source/reference/method/MongoDBDatabase-withOptions.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/reference/method/MongoDBDatabase-withOptions.txt b/source/reference/method/MongoDBDatabase-withOptions.txt index ecbc3499..160551c3 100644 --- a/source/reference/method/MongoDBDatabase-withOptions.txt +++ b/source/reference/method/MongoDBDatabase-withOptions.txt @@ -40,7 +40,7 @@ Parameters query and aggregation options. If omitted, the ``Database`` instance uses the default encoder. - .. versionadded:: 1.21.1 + .. versionadded:: 1.21 * - readConcern - :php:`MongoDB\Driver\ReadConcern `