documentation/manual/es/module_specs/Zend_Controller-Router-Route-Static.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2     <!-- EN-Revision: 17592 -->
   3     <!-- Reviewed: no -->
   4 <sect3 id="zend.controller.router.routes.static">
   5     <title>Zend_Controller_Router_Route_Static</title>
   6
   7     <para>Los ejemplos sobre todo usan rutas dinámicas -- rutas que contienen
   8         patrones contra los
   9         cuales comparar. A veces, sin embargo, una ruta en
  10         particular pareciera estar seteada en
  11         piedra, y ejecutar el motor de
  12         expresiones regulares sería excesivo. La respuesta a esta
  13         situación es
  14         utilizar rutas estáticas:</para>
  15
  16     <programlisting language="php"><![CDATA[
  17 $route = new Zend_Controller_Router_Route_Static(
  18     'login',
  19     array('controller' => 'auth', 'action' => 'login')
  20 );
  21 $router->addRoute('login', $route);
  22 ]]></programlisting>
  23
  24     <para>
  25         La ruta anterior se comparará con una
  26         <acronym>URL</acronym>
  27         de
  28         <filename>http://domain.com/login</filename>
  29         , y hará un dispatch a
  30         <methodname>AuthController::loginAction()</methodname>
  31         .
  32     </para>
  33
  34     <note id="zend.controller.router.routes.static.warning">
  35         <title>Advertencia: Las Rutas Estáticas Deben Contener Defaults
  36             Sanos</title>
  37
  38         <para>
  39             Dado que una ruta estática no pasa ninguna parte de la
  40             <acronym>URL</acronym>
  41             del objeto solicitud, como ser los
  42             parámetros, usted
  43             <emphasis>debe</emphasis>
  44             pasar todos los
  45             parámetros necesarios para enviar una solicitud a la ruta como si
  46             fuera
  47             por defecto. Omitiendo los valores por defecto de "controller"
  48             o "action" tendrá
  49             resultados inesperados, y probablemente el
  50             resultado de la solicitud no sea ejecutable.
  51         </para>
  52
  53         <para>Como regla general, siempre proporcione cada uno de los
  54             siguientes valores por defecto:</para>
  55
  56         <itemizedlist>
  57             <listitem>
  58                 <para>controller</para>
  59             </listitem>
  60             <listitem>
  61                 <para>action</para>
  62             </listitem>
  63             <listitem>
  64                 <para>module (si ya no está por defecto)</para>
  65             </listitem>
  66         </itemizedlist>
  67
  68         <para>Opcionalmente, también puede pasar el parámetro
  69             "useDefaultControllerAlways" al front
  70             controller durante el
  71             bootstrapping:</para>
  72
  73         <programlisting language="php"><![CDATA[
  74 $front->setParam('useDefaultControllerAlways', true);
  75 ]]></programlisting>
  76
  77         <para>Sin embargo, esto es considerado un rodeo; siempre es mejor
  78             definir explícitamente
  79             valores correctos o sanos por defecto.
  80        </para>
  81     </note>
  82 </sect3>