Zend_Controller-Router-Route-Static.xml 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 16180 -->
  3. <!-- Reviewed: no -->
  4. <sect3 id="zend.controller.router.routes.static">
  5. <title>Zend_Controller_Router_Route_Static</title>
  6. <para>
  7. Die oben angeführten Beispiele verwenden alle dynamische Routen -- Routen die einem Pattern
  8. entsprechen. Trotzdem wird manchmal eine spezielle Route in Stein gegossen, und das Starten
  9. der Regular Expression Maschine wäre ein Overkill. Die Lösung zu dieser Situation ist die
  10. Verwendung von statischen Routen:
  11. </para>
  12. <programlisting language="php"><![CDATA[
  13. $route = new Zend_Controller_Router_Route_Static(
  14. 'login',
  15. array('controller' => 'auth', 'action' => 'login')
  16. );
  17. $router->addRoute('login', $route);
  18. ]]></programlisting>
  19. <para>
  20. Die obige Route passt zu einer URL von <filename>http://domain.com/login</filename>, und
  21. leitet weiter zu <filename>AuthController::loginAction()</filename>.
  22. </para>
  23. <note id="zend.controller.router.routes.static.warning">
  24. <title>Warnung: Statische Routen müssen vernüftige Standards enthalten</title>
  25. <para>
  26. Da eine statische Route keinen Teil der URL an das Requestobjekt als Parameter übergibt,
  27. <emphasis>muss</emphasis> man alle Parameter die für das Bearbeiten eines Requests
  28. notwendig sind als Standards an die Route übergeben. Das unterdrücken der Standardwerte
  29. von "controller" oder "action" kann zu unerwarteten Ergebnissen führen, und wird dazu
  30. führen das der Request nicht bearbeitet werden kann.
  31. </para>
  32. <para>
  33. Als Daumenregel sollte man immer jeden der folgenden Standardwerte anbieten:
  34. </para>
  35. <itemizedlist>
  36. <listitem><para>controller</para></listitem>
  37. <listitem><para>action</para></listitem>
  38. <listitem><para>module (if not default)</para></listitem>
  39. </itemizedlist>
  40. <para>
  41. Optional kann auch der "useDefaultControllerAlways" Parameter an den Frontcontroller
  42. wärend des Bootstrappings übergeben werden:
  43. </para>
  44. <programlisting language="php"><![CDATA[
  45. $front->setParam('useDefaultControllerAlways', true);
  46. ]]></programlisting>
  47. <para>
  48. Trotzdem ist das als Workaround anzusehen; es ist immer besser vernünftige Standards
  49. explizit zu definieren.
  50. </para>
  51. </note>
  52. </sect3>
  53. <!--
  54. vim:se ts=4 sw=4 et:
  55. -->