DOCSP-48606: builderEncoder Database (#232)

* DOCSP-48606: builderEncoder Database

* wip

* AS PR fixes 1

* JM small fix

(cherry picked from commit 9a0e1cb)

Author: rustagir

source/reference/method/MongoDBCollection-withOptions.txt

@@ -35,9 +35,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 </data-formats/codecs>` to use for collection
+       - ``MongoDB\Codec\DocumentCodec``
+       - The default :ref:`codec <php-codecs>` to use for collection
          operations. Defaults to the original collection's codec.
 
          .. versionadded:: 1.17

source/reference/method/MongoDBDatabase-withOptions.txt

@@ -35,6 +35,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
+
      * - readConcern
        - :php:`MongoDB\Driver\ReadConcern <class.mongodb-driver-readconcern>`
        - The default read concern to use for database operations. Defaults to

source/whats-new.txt

@@ -64,6 +64,13 @@ 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 following methods:
+
+  - :phpmethod:`Database constructor <MongoDB\Database::__construct()>`
+  - :phpmethod:`MongoDB\Database::withOptions()`
+  - :phpmethod:`Collection constructor <MongoDB\Collection::__construct()>`  
+  - :phpmethod:`MongoDB\Collection::withOptions()`
+
 For more information about the changes in this version, see the
 :github:`v1.21 release notes
 </mongodb/mongo-php-library/releases/tag/1.21.0>` on GitHub.