PHPLIB-851: Queryable encryption support for create/drop collection helpers

Author: jmikola

source/includes/apiargs-MongoDBCollection-method-drop-option.yaml

@@ -1,15 +1,21 @@
 source:
-  file: apiargs-MongoDBCollection-common-option.yaml
-  ref: typeMap
+  file: apiargs-dropCollection-option.yaml
+  ref: encryptedFields
 post: |
-  This will be used for the returned command result document.
+  .. versionadded:: 1.13
 ---
 source:
   file: apiargs-common-option.yaml
   ref: session
 post: |
   .. versionadded:: 1.3
 ---
+source:
+  file: apiargs-MongoDBCollection-common-option.yaml
+  ref: typeMap
+post: |
+  This will be used for the returned command result document.
+---
 source:
   file: apiargs-MongoDBCollection-common-option.yaml
   ref: writeConcern

source/includes/apiargs-MongoDBDatabase-method-createCollection-option.yaml

@@ -68,6 +68,24 @@ pre: |
   </reference/bson-type-comparison-order/#collation>` for the collection.
 ---
 arg_name: option
+name: encryptedFields
+type: document
+description: |
+  A document describing encrypted fields for queryable encryption. If omitted,
+  the ``encryptedFieldsMap`` option within the ``autoEncryption`` driver option
+  will be consulted. See the
+  `Client Side Encryption specification <https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/client-side-encryption.rst>`_
+  for more information.
+
+  This option is available in MongoDB 6.0+ and will result in an exception at
+  execution time if specified for an older server version.
+
+  .. versionadded:: 1.13
+interface: phpmethod
+operation: ~
+optional: true
+---
+arg_name: option
 name: expireAfterSeconds
 type: integer
 description: |

source/includes/apiargs-MongoDBDatabase-method-dropCollection-option.yaml

@@ -1,3 +1,9 @@
+source:
+  file: apiargs-dropCollection-option.yaml
+  ref: encryptedFields
+post: |
+  .. versionadded:: 1.13
+---
 source:
   file: apiargs-common-option.yaml
   ref: session

source/includes/apiargs-dropCollection-option.yaml

@@ -0,0 +1,15 @@
+arg_name: option
+name: encryptedFields
+type: array|object
+description: |
+  A document describing encrypted fields for queryable encryption. If omitted,
+  the ``encryptedFieldsMap`` option within the ``autoEncryption`` driver option
+  will be consulted. If ``encryptedFieldsMap`` was defined but does not specify
+  this collection, the library will make a final attempt to consult the
+  server-side value for ``encryptedFields``. See the
+  `Client Side Encryption specification <https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/client-side-encryption.rst>`_
+  for more information.
+interface: phpmethod
+operation: ~
+optional: true
+...