archived-doc-ja/reference/session_pgsql/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.2 $ -->
<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready -->
<!-- Purpose: basic.session -->
<!-- Membership: pecl, external -->
<!-- Author: Yasuo Ohgaki <yohgaki@php.net> -->
<reference id="ref.session-pgsql">
 <title>PostgreSQL セッション保存ハンドラ</title>
 <titleabbrev>Session PgSQL</titleabbrev>

  <partintro>
   <section id="session-pgsql.intro">
    &reftitle.intro;
    &note.no-windows.extension;
    <para>
     このモジュールは、<ulink url="&url.pgsql;">PostgreSQL</ulink> PostgreSQL
     をストレージとして使用する <link linkend="ref.session">session</link>
     モジュール用にセッション保存ハンドラを提供するものです。
     <literal>user</literal> セッション保存ハンドラを使用することも可能ですが
     （<function>session_set_save_handler</function>）、
     このモジュールは C で書かれており、PHP で書いた保存ハンドラより約 2 倍
     高速です。
    </para>
    <para>
     PgSQL セッション保存ハンドラは あらゆる規模の Web サイトを対象に
     設計されており、いくつかの進んだ機能を持っています。
     <simplelist>
      <member>セッションテーブルを自動的に作成します。</member>
      <member>セッションテーブルの vacuum を自動的に行います。</member>
      <member>効率的なガベージコレクションを行います。</member>
      <member>複数の PostgreSQL サーバをサポートします。</member>
      <member>データベースサーバの自動フェイルオーバー（スイッチング）を行います。</member>
      <member>
       複数の PostgreSQL サーバを稼動させている場合、自動的に
       ロードバランシングが行われます。
      </member>
      <member>UPDATE のショートカット機能を有します。</member>
     </simplelist> 
    </para>
   </section>

   <section id="session-pgsql.requirements">
    &reftitle.required;
    <para>
     すくなくとも PHP &gt;= 4.3.0 、およびデータベースサーバとして 
     PostgreSQL &gt;=7.2.0 が必要です。また、PostgreSQL 7.2.0 以降の
     <literal>libpq</literal>（とそのヘッダファイル）
     および <ulink url="&url.mm;">libmm</ulink>（とそのヘッダファイル）
     が必要です。
    </para>
   </section>

   &reference.session-pgsql.configure;

   &reference.session-pgsql.ini;

   <section id="session-pgsql.tables">
    <title>テーブル定義</title>
    <para>セッションテーブルの定義
     <programlisting role="sql">
<![CDATA[
CREATE TABLE php_session (
  sess_id            text,
  sess_name          text,
  sess_data          text,
  sess_created       integer,
  sess_modified      integer,
  sess_expire        integer,
  sess_addr_created  text,
  sess_addr_modified text,
  sess_counter       integer,
  sess_error         integer,
  sess_warning       integer,
  sess_notice        integer,
  sess_err_message   text,
  sess_custom        text
);

CREATE INDEX php_session_idx ON php_session USING BTREE (sess_id);
]]>
     </programlisting>
    </para>
    <warning>
     <para>
      <literal>HASH</literal> 形式の <literal>INDEX</literal> を使用する際は、
      サーバの負荷が<emphasis>非常に</emphasis>高くなった際にデッドロックの
      問題が発生することがあります。通常の操作ではデッドロックが起こることは
      まずありませんが、起こることもありえます。<emphasis>インデックスには
      <literal>HASH</literal> 形式を使用しないでください</emphasis>。
     </para>
    </warning>
    <para>
     すべてのフィールドが定義されている限り、セッションテーブルを
     変更することも可能です。
    </para>
    <para>
     アプリケーション変数テーブルの定義
     <programlisting role="sql">
<![CDATA[
CREATE TABLE php_app_vars (
  app_modified       integer,
  app_name           text,
  app_vars           text
);
]]>
     </programlisting>
    </para>
   </section>


   <section id="session-pgsql.contact">
    <title>連絡先</title>
    <para>
     現時点で、この拡張モジュールの開発者は、開発を継続する時間の余裕
     はありません。将来的により多くの機能を実装する予定です。
    </para>
    <para>
     コメント、バグ修整、拡張、またはこのモジュールの開発を援助したい
     場合には <ulink url="mailto:yohgaki@php.net">yohgaki@php.net</ulink>
     までメールをください。いかなる援助も歓迎します。
    </para>
   </section>
  </partintro>

&reference.session-pgsql.functions;

 </reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->