Zend_Application-AvailableResources-Session.xml 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 15103 -->
  3. <!-- Reviewed: no -->
  4. <sect2 id="zend.application.available-resources.session">
  5. <title>Zend_Application_Resource_Session</title>
  6. <para>
  7. <classname>Zend_Application_Resource_Session</classname> erlaubt es <classname>Zend_Session</classname> zu
  8. konfigurieren, sowie optional einen Session SaveHandler zu initialisieren.
  9. </para>
  10. <para>
  11. Um einen Session Save Handler zu setzen, muß einfach der Optionsschlüssel
  12. <code>saveHandler</code> (Groß-/Kleinschreibung beachten) an die Ressource übergeben
  13. werden. Der Wert dieser Option kann einer der folgenden sein:
  14. </para>
  15. <itemizedlist>
  16. <listitem><para>
  17. <code>string</code>: Ein String der eine Klasse benennt die
  18. <classname>Zend_Session_SaveHandler_Interface</classname> implementiert und initiiert werden
  19. soll.
  20. </para></listitem>
  21. <listitem><para>
  22. <code>array</code>: Ein Array mit den Schlüsseln "class", und optional "options", das
  23. eine Klasse benennt die <classname>Zend_Session_SaveHandler_Interface</classname> implementiert
  24. und iniiert werden, und ein Array von Optionen die an dessen Contructor übergeben
  25. werden soll.
  26. </para></listitem>
  27. <listitem><para>
  28. <classname>Zend_Session_SaveHandler_Interface</classname>: Ein Objekt das dieses Interface
  29. implementiert.
  30. </para></listitem>
  31. </itemizedlist>
  32. <para>
  33. Jeder andere übergebene Optionsschlüssel wird an <classname>Zend_Session::setOptions()</classname>
  34. übergeben um <classname>Zend_Session</classname> zu konfigurieren.
  35. </para>
  36. <example id="zend.application.available-resources.session.configExample">
  37. <title>Beispiel der Konfiguration einer Session Ressource</title>
  38. <para>
  39. Anbei ist das Beispiel eines INI Abschnitts der zeigt wie die Session Ressource
  40. konfiguriert werden kann. Er setzt verschiedene <classname>Zend_Session</classname> Optionen,
  41. und konfiguriert eine <classname>Zend_Session_SaveHandler_Db</classname> Instanz.
  42. </para>
  43. <programlisting role="ini"><![CDATA[
  44. resources.session.save_path = APPLICATION_PATH "/../data/session"
  45. resources.session.use_only_cookies = true
  46. resources.session.remember_me_seconds = 864000
  47. resources.session.saveHandler.class = "Zend_Session_SaveHandler_Db"
  48. resources.session.saveHandler.options.name = "session"
  49. resources.session.saveHandler.options.primary.session_id = "session_id"
  50. resources.session.saveHandler.options.primary.save_path = "save_path"
  51. resources.session.saveHandler.options.primary.name = "name"
  52. resources.session.saveHandler.options.primaryAssignment.sessionId = "sessionId"
  53. resources.session.saveHandler.options.primaryAssignment.sessionSavePath = "sessionSavePath"
  54. resources.session.saveHandler.options.primaryAssignment.sessionName = "sessionName"
  55. resources.session.saveHandler.options.modifiedColumn = "modified"
  56. resources.session.saveHandler.options.dataColumn = "session_data"
  57. resources.session.saveHandler.options.lifetimeColumn = "lifetime"
  58. ]]></programlisting>
  59. </example>
  60. </sect2>