# Zend_Config_Writer(日本語)

`Zend_Config_Writer` は、設定ファイルに `Zend_Config` オブジェクトを書き出します。 アダプタなしでも動作するので、使用するのも簡単です。 デフォルトでは `Zend_Config_Writer` には 4 種類のアダプタが同梱されており、全てファイル・ベースです。 まず、filename や config のオプションを指定してライターのインスタンスを作成します。 それからライターの `write()` メソッドをコールすると、 設定ファイルが作成されます。`$filename` や `$config` を、直接 `write()` メソッドで設定することもできます。現在は、次のライターが `Zend_Config_Writer` に同梱されています。

- `Zend_Config_Writer_Array`

- `Zend_Config_Writer_Ini`

- `Zend_Config_Writer_Json`

- `Zend_Config_Writer_Xml`

- `Zend_Config_Writer_Yaml`

`Zend_Config` オブジェクトを変更したり作成したりする際には、 知っておくべきことがあります。値を作成したり変更したりするには、 パラメータのアクセサ (->) で `Zend_Config` オブジェクトのパラメータを設定します。 ルート内のセクションやブランチを作成するには、新規配列を作成します ("`$config->branch = array();`")。 セクションの継承関係を定義するには、ルート `Zend_Config` オブジェクトの `setExtend()` メソッドをコールします。

## Zend_Config_Writer の使用法

この例では、`Zend_Config_Writer_Xml` で新しい設定ファイルを作成する方法を説明します。

    // config オブジェクトを作成します
    $config = new Zend_Config(array(), true);
    $config->production = array();
    $config->staging    = array();

    $config->setExtend('staging', 'production');

    $config->production->db = array();
    $config->production->db->hostname = 'localhost';
    $config->production->db->username = 'production';

    $config->staging->db = array();
    $config->staging->db->username = 'staging';

    // 次のいずれかの方法で設定ファイルを書き出します
    // a)
    $writer = new Zend_Config_Writer_Xml(array('config'   => $config,
                                               'filename' => 'config.xml'));
    $writer->write();

    // b)
    $writer = new Zend_Config_Writer_Xml();
    $writer->setConfig($config)
           ->setFilename('config.xml')
           ->write();

    // c)
    $writer = new Zend_Config_Writer_Xml();
    $writer->write('config.xml', $config);

これは、production と staging というセクションを持つ XML 設定ファイルを作成します。staging は production を継承しています。

## 既存の設定の変更

この例では、既存の設定ファイルを編集する方法を説明します。

    // すべてのセクションを既存の設定ファイルから読み込みますが継承は読み飛ばします
    $config = new Zend_Config_Ini('config.ini',
                                  null,
                                  array('skipExtends'        => true,
                                        'allowModifications' => true));

    // 値を変更します
    $config->production->hostname = 'foobar';

    // 設定ファイルを書き出します
    $writer = new Zend_Config_Writer_Ini(array('config'   => $config,
                                               'filename' => 'config.ini'));
    $writer->write();

## 設定ファイルの読み込み

既存の設定ファイルを読み込んで変更をする場合は、 すべてのセクションを読み込んで継承を読み飛ばすことが大切です。 そうすることで、値がマージされてしまうことがなくなります。 そのために、コンストラクタで skipExtends オプションを指定します。

構成節の文字列を作成するために、ファイル・ベースのライタ （ INI 、 JSON、XML、 YAML 及び PHP 配列） 全てで内部的に `render()` が使用されます。 コンフィギュレーション・データの文字列表現にアクセスするために このメソッドをそれぞれ使用できます。

## INI ライター特有の注意

- INI ライターでは、セクションについてのレンダリング用のモードが２つあります。 既定では、トップレベルの構成節は、常にセクション名に含まれます。 `$writer->setRenderWithoutSections()` を呼ぶことにより、 オプションの全てが INI ファイルのグローバル名前空間に含まれます。 そして、セクションは使用されません。

- `Zend_Config_Writer_Ini` にはオプションのパラメータ nestSeparator が用意されています。 これは、ノードを区切る文字を定義します。デフォルトはドットひとつで、 これは `Zend_Config_Ini` によりデフォルトで受け付けられます。

## YAML ライター特有の注意

The YAML writer lets you optionally specify an alternate YAML encoder to use. By default, one is shipped with the framework that is suitable for most configuration tasks. If you find it insufficient, or wish to use more advanced YAML, you may provide an alternate encoder callback.

The method for doing so is to use the `Zend_Config_Writer_Yaml::setYamlEncoder()` method, passing it a valid callback.

    // Use the Symfony Yaml Component:
    $writer = new Zend_Config_Writer_Yaml($filename);
    $writer->setYamlEncoder(array('sfYaml', 'dump'));

The above uses the Symfony Components' `sfYaml` component in order to encode the configuration to YAML.