Merge branch '4.3' into 4.4

wouterj · wouterj · commit 89f8e68423f5 · 2019-11-23T16:29:34.000+01:00
* 4.3: [#12545] Slightly improved the title Show how to retrieve workflow in a class
diff --git a/workflow.rst b/workflow.rst
@@ -215,6 +215,38 @@ what actions are allowed on a blog post::
 
     // See all the available transitions for the post in the current state
     $transitions = $workflow->getEnabledTransitions($post);
+    
+Accessing the Workflow in a Class
+---------------------------------
+
+To access workflow inside a class, use dependency injection and inject the
+registry in the constructor::
+
+    use Symfony\Component\Workflow\Registry;
+    
+    class MyClass
+    {
+    
+        private $worflowRegistry;
+    
+        public function __construct(Registry $workflowRegistry)
+        {
+            $this->worflowRegistry = $worflowRegistry;
+        }
+    
+        public function toReview(BlogPost $blogPost)
+        {
+            $workflow = $this->worflowRegistry->get($blogPost);
+        
+            // Update the currentState on the post
+            try {
+                $workflow->apply($post, 'to_review');
+            } catch (LogicException $exception) {
+                // ...
+            }
+            // ...
+        }
+    }
 
 Using Events
 ------------
