Environment Variables¶

You can reference environment variables by using special parameters named after the variables you want to use enclosed between env(). Their actual values will be resolved at runtime (once per request), so that dumped containers can be reconfigured dynamically even after being compiled.

For example, if you want to use the value of the DATABASE_HOST environment variable in your service container configuration, you can reference it using %env(DATABASE_HOST)% in your configuration files:

You can also give the env() parameters a default value: the default value will be used whenever the corresponding environment variable is not found:

Setting environment variables is generally done at the web server level or in the terminal. If you're using Apache, Nginx or just the console, you can use e.g. one of the following:

Environment Variable Processors¶

The values of environment variables are considered strings by default. However, your code may expect other data types, like integers or booleans. Symfony solves this problem with processors, which modify the contents of the given environment variables. The following example uses the integer processor to turn the value of the HTTP_PORT env var into an integer:

Symfony provides the following env var processors:

env(string:FOO)

Casts FOO to a string:

• YAML

  1 2 3 4 5

  # config/packages/framework.yaml parameters: env(SECRET): 'some_secret' framework: secret: '%env(string:SECRET)%'

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  <!-- config/packages/framework.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:framework="http://symfony.com/schema/dic/symfony" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd"> <parameters> <parameter key="env(SECRET)">some_secret</parameter> </parameters> <framework:config secret="%env(string:SECRET)%" /> </container>

• PHP

  1 2 3 4 5

  // config/packages/framework.php $container->setParameter('env(SECRET)', 'some_secret'); $container->loadFromExtension('framework', [ 'secret' => '%env(string:SECRET)%', ]);

env(bool:FOO)

Casts FOO to a bool:

• YAML

  1 2 3 4 5

  # config/packages/framework.yaml parameters: env(HTTP_METHOD_OVERRIDE): 'true' framework: http_method_override: '%env(bool:HTTP_METHOD_OVERRIDE)%'

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  <!-- config/packages/framework.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:framework="http://symfony.com/schema/dic/symfony" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd"> <parameters> <parameter key="env(HTTP_METHOD_OVERRIDE)">true</parameter> </parameters> <framework:config http-methode-override="%env(bool:HTTP_METHOD_OVERRIDE)%" /> </container>

• PHP

  1 2 3 4 5

  // config/packages/framework.php $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true'); $container->loadFromExtension('framework', [ 'http_method_override' => '%env(bool:HTTP_METHOD_OVERRIDE)%', ]);

env(int:FOO)

Casts FOO to an int.

env(float:FOO)

Casts FOO to a float.

env(const:FOO)

Finds the const value named in FOO:

• YAML

  1 2 3 4 5 6

  # config/packages/security.yaml parameters: env(HEALTH_CHECK_METHOD): 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD' security: access_control: - { path: '^/health-check$', methods: '%env(const:HEALTH_CHECK_METHOD)%' }

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  <!-- config/packages/security.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:security="http://symfony.com/schema/dic/security" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd"> <parameters> <parameter key="env(HEALTH_CHECK_METHOD)">Symfony\Component\HttpFoundation\Request::METHOD_HEAD</parameter> </parameters> <security:config> <rule path="^/health-check$" methods="%env(const:HEALTH_CHECK_METHOD)%" /> </security:config> </container>

• PHP

  1 2 3 4 5 6 7 8 9 10

  // config/packages/security.php $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD'); $container->loadFromExtension('security', [ 'access_control' => [ [ 'path' => '^/health-check$', 'methods' => '%env(const:HEALTH_CHECK_METHOD)%', ], ], ]);

env(base64:FOO)

Decodes the content of FOO, which is a base64 encoded string.

env(json:FOO)

Decodes the content of FOO, which is a JSON encoded string. It returns either an array or null:

