repo_zf1/documentation/manual/es/module_specs/Zend_Config_Ini.xml

<sect1 id="zend.config.adapters.ini">
    <title>Zend_Config_Ini</title>
    <para>
        <code>Zend_Config_Ini</code>
        permite a los desarrolladores almacenar datos de configuración
        en un formato de datos INI familiar, y leer de ellos en la
        aplicación usando una sintáxis de propiedades de objetos
        anidados. El formato INI se especializa en proveer tanto la
        habilidad de mantener una jerarquía de claves de datos (data
        keys) de configuración como la de mantener una jerarquía entre
        secciones de datos de configuración. Las jerarquías de datos de
        configuración son provistas separando las claves mediante el
        carácter punto (
        <code>.</code>
        ). Una sección puede extender o heredar de otra sección
        indicando el nombre de la sección seguido de dos puntos (
        <code>:</code>
        ) y el nombre de la sección desde la cual se quieren heredar los
        datos.
    </para>
    <note>
        <title>parse_ini_file</title>
        <para>
            <code>Zend_Config_Ini</code>
            utiliza la función
            <ulink url="http://php.net/parse_ini_file">
                <code>parse_ini_file()</code>
            </ulink>
            de PHP. Por favor, revise esta documentación para observar
            sus comportamientos específicos, que se propagan a
            <code>Zend_Config_Ini</code>
            , tales como la forma en que los valores especiales:
            <code>true</code>
            ,
            <code>false</code>
            ,
            <code>yes</code>
            ,
            <code>no</code>
            , y
            <code>null</code>
            son manejados.
        </para>
    </note>
    <note>
        <title>Separador de clave</title>
        <para>
            Por defecto, el carácter separador de clave es el punto (
            <code>.</code>
            ). Puede ser reemplazado, no obstante,cambiando la clave de
            <code>$options</code>
            llamada
            <code>'nestSeparator'</code>
            al construir el objeto
            <code>Zend_Config_Ini</code>
            . Por ejemplo:
            <programlisting role="php"><![CDATA[
$options['nestSeparator'] = ':';
$config = new Zend_Config_Ini('/path/to/config.ini',
                              'pruebas',
                              $options);
]]>
            </programlisting>
        </para>
    </note>
    <example id="zend.config.adapters.ini.example.using">
        <title>Utilizando Zend_Config_Ini</title>
        <para>
            Este ejemplo muestra una forma de uso básica de
            <code>Zend_Config_Ini</code>
            para cargar datos de configuración de un archivo INI. En
            este ejemplo hay datos de configuración tanto para un
            sistema de producción como para un sistema en fase de
            pruebas. Debido a que los datos de la fase de pruebas son
            muy parecidos a los de producción, la sección de pruebas
            hereda de la sección de producción. En este caso, la
            decisión es arbitraria y podría haberse escrito a la
            inversa, con la sección de producción heredando de la
            sección de pruebas, a pesar de que éste no sería el caso
            para situaciones más complejas. Supongamos, entonces, que
            los siguientes datos de configuración están contenidos en
            <code>/path/to/config.ini</code>
            :
        </para>
        <programlisting role="ini"><![CDATA[
; Datos de configuración de la web de producción
[produccion]
webhost                  = www.example.com
database.adapter         = pdo_mysql
database.params.host     = db.example.com
database.params.username = dbuser
database.params.password = secret
database.params.dbname   = dbname

; Los datos de configuración de la fase de pruebas heredan de la producción
; y sobreescribren valores si es necesario
[pruebas : produccion]
database.params.host     = dev.example.com
database.params.username = devuser
database.params.password = devsecret
]]>
        </programlisting>
        <para>
            Ahora, asuma que el desarrollador de aplicaciones necesita
            los datos de configuración de la etapa de pruebas del
            archivo INI. Resulta fácil cargar estos datos especificando
            el archivo INI en la sección de la etapa de pruebas:
        </para>
        <programlisting role="php"><![CDATA[
$config = new Zend_Config_Ini('/path/to/config.ini', 'pruebas');

echo $config->database->params->host;   // muestra "dev.example.com"
echo $config->database->params->dbname; // muestra "dbname"
]]>
        </programlisting>
    </example>
    <note>
        <table id="zend.config.adapters.ini.table">
            <title>Parámetros del constructor Zend_Config_Ini</title>
            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Parámetros</entry>
                        <entry>Notas</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>
                            <code>$filename</code>
                        </entry>
                        <entry>
                            El archivo INI que se va a cargar.
                        </entry>
                    </row>
                    <row>
                        <entry>
                            <code>$section</code>
                        </entry>
                        <entry>
                            La [sección] contenida en el archivo ini que
                            se va a cargar. Fijar este parámetro a null
                            cargará todas las secciones.
                            Alternativamente, se puede introducir un
                            array de nombres de sección para cargar
                            multiples secciones.
                        </entry>
                    </row>
                    <row>
                        <entry>
                            <code>$options = false</code>
                        </entry>
                        <entry>
                            Array de opciones. Las siguientes claves
                            están aceptadas:
                            <itemizedlist>
                                <listitem>
                                    <para>
                                        <emphasis>
                                            allowModifications
                                        </emphasis>
                                        : Fijar a
                                        <emphasis>true</emphasis>
                                        para permitir modificaciones
                                        subsiguientes del archivo
                                        cargado. Por defecto es
                                        <emphasis>false</emphasis>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <emphasis>
                                            nestSeparator
                                        </emphasis>
                                        : Carácter que utilizar como
                                        separador de anidamiento. Por
                                        defecto es "."
                                    </para>
                                </listitem>
                            </itemizedlist>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </note>
</sect1>
<!--
    vim:se ts=4 sw=4 et:
-->