Basic configuration handling in eZ Publish is similar to what is commonly possible with Symfony. Regarding this, you can define key/value pairs in your configuration files, under the main parameters key (like in parameters.yml).
Internally and by convention, keys follow a dot syntax where the different segments follow your configuration hierarchy. Keys are usually prefixed by a namespace corresponding to your application.
Values can be anything, including arrays and deep hashes.
Dynamic configuration with the ConfigResolver
In eZ Publish, it is fairly common to have different settings depending on the current siteaccess (e.g. languages, view provider configuration).
Dynamic configuration can be resolved depending on a scope. It gives the opportunity to define settings for a given siteaccess, for instance, like in the legacy INI override system.
Available scopes are:
- SiteAccess group
The scopes are applied in the order presented. This means that
global overrides all other scopes. If
global is not defined, the configuration will then try to match a SiteAccess, and then a SiteAccess group. Finally, if no other scope is matched,
default will be applied.
In short: if you want a match that will always apply, regardless of SiteAccesses use
global. To define a fallback, use
This mechanism is not limited to eZ Publish internal settings (aka ezsettings namespace) and is applicable for specific needs (bundle related, project related, etc).
Always prefer semantic configuration especially for internal eZ settings.
Manually editing internal eZ settings is possible, but at your own risk as unexpected behavior can occur.
Dynamic configuration is handled by a config resolver. It consists in a service object mainly exposing
getParameter() methods. The idea is to check the different scopes available for a given namespace to find the appropriate parameter.
In order to work with the config resolver, your dynamic settings must comply internally to the following name format :
hasParameter() can take 3 different arguments:
$paramName(i.e. the name of the parameter you need)
$namespace(i.e. your application namespace, myapp in the previous example. If null, the default namespace will be used, which is ezsettings by default)
$scope(i.e. a siteaccess name. If null, the current siteaccess will be used)
Inject the ConfigResolver in your services
Instead of injecting the whole ConfigResolver service, you may directly inject your SiteAccess aware settings (aka dynamic settings) into your own services.
You can use the ConfigResolver in your own services whenever needed. To do this, just inject the
Custom locale configuration (5.1+)
If you need to use a custom locale they can also be configurable in
ezpublish.yml, adding them to the conversion map:
A locale conversion map example can be found in the
core bundle, on