Accessing the configuration

Accessing the configuration

In Lion, each context has his own configuration. The way to access to the configuration within a context is by ussing the __Context::getConfiguration() method, which returns a reference to the associated context __Configuration instance.

The __Configuration class represents a configuration file applicable to a particular application and provides accessors to get any configuration value.

i.e.

<?php
 
//get a reference to the application configuration:
$app_config = __ApplicationContext::getInstance()->
                                    getConfiguration();

Getting a configuration section

A section within the configuration can be retrieved by ussing the getSection method.

Note that in order to get a section within the Lion configuration we need to access first to the configuration section because all the Lion sections are enclosed by that section.

i.e., imagine the following configuration content:

<?xml version = "1.0" standalone="yes"?>
 
<foobars>
  <foo bar="lion"/>
  <foo bar="rocks"/>
</foobars>

To access to the foobars section, we should need a code like the following one:

<?php
 
//get an array of Foo instances according
//to the configuration:
$foos = __ApplicationContext::getInstance()->
                              getConfiguration()->
                              getSection('foobars');

Getting a property value

Some configuration files are structured to just define property values (property files).

i.e.,

;----------------------------------
; DATABASE CONNECTION PARAMETERS:
;----------------------------------
 
DATABASE_HOST = "127.0.0.1"
DATABASE_NAME = "foobar"
DATABASE_USERNAME = "root"
DATABASE_PASSWORD = "secret"

For those files, the __Configuration class define a really usefull method to access to the property values: __Configuration::getPropertyContent().

i.e.

<?php
 
$db_name = __ApplicationContext::getInstance()->
                                 getConfiguration()->
                                 getPropertyContent('DATABASE_NAME');