ZFResource^beta

導入部で説明したとおり、Zend_Auth_Adapter_DbTable のコンストラクタには Zend_Db_Adapter_Abstract のインスタンスを渡す必要があります。これは、認証アダプタのインスタンスと 関連付けるデータベース接続を表します。 まず、データベース接続を作成する必要があります。

次のコードは、メモリ内データベースのアダプタを作成し、 簡単なテーブルスキーマを作成し、そして後で認証クエリを実行するための行を追加します。 この例を実行するには、PDO SQLite 拡張モジュールが有効になっている必要があります。

<?php
// メモリ内で SQLite データベース接続を作成します
require_once 'Zend/Db/Adapter/Pdo/Sqlite.php';
$dbAdapter = new Zend_Db_Adapter_Pdo_Sqlite(array('dbname' => ':memory:'));

// 単純なテーブルを作成するクエリ
$sqlCreate = 'CREATE TABLE [users] ( '
           . '[id] INTEGER  NOT NULL PRIMARY KEY, '
           . '[username] VARCHAR(50) UNIQUE NOT NULL, '
           . '[password] VARCHAR(32) NULL, '
           . '[real_name] VARCHAR(150) NULL)';

// 認証情報テーブルを作成します
$dbAdapter->query($sqlCreate);

// 認証を成功させるために行を追加します
$sqlInsert = 'INSERT INTO users (username, password, real_name) '
           . 'VALUES ("my_username", "my_password", "My Real Name")';

// データを挿入します
$dbAdapter->query($sqlInsert);
                

データベース接続およびテーブルが使用可能となったので Zend_Auth_Adapter_DbTable のインスタンスが作成できます。 設定オプションの値は、コンストラクタで渡すか、 あるいはインスタンスを作成した後に設定用メソッドで指定します。

<?php
require_once 'Zend/Auth/Adapter/DbTable.php';

// コンストラクタにパラメータを渡し、インスタンスを設定します
$authAdapter = new Zend_Auth_Adapter_DbTable($dbAdapter, 'users', 'username', 'password');

// あるいは、設定用メソッドでインスタンスの設定を行います
$authAdapter = new Zend_Auth_Adapter_DbTable($dbAdapter);
$authAdapter->setTableName('users')
            ->setIdentityColumn('username')
            ->setCredentialColumn('password');
                

この時点で、認証アダプタのインスタンスは認証クエリを受け付ける準備ができました。 認証クエリを処理するには、入力された証明情報をアダプタに渡してから authenticate() メソッドをコールします。

<?php
// 入力情報 (ログインフォームからの値など) を設定します
$authAdapter->setIdentity('my_username')
            ->setCredential('my_password');

// 認証クエリを実行し、結果を保存します
$result = $authAdapter->authenticate();
                

認証結果オブジェクトでの getIdentity() メソッドに加え、Zend_Auth_Adapter_DbTable は認証の成功時にテーブルの行を取得する機能もサポートしています。

<?php
// ID を表示します
echo $result->getIdentity() . "\n\n";

// 結果の行を表示します
print_r($identity);

/* 出力結果
my_username

Array
(
    [id] => 1
    [username] => my_username
    [password] => my_password
    [real_name] => My Real Name
)
*/
                

テーブルの行には証明情報が含まれているので、 予期せぬアクセスからその内容を守ることが重要となります。