Merge branch '2.1' into 2.2

Author: weaverryan

cookbook/map.rst.inc

@@ -148,6 +148,7 @@
 * :doc:`/cookbook/testing/index`
 
   * :doc:`/cookbook/testing/http_authentication`
+  * :doc:`/cookbook/testing/simulating_authentication`
   * :doc:`/cookbook/testing/insulating_clients`
   * :doc:`/cookbook/testing/profiling`
   * :doc:`/cookbook/testing/doctrine`

cookbook/testing/index.rst

@@ -5,6 +5,7 @@ Testing
     :maxdepth: 2
 
     http_authentication
+    simulating_authentication
     insulating_clients
     profiling
     doctrine

cookbook/testing/simulating_authentication.rst

@@ -0,0 +1,61 @@
+.. index::
+   single: Tests; Simulating authentication
+
+How to simulate Authentication with a Token in a Functional Test
+================================================================
+
+Authenticating requests in functional tests might slow down the suite.
+It could become an issue especially when ``form_login`` is used, since
+it requires additional requests to fill in and submit the form.
+
+One of the solutions is to configure your firewall to use ``http_basic`` in
+the test environment as explained in
+:doc:`/cookbook/testing/http_authentication`.
+Another way would be to create a token yourself and store it in a session.
+While doing this, you have to make sure that appropriate cookie is sent
+with a request. The following example demonstrates this technique::
+
+    // src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php
+    namespace Acme\DemoBundle\Tests\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+    use Symfony\Component\BrowserKit\Cookie;
+    use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
+
+    class DemoControllerTest extends WebTestCase
+    {
+        private $client = null;
+
+        public function setUp()
+        {
+            $this->client = static::createClient();
+        }
+
+        public function testSecuredHello()
+        {
+            $this->logIn();
+
+            $this->client->request('GET', '/demo/secured/hello/Fabien');
+
+            $this->assertTrue($this->client->getResponse()->isSuccessful());
+            $this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());
+        }
+
+        private function logIn()
+        {
+            $session = $this->client->getContainer()->get('session');
+
+            $firewall = 'secured_area';
+            $token = new UsernamePasswordToken('admin', null, $firewall, array('ROLE_ADMIN'));
+            $session->set('_security_'.$firewall, serialize($token));
+            $session->save();
+
+            $cookie = new Cookie($session->getName(), $session->getId());
+            $this->client->getCookieJar()->set($cookie);
+        }
+    }
+
+.. note::
+
+    The technique described in :doc:`/cookbook/testing/http_authentication`.
+    is cleaner and therefore preferred way.