Merge branch 'changing_session_directory' of git://github.com/kevintweber/symfony-docs into kevintweber-changing_session_directory

weaverryan · weaverryan · commit 4a16c2af3e37 · 2013-06-30T14:32:53.000-05:00
Conflicts:
	cookbook/session/index.rst
diff --git a/cookbook/session/index.rst b/cookbook/session/index.rst
@@ -6,3 +6,4 @@ Sessions
 
     proxy_examples
     locale_sticky_session
+    sessions_directory
diff --git a/cookbook/session/sessions_directory.rst b/cookbook/session/sessions_directory.rst
@@ -0,0 +1,50 @@
+.. index::
+   single: Sessions, sessions directory
+
+Configuring Sessions Directory
+==============================
+
+By default, Symfony stores the session data in the cache directory. This
+means that when you clear the cache, any current sessions will also be
+deleted.
+
+Using a different directory to save session data is one method of retaining
+current sessions during a clearing of the cache.
+
+.. tip::
+
+    Using a different session save handler is an excellent (yet more complex)
+    method of session management available within Symfony. See
+    :doc:`/components/http_foundation/session_configuration.rst` for a
+    discussion of session save handlers.
+
+To change the directory in which Symfony saves session data, you only need
+change the framework configuration.  In this example, we are changing the
+session directory to 'app/sessions':
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # app/config/config.yml
+
+        framework:
+            session:
+                save_path: %kernel.root_dir%/sessions
+
+    .. code-block:: xml
+
+        <!-- app/config/config.xml -->
+
+        <framework:config>
+            <framework:session save-path="%kernel.root_dir%/sessions" />
+        </framework:config>
+
+    .. code-block:: php
+
+        // app/config/config.php
+
+        $container->loadFromExtension('framework', array(
+            'session' => array('save-path' => "%kernel.root_dir%/sessions"),
+        ));
+

Original file line number	Diff line number	Diff line change
`@@ -6,3 +6,4 @@ Sessions`
`6`	`6`
`7`	`7`	`proxy_examples`
`8`	`8`	`locale_sticky_session`
	`9`	`+ sessions_directory`