PostgreSQL セッション保存ハンドラ

PHP関数リファレンス

PostgreSQL セッション保存ハンドラ

導入

注意: この拡張モジュールは Windows 環境では利用できません。
このモジュールは、» PostgreSQL をストレージとして使用する session モジュール用にセッション保存ハンドラを提供するものです。 ユーザレベルの セッション保存関数 - session_set_save_handler() を使用することも可能ですが、 このモジュールは C で書かれており、PHP で書いた保存ハンドラより約 2 倍 高速です。
PgSQL セッション保存ハンドラは あらゆる規模の Web サイトを対象に 設計されており、いくつかの進んだ機能を持っています。

セッションテーブルを自動的に作成します。

セッションテーブルの vacuum を自動的に行います。

効率的なガベージコレクションを行います。

複数の PostgreSQL サーバをサポートします。

データベースサーバの自動フェイルオーバー（スイッチング）を行います。

複数の PostgreSQL サーバを稼動させている場合、自動的に ロードバランシングが行われます。

UPDATE のショートカット機能を有します。

要件

すくなくとも PHP >= 4.3.0 、およびデータベースサーバとして PostgreSQL >=7.2.0 が必要です。また、PostgreSQL 7.2.0 以降の libpq（とそのヘッダファイル） および » libmm（とそのヘッダファイル） が必要です。

インストール手順

簡単なインストール手順

• tar.gz アーカイブを php4/ext に展開します （最新の正式リリースは、SourceForge の » PHP Form Extension Project にあります）。
• 新しいディレクトリを session_pgsql のように呼ぶと すると、それを session_pgsql という名前にする 必要があります（PHP モジュールとして構築する場合を除きます）。
• PHP 4 では ./buildconf を実行します。
• configure --with-session-pgsql （およびその他のオプション）を実行します。
• make; make install

実行時設定

php.ini の設定により動作が変化します。
PostgreSQL セッション保存ハンドラは、まだ開発中です。設定の詳細に ついては、配布物に含まれる README ファイルを参照して下さい。

テーブル定義

セッションテーブルの定義

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);

     

警告

HASH 形式の INDEX を使用する際は、 サーバの負荷が非常に高くなった際にデッドロックの 問題が発生することがあります。通常の操作ではデッドロックが起こることは まずありませんが、起こることもありえます。インデックスには HASH 形式を使用しないでください。

すべてのフィールドが定義されている限り、セッションテーブルを 変更することも可能です。
アプリケーション変数テーブルの定義

CREATE TABLE php_app_vars (
  app_modified       integer,
  app_name           text,
  app_vars           text
);

     

連絡先

現時点で、この拡張モジュールの開発者は、開発を継続する時間の余裕 はありません。将来的により多くの機能を実装する予定です。
コメント、バグ修整、拡張、またはこのモジュールの開発を援助したい 場合には » yohgaki@php.net までメールをください。いかなる援助も歓迎します。

目次

session_pgsql_add_error — エラーカウントを加算し、直近のエラーメッセージを設定する

session_pgsql_get_error — エラーの数および直近のエラーメッセージを返す

session_pgsql_get_field — カスタムフィールドの値を取得する

session_pgsql_reset — セッションデータベースサーバとの接続をリセットする

session_pgsql_set_field — カスタムフィールドの値を設定する

session_pgsql_status — 現在の保存ハンドラの状態を得る