[Lock] Add DynamoDbStore

Author: natepage

components/lock.rst

@@ -399,6 +399,7 @@ Store                                                       Scope   Blocking  Ex
 :ref:`RedisStore <lock-store-redis>`                        remote  no        yes      yes     yes
 :ref:`SemaphoreStore <lock-store-semaphore>`                local   yes       no       no      no
 :ref:`ZookeeperStore <lock-store-zookeeper>`                remote  no        no       no      no
+:ref:`DynamoDbStore <lock-store-dynamodb>`                  remote  no        yes      no      yes
 ==========================================================  ======  ========  ======== ======= =============
 
 .. tip::
@@ -703,6 +704,32 @@ PHP process is terminated::
     Zookeeper does not require a TTL as the nodes used for locking are ephemeral
     and die when the PHP process is terminated.
 
+.. _lock-store-dynamodb:
+
+DynamoDbStore
+~~~~~~~~~~~~~
+
+The DynamoDbStore saves locks on a Amazon DynamoDB table. Install it by running:
+
+.. code-block:: terminal
+
+    $ composer require symfony/amazon-dynamodb-lock
+
+It requires a `DynamoDbClient`_ instance or a `Data Source Name (DSN)`_.
+This store does not support blocking, and expects a TTL to avoid stalled locks::
+
+    use Symfony\Component\Lock\Bridge\DynamoDb\Store\DynamoDbStore;
+
+    // a DynamoDbClient instance or DSN
+    $dynamoDbClientOrDSN = 'dynamodb://default/lock';
+    $store = new DynamoDbStore($dynamoDbClientOrDSN);
+
+The table where values are stored is created automatically on the first call to
+the :method:`Symfony\\Component\\Lock\\Bridge\\DynamoDb\\DynamoDbStore::save` method.
+You can also create this table explicitly by calling the
+:method:`Symfony\\Component\\Lock\\Bridge\\DynamoDb\\DynamoDbStore::createTable` method in
+your code.
+
 Reliability
 -----------
 
@@ -1054,3 +1081,4 @@ are still running.
 .. _`readers-writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
 .. _`priority policy`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock#Priority_policies
 .. _`PCNTL`: https://www.php.net/manual/book.pcntl.php
+.. _`DynamoDbClient`: https://async-aws.com/clients/dynamodb.html

lock.rst

@@ -61,6 +61,7 @@ this behavior by using the ``lock`` key like:
             lock: 'sqlsrv:server=127.0.0.1;Database=app'
             lock: 'oci:host=127.0.0.1;dbname=app'
             lock: 'mongodb://127.0.0.1/app?collection=lock'
+            lock: 'dynamodb://127.0.0.1/lock'
             lock: '%env(LOCK_DSN)%'
             # using an existing service
             lock: 'snc_redis.default'
@@ -119,6 +120,8 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>mongodb://127.0.0.1/app?collection=lock</framework:resource>
 
+                    <framework:resource>dynamodb://127.0.0.1/lock</framework:resource>
+
                     <framework:resource>%env(LOCK_DSN)%</framework:resource>
 
                     <!-- using an existing service -->
@@ -157,6 +160,7 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['sqlsrv:server=127.0.0.1;Database=app'])
                 ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
+                ->resource('default', ['dynamodb://127.0.0.1/lock'])
                 ->resource('default', [env('LOCK_DSN')])
                 // using an existing service
                 ->resource('default', ['snc_redis.default'])