Skip to content

Environments

Environment configuration is provided by Symfony. Ibexa DXP additionally enables you to specify environments in virtual host configuration. You can configure several environments, such as production, development, or staging. You can have different configuration sets for each of them.

Web server configuration

For example, when you use Apache, in the VirtualHost example in your installation, the required VirtualHost configurations have been already included. You can switch to the desired environment by setting the ENVIRONMENT variable to prod, dev or another custom value, like in the following example:

1
2
3
4
# Environment.
# Possible values: "prod" and "dev" out-of-the-box, other values possible with proper configuration
# Defaults to "prod" if omitted (uses SetEnvIf so value can be used in rewrite rules)
SetEnvIf Request_URI ".*" APP_ENV="dev"

Custom environments

If you want to use a custom environment (something other than prod and dev), you need to place dedicated configuration files in a separate folder: config/packages/<env_name>/config_<env_name>.yaml

The name used as <env_name> is the one that can be used as value of the ENVIRONMENT variable.

This enables you to override settings defined in the main configuration file, depending on your environment (for example database settings).