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

<?xml version="1.0" encoding="UTF-8"?>
    <!-- EN-Revision: 17564 -->
    <!-- Reviewed: no -->
<sect1 id="zend.config.adapters.ini">
    <title>Zend_Config_Ini</title>
    <para>
        <classname>Zend_Config_Ini</classname>
        permite a los desarrolladores almacenar datos de configuración
        en un formato de datos
        <acronym>INI</acronym>
        familiar, y leer de ellos en la
        aplicación usando una sintáxis de propiedades de objetos
        anidados. El formato
        <acronym>INI</acronym>
        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 (
        "
        <emphasis>.</emphasis>
        "
        ). Una sección puede extender o heredar de otra sección
        indicando el nombre de la sección
        seguido de dos puntos (
        "
        <emphasis>:</emphasis>
        "
        ) y el nombre de la sección desde la cual se quieren heredar los
        datos.
    </para>
    <note>
        <title>parse_ini_file</title>
        <para>
            <classname>Zend_Config_Ini</classname>
            utiliza la función
            <ulink url="http://php.net/parse_ini_file">
                <methodname>parse_ini_file()</methodname>
            </ulink>
            de
            <acronym>PHP</acronym>
            . Por favor, revise esta documentación para observar
            sus comportamientos específicos, que
            se propagan a
            <classname>Zend_Config_Ini</classname>
            , tales como la forma en que los valores especiales:
            "
            <constant>TRUE</constant>
            "
            ,
            "
            <constant>FALSE</constant>
            "
            ,
            "yes"
            ,
            "no"
            , y
            <constant>NULL</constant>
            son manejados.
        </para>
    </note>
    <note>
        <title>Separador de clave</title>
        <para>
            Por defecto, el carácter separador de clave es el punto (
            "
            <emphasis>.</emphasis>
            "
            ). Puede ser reemplazado, no obstante,cambiando la clave de
            <varname>$options</varname>
            llamada
            <property>nestSeparator</property>
            al construir el objeto
            <classname>Zend_Config_Ini</classname>
            . Por ejemplo:
            <programlisting language="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
            <classname>Zend_Config_Ini</classname>
            para cargar datos de configuración de un archivo
            <acronym>INI</acronym>
            . 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
            <filename>/path/to/config.ini</filename>
            :
            :
        </para>
        <programlisting language="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
            <acronym>INI</acronym>
            . Resulta fácil cargar estos datos especificando
            el archivo
            <acronym>INI</acronym>
            en la sección de la etapa de pruebas:
        </para>
        <programlisting language="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>
                            <varname>$filename</varname>
                        </entry>
                        <entry>
                            El archivo
                            <acronym>INI</acronym>
                            que se va a cargar.
                        </entry>
                    </row>
                    <row>
                        <entry>
                            <varname>$section</varname>
                        </entry>
                        <entry>
                            La [sección] contenida en el archivo
                            <acronym>INI</acronym>
                            que
                            se va a cargar. Fijar este parámetro a
                            <constant>NULL</constant>
                            cargará todas las secciones.
                            Alternativamente, se puede introducir un
                            array de nombres de sección para cargar
                            multiples secciones.
                        </entry>
                    </row>
                    <row>

                        <entry>
                            <varname>$options</varname>
                            (default
                            <constant>FALSE</constant>
                            )
                        </entry>

                        <entry>
                            Array de opciones. Las siguientes claves
                            están aceptadas:
                            <itemizedlist>
                                <listitem>
                                    <para>
                                        <emphasis>
                                            <property>allowModifications</property>
                                        </emphasis>
                                        :
                                        : Fijar a
                                        <constant>TRUE</constant>
                                        para permitir modificaciones
                                        subsiguientes del archivo
                                        cargado. Por defecto es
                                        <constant>NULL</constant>
                                    </para>
                                </listitem>
                                <listitem>
                                    <para>
                                        <emphasis>
                                            <property>nestSeparator</property>
                                        </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:
-->