Reference
In This Article
The Factory
Zend\Config\Factory
provides the ability to load configuration files to an
array or to a Zend\Config\Config
object. The factory has two purposes
- Loading configuration file(s)
- Storing a configuration file
Storage writes to a single file
Storing the configuration always writes to a single file. The factory is not aware of merged configuration files, and as such cannot split configuration to multiple files. If you want to store particular configuration sections to separate files, you should separate them manually.
Loading configuration files
The first example illustrates loading a single configuration file:
// Load a PHP file as array:
$config = Zend\Config\Factory::fromFile(__DIR__ . '/config/my.config.php');
// Load an XML file as Config object; the second parameter, when true,
// casts the configuration to a Config instance:
$config = Zend\Config\Factory::fromFile(__DIR__.'/config/my.config.xml', true);
The next example demonstrates merging multiple files; note that they are in separate formats!
$config = Zend\Config\Factory::fromFiles([
__DIR__.'/config/my.config.php',
__DIR__.'/config/my.config.xml',
]);
Storing configuration
Sometimes you may want to write configuration to a file. To do this, use the
factory's toFile()
method:
$config = new Zend\Config\Config([], true);
$config->settings = [];
$config->settings->myname = 'framework';
$config->settings->date = '2012-12-12 12:12:12';
//Store the configuration
Zend\Config\Factory::toFile(__DIR__ . '/config/my.config.php', $config);
//Store an array
$config = [
'settings' => [
'myname' => 'framework',
'data' => '2012-12-12 12:12:12',
],
];
Zend\Config\Factory::toFile(__DIR__ . '/config/my.config.php', $config);
Found a mistake or want to contribute to the documentation? Edit this page on GitHub!