Change Router Configuration Parameters

To dump Apache routes you must first tweak some configuration parameters to tell Symfony2 to use the ApacheUrlMatcher instead of the default one:

1
2
3
4

# app/config/config_prod.yml
parameters:
    router.options.matcher.cache_class: ~ # disable router cache
    router.options.matcher_class: Symfony\Component\Routing\Matcher\ApacheUrlMatcher

1
2
3
4
5
6
7

<!-- app/config/config_prod.xml -->
<parameters>
    <parameter key="router.options.matcher.cache_class">null</parameter> <!-- disable router cache -->
    <parameter key="router.options.matcher_class">
        Symfony\Component\Routing\Matcher\ApacheUrlMatcher
    </parameter>
</parameters>

1
2
3
4
5
6

// app/config/config_prod.php
$container->setParameter('router.options.matcher.cache_class', null); // disable router cache
$container->setParameter(
    'router.options.matcher_class',
    'Symfony\Component\Routing\Matcher\ApacheUrlMatcher'
);

Generating mod_rewrite rules

To test that it's working, let's create a very basic route for the AcmeDemoBundle:

1
2
3
4

# app/config/routing.yml
hello:
    path:  /hello/{name}
    defaults: { _controller: AcmeDemoBundle:Demo:hello }

1
2
3
4

<!-- app/config/routing.xml -->
<route id="hello" path="/hello/{name}">
    <default key="_controller">AcmeDemoBundle:Demo:hello</default>
</route>

1
2
3
4

// app/config/routing.php
$collection->add('hello', new Route('/hello/{name}', array(
    '_controller' => 'AcmeDemoBundle:Demo:hello',
)));

Now generate the mod_rewrite rules:

1

$ php app/console router:dump-apache -e=prod --no-debug

Which should roughly output the following:

1
2
3
4
5
6
7

# skip "real" requests
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule .* - [QSA,L]

# hello
RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$
RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello]

You can now rewrite web/.htaccess to use the new rules, so with this example it should look like this:

1
2
3
4
5
6
7
8
9
10
11

<IfModule mod_rewrite.c>
    RewriteEngine On

    # skip "real" requests
    RewriteCond %{REQUEST_FILENAME} -f
    RewriteRule .* - [QSA,L]

    # hello
    RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$
    RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello]
</IfModule>

That's it! You're now all set to use Apache routes.

Additional tweaks

To save a little bit of processing time, change occurrences of Request to ApacheRequest in web/app.php:

1
2
3
4
5
6
7
8
9
10
11
12

// web/app.php

require_once __DIR__.'/../app/bootstrap.php.cache';
require_once __DIR__.'/../app/AppKernel.php';
// require_once __DIR__.'/../app/AppCache.php';

use Symfony\Component\HttpFoundation\ApacheRequest;

$kernel = new AppKernel('prod', false);
$kernel->loadClassCache();
// $kernel = new AppCache($kernel);
$kernel->handle(ApacheRequest::createFromGlobals())->send();