Download the PHP package adrenalinkin/config-helper without Composer

Config Helper

Introduction

Component allows extend standard class Symfony\Component\DependencyInjection\Extension\Extension and open possibility for collect YAML configurations across all registered bundles.

Installation

Open a command console, enter your project directory and execute the following command to download the latest stable version of this component:

This command requires you to have Composer install globally.

Usage examples and compare with standard methods

Let's say we have two bundles in our project. Bundles contains business-logic of the two separate system parts:

• AcmeBundle with entities AcmeBundle:User and AcmeBundle:Position
• AcmePostBundle with entity AcmePostBundle:Post

Imagine you need to add configuration for each entity. Let's say we need configuration which should determine user's system role for get access to specific functionality. For the configuration creation has been created bundle AcmeConfigBundle. Configuration example:

Standard methods

We can put configuration into global configuration file app/config/config.yml:

Also, we can put configuration into AcmeConfigBundle bundle under specific configuration file and load that from AcmeConfigExtension:

However, both of method, for our realisation, got one flaw. All time when we will create new bundles - we will need modify global configuration file or configuration file in the AcmeConfigBundle. Both situation provoke a hard-linking between separate parts of the project

Component usage

To prevent hard-linkin between separate parts of the project you need:

• Choose file name for configuration store, for example acme_config.yml.

• Extends AcmeConfigExtension from AbstractExtension:

• Create configuration files per bundles:

This method allows you create and remove configurations in the bundles without global changes in the project. You can remove some configuration in the needed bundle or even remove whole bundle ( for example AcmePostBundle).

Note: By default method getConfigurationsFromFile($fileName, ContainerBuilder $container, $merge = true) uses standard PHP function array_merge_recursive to merge all found configurations. If you want prepare configuration by yourself put false as third parameter and receive stack of the all registered configurations.

License