documentation/manual/ja/module_specs/Zend_Application-AvailableResources-Session.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20763 -->
   4 <sect2 id="zend.application.available-resources.session">
   5     <title>Zend_Application_Resource_Session</title>
   6
   7     <para>
   8         <classname>Zend_Application_Resource_Session</classname>
   9         によって、任意にセッションSaveHandlerを初期化するだけでなく、
  10         <classname>Zend_Session</classname>を構成できます。
  11     </para>
  12
  13     <para>
  14         セッション保存ハンドラを配置するためには、
  15         単にリソースの<property>saveHandler</property>オプション・キーを渡してください。
  16         （大文字と小文字の区別をしません）
  17         このオプションの値は、以下のうちの1つでしょう:
  18     </para>
  19
  20     <itemizedlist>
  21         <listitem>
  22             <para>
  23                 <type>String</type>:
  24                 インスタンス化されるべき<classname>Zend_Session_SaveHandler_Interface</classname>を
  25                 実装するクラスを示す文字列
  26             </para>
  27         </listitem>
  28
  29         <listitem>
  30             <para>
  31                 <type>Array</type>:
  32                 インスタンス化されるべき<classname>Zend_Session_SaveHandler_Interface</classname>を実装しているクラスと
  33                 そのコンストラクタに与えるオプションの配列を示す、
  34                 "class" 及び、任意で "options"キーを持つ配列
  35             </para>
  36         </listitem>
  37
  38         <listitem>
  39             <para>
  40                 <classname>Zend_Session_SaveHandler_Interface</classname>:
  41                 このインターフェースを実装するオブジェクト
  42             </para>
  43         </listitem>
  44     </itemizedlist>
  45
  46     <para>
  47         渡されたオプション・キーはいずれも、
  48         <classname>Zend_Session</classname>を構成するために、<methodname>Zend_Session::setOptions()</methodname>に渡されます。
  49     </para>
  50
  51     <example id="zend.application.available-resources.session.configExample">
  52         <title>セッション・リソース構成サンプル</title>
  53
  54         <para>
  55             下記は、セッション・リソースを設定する方法を示す<acronym>INI</acronym>スニペット・サンプルです。
  56             <classname>Zend_Session_SaveHandler_DbTable</classname>インスタンスを構成するだけではなく、
  57             <classname>Zend_Session</classname>オプションをいくつか設定します。
  58         </para>
  59
  60         <programlisting language="ini"><![CDATA[
  61 resources.session.save_path = APPLICATION_PATH "/../data/session"
  62 resources.session.use_only_cookies = true
  63 resources.session.remember_me_seconds = 864000
  64 resources.session.saveHandler.class = "Zend_Session_SaveHandler_DbTable"
  65 resources.session.saveHandler.options.name = "session"
  66 resources.session.saveHandler.options.primary.session_id = "session_id"
  67 resources.session.saveHandler.options.primary.save_path = "save_path"
  68 resources.session.saveHandler.options.primary.name = "name"
  69 resources.session.saveHandler.options.primaryAssignment.sessionId = "sessionId"
  70 resources.session.saveHandler.options.primaryAssignment.sessionSavePath = "sessionSavePath"
  71 resources.session.saveHandler.options.primaryAssignment.sessionName = "sessionName"
  72 resources.session.saveHandler.options.modifiedColumn = "modified"
  73 resources.session.saveHandler.options.dataColumn = "session_data"
  74 resources.session.saveHandler.options.lifetimeColumn = "lifetime"
  75 ]]></programlisting>
  76     </example>
  77
  78     <note>
  79         <title>最初にデータベースを起動してください!</title>
  80
  81         <para>
  82             もし<classname>Zend_Session_SaveHandler_DbTable</classname>セッション保存ハンドラを構成しているなら、
  83             それが機能するためのデータベース接続を最初に構成しなければなりません。
  84             いずれでも、<link
  85                 linkend="zend.application.available-resources.db">Db</link>リソースを用いてこれを実行してください。
  86             "<property>resources.db</property>" キーが "<property>resources.session</property>" キーよりも優先されることを確認してください。
  87             あるいは、データベースを初期化するあなた自身のリソースを書くことによって。
  88             そして、特にデフォルト<classname>Zend_Db_Table</classname>アダプタを設定します。
  89         </para>
  90     </note>
  91 </sect2>