读取配置Reading Configurations

Phalcon\Config 是一个用于将各种格式的配置文件读取到PHP对象的组件（使用适配器）。

Phalcon\Config is a component used to read configuration files of various formats (using adapters) into PHP objects for use in an application.

文件适配器File Adapters

可用的适配器有:

The adapters available are:

原生数组Native Arrays

下面的例子展示如何将本地数组导入 PhalconConfig 对象。此选项提供了最好的性能，因为在这个请求中没有读取文件。

The next example shows how to convert native arrays into Phalcon\Config objects. This option offers the best performance since no files are read during this request.

<?php
use Phalcon\Config;
$settings = array(
    "database" => array(
        "adapter"    => "Mysql",
        "host"       => "localhost",
        "username"   => "scott",
        "password"   => "cheetah",
        "dbname"     => "test_db",
    ),
     "app" => array(
        "controllersDir" => "../app/controllers/",
        "modelsDir"      => "../app/models/",
        "viewsDir"       => "../app/views/",
    ),
    "mysetting" => "the-value"
);
$config = new Config($settings);
echo $config->app->controllersDir, "\n";
echo $config->database->username, "\n";
echo $config->mysetting, "\n";

如果你想更好的组织你的项目，你可以在另一个文件保存数组，然后读入它。

If you want to better organize your project you can save the array in another file and then read it.

<?php
use Phalcon\Config;
require "config/config.php";
$config = new Config($settings);

读取 INI 文件Reading INI Files

INI文件是存储设置的常用方法。Phalcon\Config 采用优化的PHP函数parse_ini_file读取这些文件。为方便访问，文件部分解析成子设置。

Ini files are a common way to store settings. Phalcon\Config uses the optimized PHP function parse_ini_file to read these files. Files sections are parsed into sub-settings for easy access.

[database]
adapter  = Mysql
host     = localhost
username = scott
password = cheetah
dbname   = test_db
[phalcon]
controllersDir = "../app/controllers/"
modelsDir      = "../app/models/"
viewsDir       = "../app/views/"
[models]
metadata.adapter  = "Memory"

你可以阅读如下所示的文件:

You can read the file as follows:

<?php
use Phalcon\Config\Adapter\Ini as ConfigIni;
$config = new ConfigIni("path/config.ini");
echo $config->phalcon->controllersDir, "\n";
echo $config->database->username, "\n";
echo $config->models->metadata->adapter, "\n";

合并配置Merging Configurations

Phalcon\Config 允许合并配置对象到另一个:

Phalcon\Config can recursively merge the properties of one configuration object into another. New properties are added and existing properties are updated.

<?php
use Phalcon\Config;
$config = new Config(array(
    'database' => array(
        'host'   => 'localhost',
        'dbname' => 'test_db'
    ),
    'debug' => 1,
));
$config2 = new Config(array(
    'database' => array(
        'dbname' => 'production_db',
        'username' => 'scott',
        'password' => 'secret',
    ),
    'logging' => 1,
));
$config->merge($config2);
print_r($config);

上面的代码会产生以下内容:

The above code produces the following:

Phalcon\Config Object
(
    [database] => Phalcon\Config Object
        (
            [host] => localhost
            [dbname]   => production_db
            [username] => scott
            [password] => secret
        )
    [debug] => 1
    [logging] => 1
)

有更多的适配器可用于这个组件： Phalcon Incubator

There are more adapters available for this components in the Phalcon Incubator