documentation/manual/es/module_specs/Zend_Application-AvailableResources-Frontcontroller.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2     <!-- EN-Revision: 20885 -->
   3     <!-- Reviewed: no -->
   4 <sect2 id="zend.application.available-resources.frontcontroller">
   5     <title>Zend_Application_Resource_Frontcontroller</title>
   6
   7     <para>
   8         Probablemente el recurso más común que se carga con
   9         <classname>Zend_Application</classname>
  10         será el recurso Front Controller
  11         , que proporciona la habilidad para configurar
  12         <classname>Zend_Controller_Front</classname>
  13         . Este recurso ofrece
  14         la posibilidad de establecer parámetros arbitrarios del Front
  15         Controller,
  16         especificar plugins para inicializar, y mucho más.
  17     </para>
  18
  19     <para>
  20         Una vez inicializado, el recurso asigna la propiedad del
  21         <varname>$frontController</varname>
  22         del bootstrap a la instancia
  23         <classname>Zend_Controller_Front</classname>
  24         .
  25     </para>
  26
  27     <para>
  28         Las claves de configuración disponibles incluyen las siguientes,
  29         sin importar si son
  30         mayúsculas ó minúsculas:
  31    </para>
  32
  33     <itemizedlist>
  34         <listitem>
  35             <para>
  36                 <emphasis>
  37                     <property>controllerDirectory</property>
  38                 </emphasis>
  39                 :: ya sea un valor de string
  40                 especificando un único directorio controlador, o un array de
  41                 pares de directorio módulo/controlador.
  42             </para>
  43         </listitem>
  44
  45         <listitem>
  46             <para>
  47                 <emphasis>
  48                     <property>moduleControllerDirectoryName</property>
  49                 </emphasis>
  50                 : un valor de string
  51                 indicando el subdirectorio bajo el cual un módulo contiene controladores.
  52             </para>
  53         </listitem>
  54
  55         <listitem>
  56             <para>
  57                 <emphasis>
  58                     <property>moduleDirectory</property>
  59                 </emphasis>
  60                 : directorio bajo el cual pueden
  61                 encontrarse los módulos.
  62             </para>
  63         </listitem>
  64
  65         <listitem>
  66             <para>
  67                 <emphasis>
  68                     <property>defaultControllerName</property>
  69                 </emphasis>
  70                 : Nombre base del controlador por
  71                 defecto (normalmente, "índex").
  72             </para>
  73         </listitem>
  74
  75         <listitem>
  76             <para>
  77                <emphasis><property>defaultAction</property></emphasis>
  78                 : nombre base de la acción por defecto
  79                 (normalmente, "índex").
  80             </para>
  81         </listitem>
  82
  83         <listitem>
  84             <para>
  85                 <emphasis>
  86                     <property>defaultModule</property>
  87                 </emphasis>
  88                 : nombre base del módulo por defecto
  89                 (normalmente, "default").
  90             </para>
  91         </listitem>
  92
  93         <listitem>
  94             <para>
  95                 <emphasis>
  96                     <property>baseUrl</property>
  97                 </emphasis>
  98                 : base explícita a la <acronym>URL</acronym> de la aplicación
  99                 (normalmente auto-detect).
 100             </para>
 101         </listitem>
 102
 103         <listitem>
 104             <para>
 105                 <emphasis>
 106                     <property>plugins</property>
 107                 </emphasis>
 108                 : array con los nombres de los plugins de las
 109                 clases de los Front Controllers.
 110                 El recurso instanciará a cada clase (sin argumentos al constructor)
 111                 y luego registra la instancia con el Front Controller. If you want to
 112                 register a plugin with a particular stack index, you need to provide an array with
 113                 two keys <property>class</property> and <property>stackIndex</property>.
 114
 115             </para>
 116         </listitem>
 117
 118         <listitem>
 119             <para>
 120                 <emphasis>
 121                     <property>params</property>
 122                 </emphasis>
 123                 : array de pares clave/valor para registrarse con
 124                 el front controller.
 125             </para>
 126         </listitem>
 127
 128                         <listitem>
 129             <para>
 130                 <emphasis><property>returnresponse</property></emphasis>: whether or not to return
 131                 the response object after dispatching the front controller. Value should be a
 132                 boolean; by default, this is disabled.
 133             </para>
 134         </listitem>
 135
 136     </itemizedlist>
 137
 138     <para>
 139         Si se ingresa una clave no reconocida, ésta será registrada como un
 140         parámetro de Front
 141         Controller pasándolo a
 142         <methodname>setParam()</methodname>
 143         .
 144     </para>
 145
 146     <example id="zend.application.available-resources.frontcontroller.configExample">
 147         <title>Ejemplo Front Controller resource configuration</title>
 148
 149         <para>
 150             A continuación,
 151             <acronym>INI</acronym>
 152             es un snippet para mostrar cómo configurar
 153             el recurso Front Controller.
 154         </para>
 155
 156         <programlisting language="ini"><![CDATA[
 157 [production]
 158 resources.frontController.controllerDirectory = APPLICATION_PATH . "/controllers"
 159 resources.frontController.moduleControllerDirectoryName = "actions"
 160 resources.frontController.moduleController = APPLICATION_PATH .  "/modules"
 161 resources.frontController.defaultControllerName = "site"
 162 resources.frontController.defaultAction = "home"
 163 resources.frontController.defaultModule = "static"
 164 resources.frontController.baseUrl = "/subdir"
 165 resources.frontController.plugins.foo = "My_Plugin_Foo"
 166 resources.frontController.plugins.bar = "My_Plugin_Bar"
 167 resources.frontController.plugins.baz.class = "My_Plugin_Baz"
 168 resources.frontController.plugins.baz.stackIndex = 123
 169 resources.frontController.returnresponse = 1
 170 resources.frontController.env = APPLICATION_ENV
 171 ]]></programlisting>
 172     </example>
 173     <example id="zend.application.available-resources.frontcontroller.frontControllerPropertyExample">
 174         <title>Recuperar el Front Controller de su arranque (bootstrap)</title>
 175         <para>
 176             Una vez que el recurso de su Front Controller ha sido inicializado,
 177             se puede recuperar la
 178             instancia de Front Controller a través de la
 179             propiedad
 180             <varname>$frontController</varname>
 181             de su bootstrap.
 182         </para>
 183
 184         <programlisting language="php"><![CDATA[
 185 $bootstrap->bootstrap('frontController');
 186 $front = $bootstrap->frontController;
 187 ]]></programlisting>
 188     </example>
 189 </sect2>