# Zend_Config_Writer

`Zend_Config_Writer` lhe dá a capacidade de escrever arquivos de configuração a partir de objetos `Zend_Config`. Ele funciona com adaptadores separados do sistema e muito fáceis de usar. Por padrão, o `Zend_Config_Writer` vêm embarcado com quatro adaptadores, que são todos baseados em arquivos. Você instanciará um escritor com opções específicas, que podem ser filename e config. Em seguida, você irá chamar o método `write()` do escritor e o arquivo de configuração será criado. Você também pode fornecer `$filename` e `$config` diretamente ao método `write()`. Atualmente os escritores que se seguem são fornecidos com `Zend_Config_Writer`:

- `Zend_Config_Writer_Array`

- `Zend_Config_Writer_Ini`

- `Zend_Config_Writer_Json`

- `Zend_Config_Writer_Xml`

- `Zend_Config_Writer_Yaml`

Ao modificar ou criar um objeto `Zend_Config`, há algumas coisas que se deve conhecer. Para criar ou modificar um valor, basta definir o parâmetro do objeto `Zend_Config` através do assessor de parâmetro (->). Para criar uma seção na raiz ou para criar um ramo, você apenas irá criar uma nova matriz ("`$config->branch = array();`"). Para definir qual seção estende outra, você chamará o método `setExtend()` na raiz do objeto `Zend_Config`.

## Usando o Zend_Config_Writer

Este exemplo ilustra a utilização básica de `Zend_Config_Writer_Xml` para criar um novo arquivo de configuração:

    // Cria o objeto de configuração
    $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';

    // Escreve o arquivo de configuração em uma das seguintes formas:
    // 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);

Isso criará um arquivo de configuração XML com as seções de produção e de testes, onde testes estende produção.

## Modificando uma Configuração Existente

Este exemplo demonstra como editar um arquivo de configuração existente.

    // Carrega todas as seções de um arquivo de configuração
    // existente, enquanto pula o que é estendido.
    $config = new Zend_Config_Ini('config.ini',
                                  null,
                                  array('skipExtends'        => true,
                                        'allowModifications' => true));

    // Modifica um valor
    $config->production->hostname = 'foobar';

    // Escreve o arquivo de configuração
    $writer = new Zend_Config_Writer_Ini(array('config'   => $config,
                                               'filename' => 'config.ini'));
    $writer->write();

## Carregando um Arquivo de Configuração

Ao carregar um arquivo de configuração existente para modificações, é muito importante que se carregue todas as seções e que se pule tudo o que é estendido, para que valores não sejam fundidos. Isto é feito passando o skipExtends como opção para o construtor.

Para todos os escritores baseados em arquivo (INI, JSON, XML, YAML e Matriz PHP) internamente o `render()` é usado para construir a string de configuração. Este método pode ser usado de forma independente para acessar a string de representação dos dados de configuração.

## Notes specific to the INI writer

- The INI writer has two modes for rendering with regard to sections. By default the top-level configuration is always written into section names. By calling `$writer->setRenderWithoutSections();` all options are written into the global namespace of the INI file and no sections are applied.

- `Zend_Config_Writer_Ini` has an additional option parameter nestSeparator, which defines with which character the single nodes are separated. The default is a single dot, which is accepted by `Zend_Config_Ini` by default.

## Notes specific to the YAML writer

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.