CBL RememberMe

CBL RememberMe はPHPのセッション処理に「ログイン情報を記憶する(Remember me)」機能を追加する小さなライブラリです。
本ライブラリを使用することにより、Webアプリケーションに「ログイン情報を記憶する(Remember me)」を有効にしている間、$_SESSION の値を再利用することができるようになります。

  • 開発状況: ベータ
  • 対象者: 開発者
  • ライセンス: GNU Lesser General Public License (LGPL2.1以上)
  • プログラミング言語: JavaScript, PHP
  • トピック: CGI Tools/Libraries
  • 翻訳: 日本語、English
  • ユーザーインターフェース: Webベース

ダウンロード

設定

CBL RememberMe を使用するには、php.ini において session.cookie_lifetime (Cookieの寿命)の値を設定する必要があります。下記の例では1週間に設定しています。Cookieの寿命は session_set_cookie_params() をコールすることにより実行時に設定することもできます。

session.cookie_lifetime = 604800 # in php.ini, set expiration to 7 days

使用方法

2つのパラメータで RememberMe オブジェクトを構築します。使用する cookie の名前と「ログイン情報を記憶する(Remember Me)」機能のオン・オフの初期値がパラメータとなります。
「ログイン情報を記憶する(Remember Me)」機能をオン・オフするには、setRemember 関数を呼び出します。
セッション情報をクリアするとき(例えば、$_SESSION をリセットしたいとき)は、特別な値 $_SESSION['__cbl_rememberme'] を保存する必要があります。このためには clear 関数を呼びます。

/* construct the rememberme object */
$gRememberMe = new CBL_RememberMe('rememberme', true);

/* don't remember me */
$gRememberMe->setRemember(false);

/* remember me */
$gRememberMe->setRemember(true);

/* clear session info (replacement for $_SESSION = array()) */
$gRememberMe->clear();

関連情報

作者のブログにおいても、より詳細な情報を得ることができます。