Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages showcasing Symfony with Docker, APIs, queues & async tasks, Webpack, SPAs, etc.

  1. Home
  2. Documentation
  3. Symfony CMF
  4. Configuration Reference

Configuration Reference

1.3 version
Maintained
1.3 current 1.3 current
edit this page

Configuration Reference

The RoutingAutoBundle can be configured under the cmf_routing_auto key in your application configuration.

Configuration

adapter

type: scalar default: doctrine_phpcr_odm if persistence configuration option is set to phpcr

Alias of the adapter used to manage routes.

auto_mapping

type: boolean default: true

Look for the configuration file cmf_routing_auto.yml in Resource/config folder of all available bundles.

mapping

Specify files with auto routing mapping.

  • YAML
    1
2
3
4
5
6
7
    # app/config/config.yml
cmf_routing_auto:
    mapping:
        resources:
            -
                path: app/Resources/routing_auto.yml
                type: yaml
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    <!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services">

    <config xmlns="http://cmf.symfony.com/schema/dic/routing_auto">
        <mapping>
            <resource path="app/Resources/routing_auto.yml" type="yaml"/>
        </mapping>
    </config>

</container>
  • PHP
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    // app/config/config.php
$container->loadFromExtension('cmf_routing_auto', [
    'mapping' => [
        'resources' => [
            [
                'path' => 'app/Resources/routing_auto.yml',
                'type' => 'yaml',
            ],
        ],
    ],
]);

path

type: scalar required

Path to the auto route mapping file in the project.

type

type: enum values: yaml``|``xml optional

Type of the configuration file, for the Symfony configuration loader.

persistence

Select persistence mode. Only PHPCR is provided by this bundle.

phpcr

Use this section to configure the PHPCR adapter.

  • YAML
    1
2
3
4
5
6
    # app/config/config.yml
cmf_routing_auto:
    persistence:
        phpcr:
            enabled: true
            route_basepath: /cms/routes
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
    <!-- app/config/config.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services">

    <config xmlns="http://cmf.symfony.com/schema/dic/routing_auto">
        <persistence>
            <phpcr enabled="true" route-basepath="/cms/routes"/>
        </persistence>
    </config>

</container>
  • PHP
    1
2
3
4
5
6
7
8
9
    // app/config/config.php
$container->loadFromExtension('cmf_routing_auto', [
    'persistence' => [
        'phpcr' => [
            'enabled' => true,
            'route_basepath' => '/cms/routes',
        ],
    ],
]);

enabled

type: Boolean default: false

route_basepath

type: scalar default: /cms/routes

Path to the root route to know where to add auto routes.

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.