diff --git a/source/reference/method/MongoDBDatabase-selectGridFSBucket.txt b/source/reference/method/MongoDBDatabase-selectGridFSBucket.txt index 5bd11d25..0b87c3ae 100644 --- a/source/reference/method/MongoDBDatabase-selectGridFSBucket.txt +++ b/source/reference/method/MongoDBDatabase-selectGridFSBucket.txt @@ -51,14 +51,6 @@ Parameters .. versionadded:: 1.17 - * - disableMD5 - - boolean - - Whether to disable automatic MD5 generation when storing files. - - Defaults to ``false``. Only ``true`` will be supported in 2.0. - - .. versionadded:: 1.4 - * - readConcern - :php:`MongoDB\Driver\ReadConcern ` - The default read concern to use for bucket operations. Defaults to the diff --git a/source/reference/method/MongoDBGridFSBucket-openUploadStream.txt b/source/reference/method/MongoDBGridFSBucket-openUploadStream.txt index 92711054..9a5f7738 100644 --- a/source/reference/method/MongoDBGridFSBucket-openUploadStream.txt +++ b/source/reference/method/MongoDBGridFSBucket-openUploadStream.txt @@ -51,14 +51,6 @@ Parameters - The chunk size in bytes. Defaults to the bucket's ``chunkSizeBytes`` option. - * - disableMD5 - - boolean - - Whether to disable automatic MD5 generation when storing files. - - Defaults to ``false``. Only ``true`` will be supported in 2.0. - - .. versionadded:: 1.4 - * - metadata - array|object - User data for the ``metadata`` field of the file document. If not diff --git a/source/reference/method/MongoDBGridFSBucket-uploadFromStream.txt b/source/reference/method/MongoDBGridFSBucket-uploadFromStream.txt index 95a4f685..c64b9c7c 100644 --- a/source/reference/method/MongoDBGridFSBucket-uploadFromStream.txt +++ b/source/reference/method/MongoDBGridFSBucket-uploadFromStream.txt @@ -55,14 +55,6 @@ Parameters - The chunk size in bytes. Defaults to the bucket's ``chunkSizeBytes`` option. - * - disableMD5 - - boolean - - Whether to disable automatic MD5 generation when storing files. - - Defaults to ``false``. Only ``true`` will be supported in 2.0. - - .. versionadded:: 1.4 - * - metadata - array|object - User data for the ``metadata`` field of the file document. If not diff --git a/source/reference/method/MongoDBGridFSBucket__construct.txt b/source/reference/method/MongoDBGridFSBucket__construct.txt index 8bc64f09..cef11446 100644 --- a/source/reference/method/MongoDBGridFSBucket__construct.txt +++ b/source/reference/method/MongoDBGridFSBucket__construct.txt @@ -62,14 +62,6 @@ Parameters .. versionadded:: 1.17 - * - disableMD5 - - boolean - - Whether to disable automatic MD5 generation when storing files. - - Defaults to ``false``. Only ``true`` will be supported in 2.0. - - .. versionadded:: 1.4 - * - readConcern - :php:`MongoDB\Driver\ReadConcern ` - The default read concern to use for bucket operations. Defaults to the diff --git a/source/whats-new.txt b/source/whats-new.txt index e31ddc67..aa354173 100644 --- a/source/whats-new.txt +++ b/source/whats-new.txt @@ -20,6 +20,8 @@ What's New Learn about new features, improvements, and fixes introduced in the following versions of the {+php-library+}: +* :ref:`Version 2.0 ` + * :ref:`Version 1.20 ` * :ref:`Version 1.19 ` @@ -32,6 +34,26 @@ following versions of the {+php-library+}: * :ref:`Version 1.15 ` +.. _php-lib-version-2.0: + +What's New in 2.0 +----------------- + +The {+library-short+} v2.0 release includes the following features, +improvements, and fixes: + +- Removal of deprecated fields in GridFS types. + + - The library does not calculate the ``md5`` field when a file is + uploaded to GridFS. If your application requires a file digest, you + must implement this process outside GridFS and store the values in + metadata. + + - The fields ``contentType`` and ``aliases`` are no longer stored in + the ``files`` GridFS collection. If your application requires this + information, you must store it in metadata. To learn mor about + GridFS, see the :ref:`php-gridfs` guide. + .. _php-lib-version-1.20: What's New in 1.20 @@ -42,6 +64,9 @@ What's New in 1.20 Support for {+mdb-server+} v3.6 is removed in this release of the library. +The {+library-short+} v1.20 release includes the following features, +improvements, and fixes: + - Adds support for {+mdb-server+} v8.0. - Adds support for Queryable Encryption (QE) range queries. To use this @@ -75,6 +100,9 @@ and was added to keep version parity with the {+extension-short+}. What's New in 1.18 ------------------ +The {+library-short+} v1.18 release includes the following features, +improvements, and fixes: + - Adds a new GridFS API to make it more convenient to work with files using PHP's existing filesystem functions. The :phpmethod:`MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias()` method may be used to register a global alias for a GridFS bucket. After @@ -96,6 +124,9 @@ To learn more about this release, see the `v1.18 Release Notes What's New in 1.17 ------------------ +The {+library-short+} v1.17 release includes the following features, +improvements, and fixes: + - Introduces a new "codec" API for converting BSON to and from PHP objects. More information on this feature may be found in the :ref:`Codecs tutorial `. @@ -125,6 +156,9 @@ To learn more about this release, see the `v1.17 Release Notes What's New in 1.16 ------------------ +The {+library-short+} v1.16 release includes the following features, +improvements, and fixes: + - Introduces support for :v7.0:`MongoDB 7.0 `. - Introduces :phpmethod:`MongoDB\Database::createEncryptedCollection()`. @@ -141,6 +175,9 @@ To learn more about this release, see the `v1.16 Release Notes What's New in 1.15 ------------------ +The {+library-short+} v1.15 release includes the following features, +improvements, and fixes: + - Adds new ``examples/`` and ``tools/`` directories to the library repository, which contain code snippets and scripts that may prove useful when writing or debugging applications. These directories are intended to diff --git a/source/write/gridfs.txt b/source/write/gridfs.txt index 3415dc8f..69ddd798 100644 --- a/source/write/gridfs.txt +++ b/source/write/gridfs.txt @@ -237,10 +237,10 @@ the returned cursor and display the contents of the files uploaded in the :visible: false { "_id" : { "$oid" : "..." }, "chunkSize" : 261120, "filename" : "my_file", - "length" : 13, "uploadDate" : { ... }, "metadata" : { "contentType" : "text/plain" }, - "md5" : "6b24249b03ea3dd176c5a04f037a658c" } + "length" : 13, "uploadDate" : { ... }, "metadata" : { + "contentType" : "text/plain" } } { "_id" : { "$oid" : "..." }, "chunkSize" : 261120, "filename" : "new_file", - "length" : 13, "uploadDate" : { ... }, "md5" : "6b24249b03ea3dd176c5a04f037a658c" } + "length" : 13, "uploadDate" : { ... } } The ``find()`` method accepts various query specifications. You can use its ``$options`` parameter to specify the sort order, maximum number of documents to return,