control session regenerating id by setting a flag

src/SessionManager.php

@@ -38,6 +38,11 @@ class SessionManager extends AbstractManager
      */
     protected $validatorChain;
 
+    /**
+     * @var bool Regenerate session id flag
+     */
+    protected $regenerateSessionId = true;
+
     /**
      * Constructor
      *
@@ -284,18 +289,42 @@ public function getId()
         return session_id();
     }
 
+    /**
+     * Set flag for regenerate session id
+     *
+     * @param bool $regenerateSessionId
+     * @return SessionManager
+     */
+    public function setRegenerateSessionId($regenerateSessionId)
+    {
+        $this->regenerateSessionId = (bool) $regenerateSessionId;
+        return $this;
+    }
+
+    /**
+     * Get flag for regenerate session id
+     *
+     * @return bool
+     */
+    public function getRegenerateSessionId()
+    {
+        return $this->regenerateSessionId;
+    }
+
     /**
      * Regenerate id
      *
-     * Regenerate the session ID, using session save handler's
-     * native ID generation Can safely be called in the middle of a session.
+     * Regenerate the session ID if `regenerateSessionId` is true, using session save handler's
+     * native ID generation. Can safely be called in the middle of a session.
      *
      * @param  bool $deleteOldSession
      * @return SessionManager
      */
     public function regenerateId($deleteOldSession = true)
     {
-        session_regenerate_id((bool) $deleteOldSession);
+        if ($this->getRegenerateSessionId()) {
+            session_regenerate_id((bool) $deleteOldSession);
+        }
         return $this;
     }
 

test/SessionManagerTest.php

@@ -391,6 +391,30 @@ public function testRegenerateIdShouldWorkAfterSessionStarted()
         $this->assertNotSame($origId, $this->manager->getId());
     }
 
+    /**
+     * @runInSeparateProcess
+     */
+    public function testFlagRegenerateIdSetToTrue()
+    {
+        $this->manager->setRegenerateSessionId(true);
+        $this->manager->start();
+        $origId = $this->manager->getId();
+        $this->manager->regenerateId();
+        $this->assertNotSame($origId, $this->manager->getId());
+    }
+
+    /**
+     * @runInSeparateProcess
+     */
+    public function testFlagRegenerateIdSetToFalse()
+    {
+        $this->manager->setRegenerateSessionId(false);
+        $this->manager->start();
+        $origId = $this->manager->getId();
+        $this->manager->regenerateId();
+        $this->assertSame($origId, $this->manager->getId());
+    }
+
     /**
      * @runInSeparateProcess
      */