Add PreSave and PostSave events (#78)

Controller/ParameterController.php

@@ -2,6 +2,8 @@
 
 namespace Sherlockode\ConfigurationBundle\Controller;
 
+use Sherlockode\ConfigurationBundle\Event\PostSaveEvent;
+use Sherlockode\ConfigurationBundle\Event\PreSaveEvent;
 use Sherlockode\ConfigurationBundle\Event\SaveEvent;
 use Sherlockode\ConfigurationBundle\Form\Type\ImportType;
 use Sherlockode\ConfigurationBundle\Form\Type\ParametersType;
@@ -122,13 +124,28 @@ public function listAction(Request $request)
 
         if ($form->isSubmitted() && $form->isValid()) {
             $params = $form->getData();
+
+            $preSaveEvent = new PreSaveEvent($request, $params);
+            $this->eventDispatcher->dispatch($preSaveEvent);
+
+            if ($preSaveEvent->getResponse()) {
+                return $preSaveEvent->getResponse();
+            }
+
             foreach ($params as $path => $value) {
                 $this->parameterManager->set($path, $value);
             }
             $this->parameterManager->save();
 
             $this->eventDispatcher->dispatch(new SaveEvent());
 
+            $postSaveEvent = new PostSaveEvent($request);
+            $this->eventDispatcher->dispatch($postSaveEvent);
+
+            if ($postSaveEvent->getResponse()) {
+                return $postSaveEvent->getResponse();
+            }
+
             return $this->redirectToRoute('sherlockode_configuration.parameters');
         }
 

Event/PostSaveEvent.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Sherlockode\ConfigurationBundle\Event;
+
+use Symfony\Component\HttpFoundation\Request;
+
+class PostSaveEvent
+{
+    use ResponseEventTrait;
+    use RequestEventTrait;
+
+    /**
+     * @param Request $request
+     */
+    public function __construct(Request $request)
+    {
+        $this->request = $request;
+    }
+}

Event/PreSaveEvent.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Sherlockode\ConfigurationBundle\Event;
+
+use Symfony\Component\HttpFoundation\Request;
+
+class PreSaveEvent
+{
+    use ResponseEventTrait;
+    use RequestEventTrait;
+
+    /**
+     * @var array
+     */
+    private $parameters;
+
+    /**
+     * @param array $parameters
+     */
+    public function __construct(Request $request, $parameters)
+    {
+        $this->request = $request;
+        $this->parameters = $parameters;
+    }
+
+    /**
+     * @return array
+     */
+    public function getParameters()
+    {
+        return $this->parameters;
+    }
+}

Event/RequestEventTrait.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Sherlockode\ConfigurationBundle\Event;
+
+use Symfony\Component\HttpFoundation\Request;
+
+trait RequestEventTrait
+{
+    /**
+     * @var Request
+     */
+    private $request;
+
+    /**
+     * @return Request
+     */
+    public function getRequest()
+    {
+        return $this->request;
+    }
+}

Event/ResponseEventTrait.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Sherlockode\ConfigurationBundle\Event;
+
+use Symfony\Component\HttpFoundation\Response;
+
+trait ResponseEventTrait
+{
+    /**
+     * @var Response
+     */
+    private $response;
+
+    /**
+     * @return Response
+     */
+    public function getResponse()
+    {
+        return $this->response;
+    }
+
+    /**
+     * @param Response $response
+     *
+     * @return $this
+     */
+    public function setResponse(Response $response)
+    {
+        $this->response = $response;
+
+        return $this;
+    }
+}

README.md

@@ -265,6 +265,16 @@ So be sure to generate your credentials with the following command:
 $ php bin/console secrets:generate-keys
 ```
 
+### Events
+
+When parameters are saved in database, multiple events are dispatched
+
+* `Sherlockode\ConfigurationBundle\Event\PreSaveEvent` is dispatch before saving parameters;
+* `Sherlockode\ConfigurationBundle\Event\SaveEvent` is dispatch just after saving new parameters values
+  in database;
+* `Sherlockode\ConfigurationBundle\Event\PostSaveEvent` is dispatch just after the SaveEvent. It can be 
+  useful for customizing redirection or adding flash message for example;
+
 ## Field types
 
 ### Default types