Merge branch '2.1' into 2.2

Author: weaverryan

components/filesystem.rst

@@ -204,7 +204,7 @@ Return the relative path of a directory given another one::
         '/var/lib/symfony/src/Symfony/Component'
     );
     // returns 'videos'
-    $fs->makePathRelative('/tmp', '/tmp/videos');
+    $fs->makePathRelative('/tmp/videos', '/tmp')
 
 mirror
 ~~~~~~

components/http_foundation/trusting_proxies.rst

@@ -18,7 +18,7 @@ your proxy::
 
     $request = Request::createFromGlobals();
     // only trust proxy headers coming from this IP address
-    $request->setTrustedProxies(array(192.0.0.1));
+    $request->setTrustedProxies(array('192.0.0.1'));
 
 Configuring Header Names
 ------------------------

cookbook/form/dynamic_form_modification.rst

@@ -458,7 +458,7 @@ This can be used to get the ``SportMeetup`` id and retrieve it from the database
 given you have a reference to the object manager (if using doctrine). In
 the end, you have an event subscriber that listens to two different events,
 requires some external services and customizes the form. In such a situation,
-it's probably better to define this as a service rather than using an anonymouse
+it's probably better to define this as a service rather than using an anonymous
 function as the event listener callback.
 
 The subscriber would now look like::

cookbook/index.rst

@@ -13,6 +13,7 @@ The Cookbook
     validation/index
     configuration/index
     service_container/index
+    session/index
     bundles/index
     email/index
     testing/index

cookbook/map.rst.inc

@@ -133,6 +133,10 @@
   * :doc:`/cookbook/service_container/scopes`
   * :doc:`/cookbook/service_container/compiler_passes`
 
+* :doc:`/cookbook/session/index`
+
+  * :doc:`/cookbook/session/proxy_examples`
+
 * **symfony1**
 
   * :doc:`/cookbook/symfony1`

cookbook/session/index.rst

@@ -0,0 +1,7 @@
+Sessions
+========
+
+.. toctree::
+    :maxdepth: 2
+
+    proxy_examples

cookbook/session/proxy_examples.rst

@@ -0,0 +1,84 @@
+.. index::
+   single: Sessions, session proxy, proxy
+
+Session Proxy Examples
+----------------------
+
+The session proxy mechanism has a variety of uses and this example demonstrates
+two common uses. Rather than injecting the session handler as normal, a handler
+is injected into the proxy and registered with the session storage driver::
+
+    use Symfony\Component\HttpFoundation\Session\Session;
+    use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
+    use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionStorage;
+
+    $proxy = new YourProxy(new PdoSessionStorage());
+    $session = new Session(new NativeSessionStorage($proxy));
+
+Below, you'll learn two real examples that can be used for ``YourProxy``:
+encryption of session data and readonly guest session.
+
+Encryption of Session Data
+--------------------------
+
+If you wanted to encrypt the session data, you could use the proxy to encrypt
+and decrypt the session as required::
+
+    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
+
+    class EncryptedSessionProxy extends SessionHandlerProxy
+    {
+        private $key;
+
+        public function __construct(\SessionHandlerInterface $handler, $key)
+        {
+            $this->key = $key;
+
+            parent::__construct($handler);
+        }
+
+        public function read($id)
+        {
+            $data = parent::write($id, $data);
+
+            return mcrypt_decrypt(\MCRYPT_3DES, $this->key, $data);
+        }
+
+        public function write($id, $data)
+        {
+            $data = mcrypt_encrypt(\MCRYPT_3DES, $this->key, $data);
+
+            return parent::write($id, $data);
+        }
+    }
+
+Readonly Guest Sessions
+-----------------------
+
+There are some applications where a session is required for guest users, but
+there is no particular need to persist the session. In this case you can
+intercept the session before it writes::
+
+    use Foo\User;
+    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
+
+    class ReadOnlyGuestSessionProxy extends SessionHandlerProxy
+    {
+        private $user;
+
+        public function __construct(\SessionHandlerInterface $handler, User $user)
+        {
+            $this->user = $user;
+
+            parent::__construct($handler);
+        }
+
+        public function write($id, $data)
+        {
+            if ($this->user->isGuest()) {
+                return;
+            }
+
+            return parent::write($id, $data);
+        }
+    }

reference/configuration/framework.rst

@@ -26,6 +26,7 @@ Configuration
     * enabled
     * field_name
 * `session`_
+    * `name`_
     * `cookie_lifetime`_
     * `cookie_path`_
     * `cookie_domain`_
@@ -148,6 +149,14 @@ csrf_protection
 session
 ~~~~~~~
 
+name
+....
+
+**type**: ``string`` **default**: ``null``
+
+This specifies the name of the session cookie. By default it will use the cookie
+name which is defined in the ``php.ini`` with the ``session.name`` directive.
+
 cookie_lifetime
 ...............
 

reference/constraints/Range.rst

@@ -51,8 +51,8 @@ the following:
         {
             /**
              * @Assert\Range(
-             *      min = "120",
-             *      max = "180",
+             *      min = 120,
+             *      max = 180,
              *      minMessage = "You must be at least 120cm tall to enter",
              *      maxMessage = "You cannot be taller than 180cm to enter"
              * )

reference/dic_tags.rst

@@ -55,8 +55,6 @@ may also be tags in other bundles you use that aren't listed here.
 +-----------------------------------+---------------------------------------------------------------------------+
 | `security.remember_me_aware`_     | To allow remember me authentication                                       |
 +-----------------------------------+---------------------------------------------------------------------------+
-| `security.listener.factory`_      | Necessary when creating a custom authentication system                    |
-+-----------------------------------+---------------------------------------------------------------------------+
 | `swiftmailer.plugin`_             | Register a custom SwiftMailer Plugin                                      |
 +-----------------------------------+---------------------------------------------------------------------------+
 | `templating.helper`_              | Make your service available in PHP templates                              |
@@ -711,14 +709,6 @@ of your configuration, and tag it with ``routing.loader``:
 
 For more information, see :doc:`/cookbook/routing/custom_route_loader`.
 
-security.listener.factory
--------------------------
-
-**Purpose**: Necessary when creating a custom authentication system
-
-This tag is used when creating your own custom authentication system. For
-details, see :doc:`/cookbook/security/custom_authentication_provider`.
-
 security.remember_me_aware
 --------------------------