#27345 added new constructor support and options

Author: Joe Bennett

components/lock.rst

@@ -287,9 +287,11 @@ MongoDbStore
 
     The ``MongoDbStore`` was introduced in Symfony 4.4.
 
-The MongoDbStore saves locks on a MongoDB server ``^2.2``, it requires a
-``\MongoDB\Client`` connection from `mongodb/mongodb`_. This store does not
-support blocking and expects a TTL to avoid stalled locks::
+The MongoDbStore saves locks on a MongoDB server ``>=2.2``, it requires a
+``\MongoDB\Collection`` or ``\MongoDB\Client`` from `mongodb/mongodb`_ or a
+`MongoDB Connection String`_.
+This store does not support blocking and expects a TTL to
+avoid stalled locks::
 
     use MongoDB\Client;
     use Symfony\Component\Lock\Store\MongoDbStore;
@@ -298,19 +300,22 @@ support blocking and expects a TTL to avoid stalled locks::
 
     $options = [
         'database' => 'my-app',
+        'collection' => 'lock',
     ];
 
     $store = new MongoDbStore($client, $options);
 
-The ``MongoDbStore`` takes the following options:
+The ``MongoDbStore`` takes the following options (depending on the first parameter type):
 
-============  =========  ========================================================================
-Option        Default    Description
-============  =========  ========================================================================
-database                 The name of the database [Mandatory]
-collection    ``lock``   The name of the collection
-gcProbablity  ``0.001``  Should a TTL Index be created expressed as a probability from 0.0 to 1.0
-============  =========  ========================================================================
+=============  =================================  =========  ========================================================================
+Option         First Parameter Type               Default    Description
+=============  =================================  =========  ========================================================================
+gcProbablity   any                                ``0.001``  Should a TTL Index be created expressed as a probability from 0.0 to 1.0
+database       ``\MongoDB\Client`` or ``string``             The name of the database [Mandatory]
+collection     ``\MongoDB\Client`` or ``string``  ``lock``   The name of the collection
+uriOptions     ``string``                         ``[]``     Array of uri options for `MongoDBClient::__construct`_
+driverOptions  ``string``                         ``[]``     Array of driver options for `MongoDBClient::__construct`_
+=============  =================================  =========  ========================================================================
 
 .. _lock-store-pdo:
 
@@ -755,7 +760,9 @@ are still running.
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/lib/Doctrine/DBAL/Connection.php
 .. _`Expire Data from Collections by Setting TTL`: https://docs.mongodb.com/manual/tutorial/expire-data/
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
+.. _`MongoDB Connection String`: https://docs.mongodb.com/manual/reference/connection-string/
 .. _`mongodb/mongodb`: https://packagist.org/packages/mongodb/mongodb
+.. _`MongoDBClient::__construct`: https://docs.mongodb.com/php-library/current/reference/method/MongoDBClient__construct/
 .. _`PDO`: https://php.net/pdo
 .. _`PHP semaphore functions`: https://php.net/manual/en/book.sem.php
 .. _`Replica Set Read and Write Semantics`: https://docs.mongodb.com/manual/applications/replication/