Deprecate setting GridFS disableMD5 to false explicitly (#1205)

Author: GromNaN

docs/reference/method/MongoDBDatabase-selectGridFSBucket.txt

@@ -48,7 +48,7 @@ Parameters
        - boolean
        - Whether to disable automatic MD5 generation when storing files.
 
-         Defaults to ``false``.
+         Defaults to ``false``. Only ``true`` will be supported in 2.0.
 
          .. versionadded: 1.4
 

docs/reference/method/MongoDBGridFSBucket-openUploadStream.txt

@@ -55,7 +55,7 @@ Parameters
        - boolean
        - Whether to disable automatic MD5 generation when storing files.
 
-         Defaults to ``false``.
+         Defaults to ``false``. Only ``true`` will be supported in 2.0.
 
          .. versionadded: 1.4
 

docs/reference/method/MongoDBGridFSBucket-uploadFromStream.txt

@@ -59,7 +59,7 @@ Parameters
        - boolean
        - Whether to disable automatic MD5 generation when storing files.
 
-         Defaults to ``false``.
+         Defaults to ``false``. Only ``true`` will be supported in 2.0.
 
          .. versionadded: 1.4
 

docs/reference/method/MongoDBGridFSBucket__construct.txt

@@ -59,7 +59,7 @@ Parameters
        - boolean
        - Whether to disable automatic MD5 generation when storing files.
 
-         Defaults to ``false``.
+         Defaults to ``false``. Only ``true`` will be supported in 2.0.
 
          .. versionadded: 1.4
 

src/GridFS/Bucket.php

@@ -61,8 +61,11 @@
 use function stream_copy_to_stream;
 use function stream_get_meta_data;
 use function stream_get_wrappers;
+use function trigger_error;
 use function urlencode;
 
+use const E_USER_DEPRECATED;
+
 /**
  * Bucket provides a public API for interacting with the GridFS files and chunks
  * collections.
@@ -132,6 +135,10 @@ class Bucket
      */
     public function __construct(Manager $manager, string $databaseName, array $options = [])
     {
+        if (isset($options['disableMD5']) && $options['disableMD5'] === false) {
+            @trigger_error('Setting GridFS "disableMD5" option to "false" is deprecated since mongodb/mongodb 1.18 and will not be supported in version 2.0.', E_USER_DEPRECATED);
+        }
+
         $options += [
             'bucketName' => self::DEFAULT_BUCKET_NAME,
             'chunkSizeBytes' => self::DEFAULT_CHUNK_SIZE_BYTES,