Zend_Session-SaveHandler-DbTable.xml 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- Reviewed: no -->
  3. <!-- EN-Revision: 15157 -->
  4. <sect1 id="zend.session.savehandler.dbtable">
  5. <title>Zend_Session_SaveHandler_DbTable</title>
  6. <para>
  7. Zend_Session_SaveHandler_DbTable の基本セットアップには、少なくとも
  8. 設定配列/Zend_Config オブジェクトの各設定を意味する 4 つのカラムが必要です。
  9. primary は主キーで、デフォルトは単なるセッション ID となります。
  10. デフォルトでは 32 桁の文字列です。
  11. modified は、最終更新日付を表す Unix タイムスタンプです。
  12. lifetime は、セッションの有効期間です (modified + lifetime > time())。
  13. そして data が、セッションに保存されているデータをシリアライズしたものです。
  14. </para>
  15. <example id="zend.session.savehandler.dbtable.basic">
  16. <title>基本的な設定</title>
  17. <programlisting role="SQL"><![CDATA[
  18. CREATE TABLE `session` (
  19. `id` char(32),
  20. `modified` int,
  21. `lifetime` int,
  22. `data` text,
  23. PRIMARY KEY (`id`)
  24. );
  25. ]]></programlisting>
  26. <programlisting role="php"><![CDATA[
  27. // データベース接続を準備します
  28. $db = Zend_Db::factory('Pdo_Mysql', array(
  29. 'host' =>'example.com',
  30. 'username' => 'dbuser',
  31. 'password' => '******',
  32. 'dbname' => 'dbname'
  33. ));
  34. // Zend_Db_Table のデフォルトアダプタを設定するか、DB 接続オブジェクトを
  35. // 保存ハンドラの $config に直接私増す
  36. Zend_Db_Table_Abstract::setDefaultAdapter($db);
  37. $config = array(
  38. 'name' => 'session',
  39. 'primary' => 'id',
  40. 'modifiedColumn' => 'modified',
  41. 'dataColumn' => 'data',
  42. 'lifetimeColumn' => 'lifetime'
  43. );
  44. // Zend_Session_SaveHandler_DbTable を作成し、それを
  45. // Zend_Session の保存ハンドラとして設定します
  46. Zend_Session::setSaveHandler(new Zend_Session_SaveHandler_DbTable($config));
  47. // セッション開始!
  48. Zend_Session::start();
  49. // これで、ふつうに Zend_Session を使えるようになります
  50. ]]></programlisting>
  51. </example>
  52. <para>
  53. Zend_Session_SaveHandler_DbTable で、複数カラムの主キーを使用することもできます。
  54. </para>
  55. <example id="zend.session.savehandler.dbtable.multi-column-key">
  56. <title>複数カラムの主キーの使用</title>
  57. <programlisting role="SQL"><![CDATA[
  58. CREATE TABLE `session` (
  59. `session_id` char(32) NOT NULL,
  60. `save_path` varchar(32) NOT NULL,
  61. `name` varchar(32) NOT NULL DEFAULT '',
  62. `modified` int,
  63. `lifetime` int,
  64. `session_data` text,
  65. PRIMARY KEY (`Session_ID`, `save_path`, `name`)
  66. );
  67. ]]></programlisting>
  68. <programlisting role="php"><![CDATA[
  69. // 先ほど同様にまず DB 接続を設定します
  70. // 注意: この設定は Zend_Db_Table にも渡されることに注意しましょう
  71. // テーブル固有の内容についてもここで設定することができます
  72. $config = array(
  73. 'name' => 'session', // Zend_Db_Table のテーブル名
  74. 'primary' => array(
  75. 'session_id', // PHP のセッション ID
  76. 'save_path', // session.save_path
  77. 'name', // セッション名
  78. ),
  79. 'primaryAssignment' => array(
  80. // 保存ハンドラに、どのカラムが主キーとなるのかを
  81. // 教えなければなりません。その順番が重要です。
  82. 'sessionId', // 主キーの最初のカラムはセッション ID
  83. 'sessionSavePath', // 主キーの 2 番目のカラムは保存パス
  84. 'sessionName', // 主キーの 3 番目のカラムはセッション名
  85. ),
  86. 'modifiedColumn' => 'modified', // セッションの有効期間
  87. 'dataColumn' => 'session_data', // シリアライズしたデータ
  88. 'lifetimeColumn' => 'lifetime', // 指定したレコードの生存期間
  89. );
  90. // Zend_Session に、この保存ハンドラを使うように通知します
  91. Zend_Session::setSaveHandler(new Zend_Session_SaveHandler_DbTable($config));
  92. // セッションを開始します
  93. Zend_Session::start();
  94. // ふつうに Zend_Session を使用します
  95. ]]></programlisting>
  96. </example>
  97. </sect1>
  98. <!--
  99. vim:se ts=4 sw=4 et:
  100. -->