Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Tip |
---|
The following recipe is valid for any type of settings supported by Symfony framework. |
Description
Usually, you develop your website using one or several custom bundles as this is a best practice. However, dealing with core bundle semantic configuration can be a bit tedious if you maintain it in the main app/config/ezplatform.yml
configuration file.
Solution
This recipe will show you how to import configuration from a bundle the manual way and the implicit way.
The manual way
This is the simplest way of doing and it has the advantage of being explicit. The idea is to use the imports
statement in your main ezplatform.yml
:
Code Block | ||
---|---|---|
| ||
imports: # Let's import our template selection rules that reside in our custom bundle. # MyCustomBundle is the actual bundle name - {resource: "@AcmeTestBundle/Resources/config/templates_rules.yml"} ezpublish: # ... |
Code Block | ||
---|---|---|
| ||
# Here I need to reproduce the right configuration tree. # It will be merged with the main one ezpublish: system: my_siteaccess: ezpage: layouts: 2ZonesLayout1: name: "2 zones (layout 1)" template: "AcmeTestBundle:zone:2zoneslayout1.html.twig" content_view: full: article_test: template: "AcmeTestBundle:full:article_test.html.twig" match: Id\Location: [144,149] another_test: template: "::another_test.html.twig" match: Id\Content: 142 block_view: campaign: template: "AcmeTestBundle:block:campaign.html.twig" match: Type: "Campaign" |
Info |
---|
During the merge process, if the imported configuration files contain entries that are already defined in the main configuration file, they will override them. |
Tip | ||
---|---|---|
| ||
If you want to import configuration for development use only, you can do so in your |
The implicit way
The following example will show you how to implicitly load settings to configure eZ Platform kernel. Note that this is also valid for any bundle!
We assume here that you're aware of service container extensions.
Code Block | ||||
---|---|---|---|---|
| ||||
<?php namespace Acme\TestBundle\DependencyInjection; use Symfony\Component\DependencyInjection\ContainerBuilder; use Symfony\Component\Config\Resource\FileResource; use Symfony\Component\Config\FileLocator; use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface; use Symfony\Component\HttpKernel\DependencyInjection\Extension; use Symfony\Component\DependencyInjection\Loader; use Symfony\Component\Yaml\Yaml; /** * This is the class that loads and manages your bundle configuration * * To learn more see {@link http://symfony.com/doc/current/cookbook/bundles/extension.html} */ class AcmeTestExtension extends Extension implements PrependExtensionInterface { // ... /** * Allow an extension to prepend the extension configurations. * Here we will load our template selection rules. * * @param ContainerBuilder $container */ public function prepend( ContainerBuilder $container ) { // Loading our YAML file containing our template rules $configFile = __DIR__ . '/../Resources/config/template_rules.yml'; $config = Yaml::parse( file_get_contents( $configFile ) ); // We explicitly prepend loaded configuration for "ezpublish" namespace. // So it will be placed under the "ezpublish" configuration key, like in ezpublish.yml. $container->prependExtensionConfig( 'ezpublish', $config ); $container->addResource( new FileResource( $configFile ) ); } } |
Code Block | ||
---|---|---|
| ||
# We explicitly prepend config for "ezpublish" namespace in service container extension, # so no need to repeat it here system: ezdemo_frontend_group: ezpage: layouts: 2ZonesLayout1: name: "2 zones (layout 1)" template: "AcmeTestBundle:zone:2zoneslayout1.html.twig" content_view: full: article_test: template: "AcmeTestBundle:full:article_test.html.twig" match: Id\Location: 144 another_test: template: "::another_test.html.twig" match: Id\Content: 142 block_view: campaign: template: "AcmeTestBundle:block:campaign.html.twig" match: Type: "Campaign" |
Info | ||
---|---|---|
| ||
Service container extensions are called only when the container is being compiled, so there is nothing to worry about regarding performance. |
Tip |
---|
Configuration loaded this way will be overridden by the main |
In this topic:
Table of Contents | ||
---|---|---|
|