Zend_Application-AvailableResources-Session.xml 3.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17136 -->
  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> le permite
  8. configurar <classname>Zend_Session</classname> y opcionalmente
  9. inicializar una sesión SaveHandler.
  10. </para>
  11. <para>
  12. Para establecer un manejador de sesiones, simplemente pasar al recurso
  13. la clave opcional <property>saveHandler</property> (case insensible). El valor
  14. de esta opción puede ser uno de los siguientes:
  15. </para>
  16. <itemizedlist>
  17. <listitem><para>
  18. <type>String</type>: un string indicando una clase implementando
  19. <classname>Zend_Session_SaveHandler_Interface</classname> que
  20. debería ser instanciada.
  21. </para></listitem>
  22. <listitem><para>
  23. <type>Array</type>: un array con las claves "class" y,
  24. opcionalmente, "options", indicando la clase que implementa
  25. <classname>Zend_Session_SaveHandler_Interface</classname> que
  26. debería ser instanciada y una variedad de opciones para proporcionar
  27. a su constructor.
  28. </para></listitem>
  29. <listitem><para>
  30. <classname>Zend_Session_SaveHandler_Interface</classname>: un objeto
  31. implementando esta interfaz.
  32. </para></listitem>
  33. </itemizedlist>
  34. <para>
  35. Pasando cualquier otra opción de claves será pasado a
  36. <methodname>Zend_Session::setOptions()</methodname> para configurar
  37. <classname>Zend_Session</classname>.
  38. </para>
  39. <example id="zend.application.available-resources.session.configExample">
  40. <title>Configuración de recursos de la Sesión Ejemplo</title>
  41. <para>
  42. A continuación el snippet INI nos muestra cómo configurar el recurso
  43. para sesiones. Se establecen varias opciones
  44. <classname>Zend_Session</classname>, como también configura una
  45. instancia <classname>Zend_Session_SaveHandler_DbTable</classname>.
  46. </para>
  47. <programlisting language="ini"><![CDATA[
  48. resources.session.save_path = APPLICATION_PATH "/../data/session"
  49. resources.session.use_only_cookies = true
  50. resources.session.remember_me_seconds = 864000
  51. resources.session.saveHandler.class = "Zend_Session_SaveHandler_DbTable"
  52. resources.session.saveHandler.options.name = "session"
  53. resources.session.saveHandler.options.primary.session_id = "session_id"
  54. resources.session.saveHandler.options.primary.save_path = "save_path"
  55. resources.session.saveHandler.options.primary.name = "name"
  56. resources.session.saveHandler.options.primaryAssignment.sessionId = "sessionId"
  57. resources.session.saveHandler.options.primaryAssignment.sessionSavePath = "sessionSavePath"
  58. resources.session.saveHandler.options.primaryAssignment.sessionName = "sessionName"
  59. resources.session.saveHandler.options.modifiedColumn = "modified"
  60. resources.session.saveHandler.options.dataColumn = "session_data"
  61. resources.session.saveHandler.options.lifetimeColumn = "lifetime"
  62. ]]></programlisting>
  63. </example>
  64. <note>
  65. <title>Bootstrap your database first!</title>
  66. <para>
  67. If you are configuring the
  68. <classname>Zend_Session_SaveHandler_DbTable</classname> session save
  69. handler, you must first configure your database connection for it to
  70. work. Do this by either using the <link
  71. linkend="zend.application.available-resources.db">Db</link>
  72. resource -- and make sure the "<property>resources.db</property>" key comes prior to
  73. the "<property>resources.session</property>" key -- or by writing your own resource
  74. that initializes the database, and specifically sets the default
  75. <classname>Zend_Db_Table</classname> adapter.
  76. </para>
  77. </note>
  78. </sect2>