Deprecate setting GridFS disableMD5 to false explicitly

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,6 +61,7 @@
 use function stream_copy_to_stream;
 use function stream_get_meta_data;
 use function stream_get_wrappers;
+use function trigger_deprecation;
 use function urlencode;
 
 /**
@@ -132,6 +133,10 @@ class Bucket
      */
     public function __construct(Manager $manager, string $databaseName, array $options = [])
     {
+        if (isset($options['disableMD5']) && $options['disableMD5'] === false) {
+            trigger_deprecation('mongodb/mongodb', '1.18', 'Setting GridFS "disableMD5" option to "false" is deprecated and will not be supported in version 2.0.');
+        }
+
         $options += [
             'bucketName' => self::DEFAULT_BUCKET_NAME,
             'chunkSizeBytes' => self::DEFAULT_CHUNK_SIZE_BYTES,