Merge pull request symfony#2856 from drak/patch-1

weaverryan · weaverryan · commit a77e3d06735b · 2013-07-28T16:53:16.000-07:00
Clarify php session bridge cookbook.
diff --git a/cookbook/session/php_bridge.rst b/cookbook/session/php_bridge.rst
@@ -33,4 +33,14 @@ the example below:
             storage_id: session.storage.php_bridge
             handler_id: session.handler.native_file
 
-For more details, see :doc:`/components/http_foundation/session_php_bridge`.
+.. note::
+
+If the legacy application requires it's own session save-handler, do not
+override this, rather set ``handler_id: ~``. Note that a save handler cannot
+be changed once the session has been started. If the application starts the
+session before Symfony initializes the save-handler will have already been 
+set. You will need ``handler_id: ~``. Only override the save-handler if you
+are sure the legacy application can use the Symfony save-handler without
+side effects and that the session has not been started before Symfony inializes.
+
+For more details, see :doc:`/components/http_foundation/session_php_bridge`.
