v2.1.0

Add optional session key parameter to the start method
Update stepped-form package to the 2.1.0

README.md

@@ -117,7 +117,7 @@ composer require lexal/http-stepped-form
    use Lexal\HttpSteppedForm\SteppedForm;
 
    $form = new SteppedForm(
-       /* a base stepped form from the point 1 */,
+       /* a base stepped form from the step 1 */,
        $formSettings,
        $redirector,
        $renderer,
@@ -131,7 +131,10 @@ composer require lexal/http-stepped-form
     * Starts a new form session.
     * Returns redirect response to the next step or URL after form finish.
     */
-   $form->start(/* an entity for initializing a form state */);
+   $form->start(
+       /* an entity to initialize a form state */,
+       /* unique session key is you need to split different sessions of one form */,
+   );
 
    /* Renders step by its definition */
    $form->render('key');

composer.json

@@ -16,7 +16,7 @@
     ],
     "require": {
         "php": ">=8.1",
-        "lexal/stepped-form": "^2.0",
+        "lexal/stepped-form": "^2.1",
         "symfony/http-foundation": "^5.4 || ^6.4 || ^7.0"
     },
     "require-dev": {

src/SteppedForm.php

@@ -32,10 +32,10 @@ public function getEntity(): mixed
         return $this->form->getEntity();
     }
 
-    public function start(mixed $entity): Response
+    public function start(mixed $entity, string $sessionKey = BaseSteppedFormInterface::DEFAULT_SESSION_KEY): Response
     {
         try {
-            $key = $this->form->start($entity);
+            $key = $this->form->start($entity, $sessionKey);
         } catch (SteppedFormException $exception) {
             return $this->handleFormException($exception);
         }

src/SteppedFormInterface.php

@@ -5,6 +5,7 @@
 namespace Lexal\HttpSteppedForm;
 
 use Lexal\SteppedForm\Exception\FormIsNotStartedException;
+use Lexal\SteppedForm\SteppedFormInterface as BaseSteppedFormInterface;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 
@@ -20,7 +21,7 @@ public function getEntity(): mixed;
     /**
      * Starts a new form session and redirects to the first rendered step.
      */
-    public function start(mixed $entity): Response;
+    public function start(mixed $entity, string $sessionKey = BaseSteppedFormInterface::DEFAULT_SESSION_KEY): Response;
 
     /**
      * Returns a response with rendered step.