minor #8243 [Lock] Deprecate Filesystem/LockHandler (jderusse, javiereguiluz)

javiereguiluz · javiereguiluz · commit 7fd11a2c1daa · 2018-01-09T12:09:23.000+01:00
This PR was merged into the 3.4 branch. Discussion ---------- [Lock] Deprecate Filesystem/LockHandler This PR deprecate the Filesystem\LockHandler in favor of Lock\SemaphoreStore and Lock\FlockStore. see: symfony/symfony#23724 Commits ------- cb771c3 Reword af6dc34 Minor reword 800bdd7 Deprecate Filesystem/LockHandler
diff --git a/components/filesystem/lock_handler.rst b/components/filesystem/lock_handler.rst
@@ -1,6 +1,12 @@
 LockHandler
 ===========
 
+.. versionadded:: 3.4
+
+    The ``LockHandler`` class was deprecated in Symfony 3.4 and it will be
+    removed in Symfony 4.0. Use ``SemaphoreStore`` or ``FlockStore`` from the
+    ``Lock`` component  instead.
+
 What is a Lock?
 ---------------
 
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
@@ -5,9 +5,10 @@ Prevent Multiple Executions of a Console Command
     The ``LockableTrait`` was introduced in Symfony 3.2.
 
 A simple but effective way to prevent multiple executions of the same command in
-a single server is to use **file locks**. The Filesystem component provides a
-:doc:`LockHandler </components/filesystem/lock_handler>` class that eases the
-creation and release of these locks.
+a single server is to use `locks`_. The :doc:`Lock component </components/lock>`
+provides multiple classes to create locks based on the filesystem (:ref:`FlockStore <_lock-store-flock>`),
+shared memory (:ref:`SemaphoreStore <_lock-store-semaphore>`) and even databases
+and Redis servers.
 
 In addition, the Console component provides a PHP trait called ``LockableTrait``
 that adds two convenient methods to lock and release commands::
@@ -39,3 +40,5 @@ that adds two convenient methods to lock and release commands::
             $this->release();
         }
     }
+
+.. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
