Easy Application Configuration With patConfiguration - Anatomy Class (
Page 4 of 11 )
Next, it's time to use the patConfiguration engine to read
and use the values in the configuration file. Here's how:
<?
// include class
require("patConfiguration.php");
// create patConfiguration
object
$conf = new patConfiguration;
// set config file locations
$conf->setConfigDir("config");
//
read config file
$conf->parseConfigFile("config.xml");
// print configuration
print_r($conf->getConfigValue());
?>
Here's the output:
Array
(
[application.name] => SomeApp
[application.version] => 2.3
[application.window.height] => 600
[application.window.width] => 500
[application.window.list.maxItems] => 5
)
Let's dissect this a little to see how it works.
1. The first step is, obviously, to include all the relevant files for the class
to work.
// include class
require("patConfiguration.php");
Once that's done, I can safely create an object of the patConfiguration class.
// create patConfiguration object
$conf = new patConfiguration;
This object instance will serve as the primary access point to the data in the
application configuration file(s), allowing me to do all kinds of nifty things
with it.
2. Next, the object's setConfigDir() method is used to set the default location
of the configuration files,
// set config file locations
$conf->setConfigDir("config");
and the parseConfigFile() method is used to actually read each file into the
object's internal stack.
// read config file
$conf->parseConfigFile("config.xml");
You can parse multiple configuration files by calling parseConfigFile() for each
file, and telling patConfiguration to append (instead of overwriting) each set
of configuration variables to the existing stack via the additional "a" option
- as in the following code snippet:
// read config files
$conf->parseConfigFile("config.main.xml");
$conf->parseConfigFile("config.local.xml",
"a");
$conf->parseConfigFile("config.users.xml", "a");
4. Finally, all that's left is to actually use the configuration data - in this
case, print it all to the standard output device.
// print configuration
print_r($conf->getConfigValue());
The getConfigValue() method gets the value of a specified configuration variable
from the configuration file(s). If no variable name is specified, the entire set
of values is returned...as in the example above.
