[symfony#3245] Removing most of the front controller code altogether

weaverryan · weaverryan · commit 21dc1f0be96d · 2013-12-01T18:14:41.000-05:00
This removes code that could easily become out of date again. Also, I don't think
it was necessary - we want to focus them on only one line anyways.
diff --git a/cookbook/configuration/environments.rst b/cookbook/configuration/environments.rst
@@ -141,36 +141,14 @@ either the ``app.php`` (for the ``prod`` environment) or the ``app_dev.php``
    :doc:`Installing Symfony2 </book/installation>`.
 
 If you open up one of these files, you'll quickly see that the environment
-used by each is explicitly set:
+used by each is explicitly set::
 
-.. code-block:: php
-   :linenos:
-
-    <?php
-
-    use Symfony\Component\ClassLoader\ApcClassLoader;
-    use Symfony\Component\HttpFoundation\Request;
-
-    $loader = require_once __DIR__.'/../app/bootstrap.php.cache';
-
-    // Use APC for autoloading to improve performance.
-    // Change 'sf2' to a unique prefix in order to prevent cache key conflicts
-    // with other applications also using APC.
-    /*
-    $loader = new ApcClassLoader('sf2', $loader);
-    $loader->register(true);
-    */
-
-    require_once __DIR__.'/../app/AppKernel.php';
-    //require_once __DIR__.'/../app/AppCache.php';
+    // web/app.php
+    // ... 
 
     $kernel = new AppKernel('prod', false);
-    $kernel->loadClassCache();
-    //$kernel = new AppCache($kernel);
-    $request = Request::createFromGlobals();
-    $response = $kernel->handle($request);
-    $response->send();
-    $kernel->terminate($request, $response);
+
+    // ...
 
 As you can see, the ``prod`` key specifies that this environment will run
 in the ``prod`` environment. A Symfony2 application can be executed in any
@@ -189,14 +167,14 @@ environment by using this code and changing the environment string.
 .. sidebar:: *Debug* Mode
 
     Important, but unrelated to the topic of *environments* is the ``false``
-    key on line 8 of the front controller above. This specifies whether or
-    not the application should run in "debug mode". Regardless of the environment,
-    a Symfony2 application can be run with debug mode set to ``true`` or
-    ``false``. This affects many things in the application, such as whether
-    or not errors should be displayed or if cache files are dynamically rebuilt
-    on each request. Though not a requirement, debug mode is generally set
-    to ``true`` for the ``dev`` and ``test`` environments and ``false`` for
-    the ``prod`` environment.
+    argument as the second argument to the ``AppKernel`` constructor. This
+    specifies whether or not the application should run in "debug mode". Regardless
+    of the environment, a Symfony2 application can be run with debug mode
+    set to ``true`` or ``false``. This affects many things in the application,
+    such as whether or not errors should be displayed or if cache files are
+    dynamically rebuilt on each request. Though not a requirement, debug mode
+    is generally set to ``true`` for the ``dev`` and ``test`` environments
+    and ``false`` for the ``prod`` environment.
 
     Internally, the value of the debug mode becomes the ``kernel.debug``
     parameter used inside the :doc:`service container </book/service_container>`.
@@ -287,35 +265,15 @@ the ``prod`` environment, except for any changes explicitly made here.
 
 Because you'll want this environment to be accessible via a browser, you
 should also create a front controller for it. Copy the ``web/app.php`` file
-to ``web/app_benchmark.php`` and edit the environment to be ``benchmark``:
+to ``web/app_benchmark.php`` and edit the environment to be ``benchmark``::
 
-.. code-block:: php
-
-    <?php
-
-    use Symfony\Component\ClassLoader\ApcClassLoader;
-    use Symfony\Component\HttpFoundation\Request;
-
-    $loader = require_once __DIR__.'/../app/bootstrap.php.cache';
+    // web/app_benchmark.php
 
-    // Use APC for autoloading to improve performance.
-    // Change 'sf2' to a unique prefix in order to prevent cache key conflicts
-    // with other applications also using APC.
-    /*
-    $loader = new ApcClassLoader('sf2', $loader);
-    $loader->register(true);
-    */
-
-    require_once __DIR__.'/../app/AppKernel.php';
-    //require_once __DIR__.'/../app/AppCache.php';
 
+    // change just this line
     $kernel = new AppKernel('benchmark', false);
-    $kernel->loadClassCache();
-    //$kernel = new AppCache($kernel);
-    $request = Request::createFromGlobals();
-    $response = $kernel->handle($request);
-    $response->send();
-    $kernel->terminate($request, $response);
+
+    // ...
 
 The new environment is now accessible via::
 
