repo_zf1/documentation/manual/es/module_specs/Zend_Application-AvailableResources-Db.xml

<?xml version="1.0" encoding="UTF-8"?>
    <!-- EN-Revision: 24249 -->
    <!-- Reviewed: no -->
<sect2 id="zend.application.available-resources.db">
    <title>Zend_Application_Resource_Db</title>

    <para>
        <classname>Zend_Application_Resource_Db</classname>
        inicializará un adaptador
        <classname>Zend_Db</classname>
        basado en las opciones que se le pasen. Por defecto,
        también establece el adaptador por
        defecto para usarlo con
        <classname>Zend_Db_Table</classname>
        .
         <classname>Zend_Db_Table</classname>. If you want to use mutliple databases
        simultaneously, you can use the <link
        linkend="zend.application.available-resources.multidb">Multidb Resource
        Plugin</link>.
    </para>

    <para>Se reconocen las siguientes configuraciones claves:</para>

    <itemizedlist>
        <listitem>
            <para>
                <emphasis>
                    <property>adapter</property>
                </emphasis>
                : tipo de adaptador
                <classname>Zend_Db</classname>
                .
            </para>
        </listitem>

        <listitem>
            <para>
                <emphasis>
                    <property>params</property>
                </emphasis>
                : array asociativo de parámetros de configuración para utilizar al
                recuperar la
                instancia del adaptador.
            </para>
        </listitem>

        <listitem>
            <para>
                <emphasis>
                    <property>isDefaultTableAdapter</property>
                </emphasis>
                : Indica si establecer o no este adaptador como el adaptador de tablas
                por defecto.
            </para>
        </listitem>
        
             <listitem>
            <para>
                <emphasis><property>defaultMetadataCache</property></emphasis>: the name of the
                cache template or an instance of <classname>Zend_Cache_Core</classname> to use as
                metadata cache for <classname>Zend_Db_Table</classname>.
            </para>
        </listitem>
    </itemizedlist>

    <example id="zend.application.available-resources.db.configExample">
        <title>Muestra de la Configuracion de Recursos del Adaptador DB (Base de Datos) </title>
        <para>
            A continuación, un ejemplo de configuración
            <acronym>INI</acronym>
            que puede ser
            utilizada para iniciar el recurso DB.
        </para>

        <programlisting language="ini"><![CDATA[
[production]
resources.db.adapter = "pdo_mysql"
resources.db.params.host = "localhost"
resources.db.params.username = "webuser"
resources.db.params.password = "XXXXXXX"
resources.db.params.dbname = "test"
resources.db.isDefaultTableAdapter = true

; Optionally you can also the cache template to use for metadata caching:
resources.db.defaultMetadataCache = "database"
]]></programlisting>
    </example>

    <note>
        <title>Recuperando la Instancia del Adaptador</title>

        <para>Si decide no hacer la instanciación del adaptador con este recurso por defecto del
            adaptador de tabla, ¿cómo puede recuperar la instancia del adaptador?</para>

        <para>Como con cualquier recurso de plugin, se puede recuperar el recurso de plugin de DB
            desde su archivo de arranque:</para>

        <programlisting language="php"><![CDATA[
$resource = $bootstrap->getPluginResource('db');
]]></programlisting>

        <para>
            Una vez que tiene el recurso objeto, puede recuperar el adaptador de DB usando el
            método
            <methodname>getDbAdapter()</methodname>
            :
        </para>

        <programlisting language="php"><![CDATA[
$db = $resource->getDbAdapter();
]]></programlisting>
    </note>
</sect2>