• YAML

  1 2 3 4 5

  # config/packages/framework.yaml parameters: env(TRUSTED_HOSTS): '["10.0.0.1", "10.0.0.2"]' framework: trusted_hosts: '%env(json:TRUSTED_HOSTS)%'

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  <!-- config/packages/framework.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:framework="http://symfony.com/schema/dic/symfony" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd"> <parameters> <parameter key="env(TRUSTED_HOSTS)">["10.0.0.1", "10.0.0.2"]</parameter> </parameters> <framework:config trusted-hosts="%env(json:TRUSTED_HOSTS)%" /> </container>

• PHP

  1 2 3 4 5

  // config/packages/framework.php $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]'); $container->loadFromExtension('framework', [ 'trusted_hosts' => '%env(json:TRUSTED_HOSTS)%', ]);

env(resolve:FOO)

Replaces the string FOO by the value of a config parameter with the same name:

• YAML

  1 2 3 4 5 6

  # config/packages/sentry.yaml parameters: env(HOST): '10.0.0.1' env(SENTRY_DSN): 'http://%env(HOST)%/project' sentry: dsn: '%env(resolve:SENTRY_DSN)%'

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14

  <!-- config/packages/sentry.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd"> <parameters> <parameter key="env(HOST)">10.0.0.1</parameter> <parameter key="env(SENTRY_DSN)">http://%env(HOST)%/project</parameter> </parameters> <sentry:config dsn="%env(resolve:SENTRY_DSN)%" /> </container>

• PHP

  1 2 3 4 5 6

  // config/packages/sentry.php $container->setParameter('env(HOST)', '10.0.0.1'); $container->setParameter('env(SENTRY_DSN)', 'http://%env(HOST)%/project'); $container->loadFromExtension('sentry', [ 'dsn' => '%env(resolve:SENTRY_DSN)%', ]);

env(file:FOO)

Returns the contents of a file whose path is the value of the FOO env var:

• YAML

  1 2 3 4 5

  # config/packages/framework.yaml parameters: env(AUTH_FILE): '../config/auth.json' google: auth: '%env(file:AUTH_FILE)%'

• XML

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

  <!-- config/packages/framework.xml --> <?xml version="1.0" encoding="UTF-8" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:framework="http://symfony.com/schema/dic/symfony" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/symfony http://symfony.com/schema/dic/symfony/symfony-1.0.xsd"> <parameters> <parameter key="env(AUTH_FILE)">../config/auth.json</parameter> </parameters> <google auth="%env(file:AUTH_FILE)%" /> </container>

• PHP

  1 2 3 4 5

  // config/packages/framework.php $container->setParameter('env(AUTH_FILE)', '../config/auth.json'); $container->loadFromExtension('google', [ 'auth' => '%env(file:AUTH_FILE)%', ]);

It is also possible to combine any number of processors:

1
2
3
4
5
6
7
8

parameters:
    env(AUTH_FILE): "%kernel.project_dir%/config/auth.json"
google:
    # 1. gets the value of the AUTH_FILE env var
    # 2. replaces the values of any config param to get the config path
    # 3. gets the content of the file stored in that path
    # 4. JSON-decodes the content of the file and returns it
    auth: '%env(json:file:resolve:AUTH_FILE)%'

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

class LowercasingEnvVarProcessor implements EnvVarProcessorInterface
{
    private $container;

    public function __construct(ContainerInterface $container)
    {
        $this->container = $container;
    }

    public function getEnv($prefix, $name, \Closure $getEnv)
    {
        $env = $getEnv($name);

        return strtolower($env);
    }

    public static function getProvidedTypes()
    {
        return [
            'lowercase' => 'string',
        ];
    }
}

Constants¶

The container also has support for setting PHP constants as parameters. See Constants as Parameters for more details.

Miscellaneous Configuration¶

The imports directive can be used to pull in parameters stored elsewhere. Importing a PHP file gives you the flexibility to add whatever is needed in the container. The following imports a file named parameters.php.

In parameters.php, tell the service container the parameters that you wish to set. This is useful when important configuration is in a non-standard format. The example below includes a Drupal database configuration in the Symfony service container:

// app/config/parameters.php
include_once('/path/to/drupal/sites/default/settings.php');
$container->setParameter('drupal.database.url', $db_url);