symfony
diff --git a/‎src/Symfony/Component/HttpFoundation/Resources/stubs/SessionHandlerInterface.php
Lines changed: 12 additions & 0 deletions b/‎src/Symfony/Component/HttpFoundation/Resources/stubs/SessionHandlerInterface.php
Lines changed: 12 additions & 0 deletions
@@ -12,13 +12,22 @@
 /**
  * SessionHandlerInterface for PHP < 5.4
  *
+ * The order in which these methods are invoked by PHP are:
+ * 1. open [session_start]
+ * 2. read
+ * 3. gc [optional depending on probability settings: gc_probability / gc_divisor]
+ * 4. destroy [optional when session_regenerate_id(true) is used]
+ * 5. write [session_write_close] or destroy [session_destroy]
+ * 6. close
+ *
  * Extensive documentation can be found at php.net, see links:
  *
  * @see http://php.net/sessionhandlerinterface
  * @see http://php.net/session.customhandler
  * @see http://php.net/session-set-save-handler
  *
  * @author Drak <[email protected]>
+ * @author Tobias Schultze <http://tobion.de>
  */
 interface SessionHandlerInterface
 {
@@ -57,6 +66,9 @@ public function read($sessionId);
     /**
      * Writes the session data to the storage.
      *
+     * Care, the session ID passed to write() can be different from the one previously
+     * received in read() when the session ID changed due to session_regenerate_id().
+     *
      * @see http://php.net/sessionhandlerinterface.write
      *
      * @param string $sessionId Session ID , see http://php.net/function.session-id
Original file line number	Diff line number	Diff line change
`@@ -12,13 +12,22 @@`
`12`	`12`	`/**`
`13`	`13`	`* SessionHandlerInterface for PHP < 5.4`
`14`	`14`	`*`
	`15`	`+ * The order in which these methods are invoked by PHP are:`
	`16`	`+ * 1. open [session_start]`
	`17`	`+ * 2. read`
	`18`	`+ * 3. gc [optional depending on probability settings: gc_probability / gc_divisor]`
	`19`	`+ * 4. destroy [optional when session_regenerate_id(true) is used]`
	`20`	`+ * 5. write [session_write_close] or destroy [session_destroy]`
	`21`	`+ * 6. close`
	`22`	`+ *`
`15`	`23`	`* Extensive documentation can be found at php.net, see links:`
`16`	`24`	`*`
`17`	`25`	`* @see http://php.net/sessionhandlerinterface`
`18`	`26`	`* @see http://php.net/session.customhandler`
`19`	`27`	`* @see http://php.net/session-set-save-handler`
`20`	`28`	`*`
`21`	`29`	`* @author Drak <[email protected]>`
	`30`	`+ * @author Tobias Schultze <http://tobion.de>`
`22`	`31`	`*/`
`23`	`32`	`interface SessionHandlerInterface`
`24`	`33`	`{`
`@@ -57,6 +66,9 @@ public function read($sessionId);`
`57`	`66`	`/**`
`58`	`67`	`* Writes the session data to the storage.`
`59`	`68`	`*`
	`69`	`+ * Care, the session ID passed to write() can be different from the one previously`
	`70`	`+ * received in read() when the session ID changed due to session_regenerate_id().`
	`71`	`+ *`
`60`	`72`	`* @see http://php.net/sessionhandlerinterface.write`
`61`	`73`	`*`
`62`	`74`	`* @param string $sessionId Session ID , see http://php.net/function.session-id`