Zend_Auth_Adapter_DbTable zapewnia możliwość przeprowadzenia uwierzytelniania w oparciu o dane przechowywane w tabeli bazy danych. Z tego względu, że klasa Zend_Auth_Adapter_DbTable wymaga przekazania instancji klasy Zend_Db_Adapter_Abstract do jej konstruktora, każda ta instancja jest powiązana z konkretnym połączeniem do bazy danych. Inne opcje konfiguracyjne mogą być ustawione za pomocą konstruktora lub za pomocą metod instancji, po jednej dla każdej z opcji.

Dostępne opcje konfiguracyjne to:

// Tworzymy połączenie do bazy danych SQLite przechowywanej w pamięci
$dbAdapter = new Zend_Db_Adapter_Pdo_Sqlite(array('dbname' =>
                                                  ':memory:'));

// Budujemy zapytanie tworzące prostą tabelę
$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)';

// Tworzymy tabelę z danymi uwierzytelniania
$dbAdapter->query($sqlCreate);

// Budujemy zapytanie wstawiające wiersz, dla którego możemy przeprowadzić
// próbę uwierzytelniania
$sqlInsert = "INSERT INTO users (username, password, real_name) "
           . "VALUES ('my_username', 'my_password', 'My Real Name')";

// Wstawiamy dane
$dbAdapter->query($sqlInsert);

// Konfigurujemy instancję za pomocą parametrów konstruktora
$authAdapter = new Zend_Auth_Adapter_DbTable(
    $dbAdapter,
    'users',
    'username',
    'password'
);

// ...lub konfigurujemy instancję za pomocą metod dostępowych
$authAdapter = new Zend_Auth_Adapter_DbTable($dbAdapter);
$authAdapter
    ->setTableName('users')
    ->setIdentityColumn('username')
    ->setCredentialColumn('password')
;

// Ustawiamy wartości danych uwierzytelniania (np., z formularza logowania)
$authAdapter
    ->setIdentity('my_username')
    ->setCredential('my_password');

// Przeprowadzamy zapytanie uwierzytelniające, zapisując rezultat
$result = $authAdapter->authenticate();

// Wyświetlamy tożsamość
echo $result->getIdentity() . "\n\n";

// Wyświetlamy wiersz rezultatów
print_r($authAdapter->getResultRowObject());

/* Wyświetlone dane:
my_username

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

Domyślnie Zend_Auth_Adapter_DbTable po udanym uwierzytelnieniu zwraca do obiektu uwierzytelniającego spowrotem tę samą tożsamość. W innym przykładzie użycia programista może chcieć przechować w stałym mechanizmie przechowywania Zend_Auth obiekt tożsamości zawierający inne użyteczne informacje. W takim przypadku może użyć metody getResultRowObject() aby zwrócić obiekt klasy stdClass. Poniższy kod ilustruje sposób jego użycia:

// uwierzytelniamy za pomocą Zend_Auth_Adapter_DbTable
$result = $this->_auth->authenticate($adapter);

if ($result->isValid()) {

    // przechowujemy tożsamość jako obiekt, w którym zwracane są jedynie
    // pola username oraz real_name
    $storage = $this->_auth->getStorage();
    $storage->write($adapter->getResultRowObject(array(
        'username',
        'real_name'
    )));

    // przechowujemy tożsamość jako obiekt, w którym kolumna zawierająca
    // hasło została pominięta
    $storage->write($adapter->getResultRowObject(
        null,
        'password'
    ));

    /* ... */

} else {

    /* ... */

}

O ile głównym przeznaczeniem komponentu Zend_Auth (i odpowiednio Zend_Auth_Adapter_DbTable) jest uwierzytelnianie a nie autoryzacja, jest kilka problemów które możemy rozwiązać odrobinę przekraczając pole zastosowań komponentu. Zależnie od tego jak zdecydujesz wyjaśnić swój problem, czasem może być przydatne rozwiązanie problemu autoryzacji podczas uwierzytelniania.

Komponent Zend_Auth_Adapter_DbTable posiada pewien wbudowany mechanizm, który może być użyty do dodania dodatkowych warunków podczas uwierzytelniania, dzięki czemu można rozwiązać niektóre problemy.

// Wartość pola "status" dla tego konta nie jest równa wartości "compromised"
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?) AND status != "compromised"'
);

// Wartość pola "active" dla tego konta jest równa wartości "TRUE"
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?) AND active = "TRUE"'
);

Innym przykładem może być implementacja mechanizmu saltingu. Jest to technika pozwalająca w znaczny sposób zwiększyć bezpieczeństwo aplikacji. Polega ona na tym, że dołączając do każdego hasła losowy łańcuch znaków spowodujemy, że niemożliwe będzie przeprowadzenie ataku brute force na bazę danych w oparciu o przygotowany słownik.

Zaczniemy od zmodyfikowania schematu tabeli bazy danych, aby móc przechowywać nasz łańcuch znaków salt:

$sqlAlter = "ALTER TABLE [users] "
          . "ADD COLUMN [password_salt] "
          . "AFTER [password]";

$dbAdapter->query($sqlAlter);

W prosty sposób wygenerujmy salt dla każdego rejestrującego się użytkownika:

for ($i = 0; $i < 50; $i++)
{
    $dynamicSalt .= chr(rand(33, 126));
}

I skonfigurujmy sterownik bazy danych:

$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    "MD5(CONCAT('"
    . Zend_Registry::get('staticSalt')
    . "', ?, password_salt))"
);

Innym sposobem jest użycie metody getDbSelect() klasy Zend_Auth_Adapter_DbTable po utworzeniu adaptera. Ta metoda zwróci obiekt klasy Zend_Db_Select, który ma być użyty do przeprowadzenia uwierzytalniania. Ważne jest, że ta metoda zawsze zwróci ten sam obiekt, niezależnie od tego czy metoda authenticate() została wywołana czy nie. Ten obiekt nie będzie posiadał żadnych informacji dotyczących nazwy tożsamości i hasła, ponieważ te dane będą umieszczone tam dopiero w czasie wywołania metody authenticate().

Przykładem sytuacji w której można by użyć metody getDbSelect() może być potrzeba sprawdzenia statusu użytkownika, czyli sprawdzenia czy konto użytkownika jest aktywne.

// Kontynuując poprzedni przykład 
$adapter = new Zend_Auth_Adapter_DbTable(
    $db,
    'users',
    'username',
    'password',
    'MD5(?)'
);

// pobieramy obiekt Zend_Db_Select (przez referencję)
$select = $adapter->getDbSelect();
$select->where('active = "TRUE"');

// uwierytelniamy, z warunkiem users.active = TRUE
$adapter->authenticate();