36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# Application and Module Configuration
|
|
|
|
## Basic usage
|
|
|
|
The \Icinga\Application\Config class is a general purpose service to help you find, load and save
|
|
configuration data. It is used both by the Icinga Web 2 modules and the framework itself. With
|
|
INI files as source it enables you to store configuration in a familiar format. Icinga Web 2
|
|
defines some configuration files for its own purposes. Please note that both modules and framework
|
|
keep their main configuration in the INI file called config.ini. Here's some example code:
|
|
|
|
```php
|
|
<?php
|
|
use \Icinga\Application\Config as IcingaConfig;
|
|
|
|
// Retrieve the default timezone using 'Europe/Berlin' in case it is not set
|
|
IcingaConfig::app()->global->get('defaultTimezone', 'Europe/Berlin');
|
|
|
|
// If you don't pass a configuration name to IcingaConfig::app it tries to load values from the
|
|
// application's config.ini. For using other files you have to pass this parameter though.
|
|
// The following example loads a section from the application's authentication.ini:
|
|
IcingaConfig::app('authentication')->get('ldap-authentication');
|
|
|
|
// If you don't pass a configuration name to IcingaConfig::module it tries to load values from
|
|
// the module's config.ini. For using other files you have to pass this parameter though.
|
|
// The following example loads values from the example module's extra.ini:
|
|
IcingaConfig::module('example', 'extra')->logging->get('enabled', true);
|
|
```
|
|
|
|
## Reload from disk
|
|
|
|
If you want to force reading a configuration from disk (i.e. after you modified it), you can use the $fromDisk flag in
|
|
the IcingaConfig::app/IcingaConfig::module call:
|
|
|
|
IcingaConfig::app('authentication', true)-> ... // read authentication from disk
|
|
IcingaConfig::module('example', 'extra', true)->... // read module configuration from disk
|