[FrameworkBundle] Using existing services as lock/semaphore resources

Author: HypeMC

lock.rst

@@ -62,6 +62,8 @@ this behavior by using the ``lock`` key like:
             lock: 'oci:host=127.0.0.1;dbname=app'
             lock: 'mongodb://127.0.0.1/app?collection=lock'
             lock: '%env(LOCK_DSN)%'
+            # using an existing service
+            lock: 'snc_redis.default'
 
             # named locks
             lock:
@@ -119,6 +121,9 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>%env(LOCK_DSN)%</framework:resource>
 
+                    <!-- using an existing service -->
+                    <framework:resource>snc_redis.default</framework:resource>
+
                     <!-- named locks -->
                     <framework:resource name="invoice">semaphore</framework:resource>
                     <framework:resource name="invoice">redis://r2.docker</framework:resource>
@@ -152,6 +157,8 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
                 ->resource('default', [env('LOCK_DSN')])
+                // using an existing service
+                ->resource('default', ['snc_redis.default'])
 
                 // named locks
                 ->resource('invoice', ['semaphore', 'redis://r2.docker'])

reference/configuration/framework.rst

@@ -2048,7 +2048,7 @@ resources
 **type**: ``array``
 
 A map of lock stores to be created by the framework extension, with
-the name as key and DSN as value:
+the name as key and DSN or service id as value:
 
 .. configuration-block::
 
@@ -2057,6 +2057,8 @@ the name as key and DSN as value:
         # config/packages/lock.yaml
         framework:
             lock: '%env(LOCK_DSN)%'
+            # or
+            lock: 'service.id'
 
     .. code-block:: xml
 
@@ -2072,6 +2074,8 @@ the name as key and DSN as value:
             <framework:config>
                 <framework:lock>
                     <framework:resource name="default">%env(LOCK_DSN)%</framework:resource>
+                    <!-- or -->
+                    <framework:resource name="default">service.id</framework:resource>
                 </framework:lock>
             </framework:config>
         </container>
@@ -2083,7 +2087,10 @@ the name as key and DSN as value:
 
         return static function (FrameworkConfig $framework): void {
             $framework->lock()
-                ->resource('default', [env('LOCK_DSN')]);
+                ->resource('default', [env('LOCK_DSN')])
+                // or
+                ->resource('default', ['service.id'])
+            ;
         };
 
 .. seealso::
@@ -2725,7 +2732,7 @@ resources
 **type**: ``array``
 
 A map of semaphore stores to be created by the framework extension, with
-the name as key and DSN as value:
+the name as key and DSN or service id as value:
 
 .. configuration-block::
 
@@ -2734,6 +2741,8 @@ the name as key and DSN as value:
         # config/packages/semaphore.yaml
         framework:
             semaphore: '%env(SEMAPHORE_DSN)%'
+            # or
+            semaphore: 'service.id'
 
     .. code-block:: xml
 
@@ -2749,6 +2758,8 @@ the name as key and DSN as value:
             <framework:config>
                 <framework:semaphore>
                     <framework:resource name="default">%env(SEMAPHORE_DSN)%</framework:resource>
+                    <!-- or -->
+                    <framework:resource name="default">service.id</framework:resource>
                 </framework:semaphore>
             </framework:config>
         </container>
@@ -2760,7 +2771,10 @@ the name as key and DSN as value:
 
         return static function (FrameworkConfig $framework): void {
             $framework->semaphore()
-                ->resource('default', ['%env(SEMAPHORE_DSN)%']);
+                ->resource('default', [env('SEMAPHORE_DSN')])
+                // or
+                ->resource('default', ['service.id'])
+            ;
         };
 
 .. _reference-semaphore-resources-name: