Die Tabelle der Datenbank, für welche die Klasse bestimmt ist, wird mit der protected Variablen $_name angegeben. Es ist ein String, welcher den Namen der Tabelle enthalten muss, wie er in der Datenbank erscheint.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';
}

Wird keine Tabellenname angegeben, so wird ein Standard verwendet, welcher dem Namen der Klasse entspricht. Wird sich auf diesen Standard verlassen, so muss der Klassenname der Schreibweise der Tabelle entsprechen, wie sie in der Datenbank erscheint.

<?php

class bugs extends Zend_Db_Table_Abstract
{
    // Tabellenname entspricht dem Klassennamen
}

Es kann auch ein Schema für die Tabelle angegeben werden. Entweder mit der protected Variablen $_schema oder mit dem Schema vorangestellt in der $_name Eigenschaft. Jedes Schema welches in der $_name Eigenschatf angegeben ist wird vorrangig gegenüber dem Schema der $_schema Eigenschaft behandelt. In einigen RDBMS Marken ist die Bezeichnung für Schema "database" oder "tablespace", wird aber ähnlich verwendet.

<?php

// Erste Möglichkeit:

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_schema = 'bug_db';
    protected $_name   = 'bugs';
}

// Zweite Möglichkeit:

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bug_db.bugs';
}

// Wenn Schema sowohl in $_name als auch $_schema angegeben wird, so bekommt $_name vorrang:

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name   = 'bug_db.bugs';
    protected $_schema = 'ignored';
}

Die Schema und Tabellennamen können auch mit Konstruktor Konfigurationsdirektiven angegeben werden, welche jegliche Standardwerte, angegeben in den $_name und $_schema Eigenschaften, überschreiben. Eine Schema Angabe welche mit der name Directive angegeben wurde überschreibt jeglichen Wert welcher von der schema Option bereitgestellt ist.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
}

// Erste Möglichkeit:

$tableBugs = new Bugs(array('name' => 'bugs', 'schema' => 'bug_db'));

// Zweite Möglichkeit:

$tableBugs = new Bugs(array('name' => 'bug_db.bugs');

// Wenn Schema sowohl in $_name als auch $_schema angegeben wird, so bekommt $_name vorrang:

$tableBugs = new Bugs(array('name' => 'bug_db.bugs', 'schema' => 'ignored');

Wenn kein Schemaname angegeben wird, so wird als Standard der Schemaname des Datenbankadapters verwendet.

Jede Tabelle muss einen Primärschlüssel haben. Die Spalte des Primärschlüssels kann mit der protected Variablen $_primary angegeben werden. Sie enthält entweder einen String, welcher die einzelen Spalte benennt, oder ein Array von Spaltennamen, wenn der Primärschlüssel ein zusammengesetzter Schlüssel ist.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';
    protected $_primary = 'bug_id';
}

Wenn kein Primärschlüssel angegeben wird, versucht Zend_Db_Table_Abstract den Primärschlüssel mit Hilfe der describeTable() Methode zu ermitteln.

Hinweis: Jede Table Klasse muss wissen mit welche(r/n) Spalte(n) Zeilen eindeutig identifiziert werden können. Wenn keine Primärschlüssel Spalte(n) in der Klassendefinition oder als Argument für den Konstruktor angegeben wurde und nicht aus den Metadaten der Tabelle mit Hilfe der describeTable() Methode ermittelt werden kann, dann kann die Tabelle nicht mit Zend_Db_Table verwendet werden.

Wenn eine Instanz einer Table Klasse erzeugt wird, ruft der Konstruktor einige protected Methoden auf, die Metadaten der Tabelle initialisieren. Jede dieser Methoden kann erweitert werden um Metadaten explizit anzugeben. Dabei darf nicht vergessen werden am Ende der eigenen Methode die gleichnamige Methode der Parentklasse aufzurufen.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected function _setupTableName()
    {
        $this->_name = 'bugs';
        parent::_setupTableName();
    }
}

Folgende Setup Methoden sind überschreibbar:

• _setupDatabaseAdapter() überprüft ob ein Adapter bereitgestellt wird; nimmt einen Standardadapter aus der Registry, wenn benötigt. Durch das überschreiben dieser Methode kann ein Datenbankadapter aus einer anderen Quelle gesetzt werden.

• _setupTableName() setzt den standard Tabellennamen auf den Namen der Klasse. Durch das überschreiben dieser Methode kann der Tabellenname gesetzt werden bevor dieses Standardverhalten abläuft.

• _setupMetadata() setzt das Schema wenn der Tabellenname dem Muster "schema.table" entspricht; ruft describeTable() auf um Metadaten Informationen zu erhalten; Standardisiert das $_cols Array auf die Spalten wie von describeTable() geliefert. Durch das überschreiben dieser Methode können die Spalten angegeben werden.

• _setupPrimaryKey() standardisiert die Primärschlüssel Spalten zu denen geliefert von describeTable(); prüft ob die Primärschlüssel Spalten im $_cols Array enthalten sind. Durch das überschreiben dieser Methode können die Primärschlüssel Spalten angegeben werden.

Der erste Weg einen Datenbankadapter an eine Table Klasse bereitzustellen ist, ein Objekt des Typs Zend_Db_Adapter_Abstract im Options Array, bezeichnet mit dem Schlüssel 'db', zu übergeben.

<?php

$db = Zend_Db::factory('PDO_MYSQL', $options);

$table = new Bugs(array('db' => $db));

Der zweite Weg einer Table Klasse einen Datenbankadapter bereit zu stellen ist es, ein Objekt des Typs Zend_Db_Adapter_Abstract zu deklarieren und als Standard für alle nachfolgenden Instanzen von Table der Applikation zu setzen. Dies kann mit der static Methode Zend_Db_Table_Abstract::setDefaultAdapter() getan werden. Das Argument ist ein Objekt des Typs Zend_Db_Adapter_Abstract.

<?php

$db = Zend_Db::factory('PDO_MYSQL', $options);
Zend_Db_Table_Abstract::setDefaultAdapter($db);

// Später...

$table = new Bugs();

Es kann geeignet sein den Datenbankadapter an einer zentralen Stelle der Anwendung, wie dem Bootstrap, zu erzeugen, und als Standardadapter zu speichern. Dies hilft sicher zu stellen, das der verwendete Adapter in der gesamten Anwendung der gleiche ist. Allerdings kann nur eine einzelne Adapterinstanz als Standardadapter verwendet werden.

Der dritte Weg einer Table Klasse einen Datenbankadapter bereit zu stellen ist es einen String in dem Optionsarray zu übergeben, auch mit dem 'db' Schlüssel identifiziert. Der String wird als Schlüssel der statischen Zend_Registry Instanz verwendet, wo der Eintrag mit dem Schlüssel ein Objekt des Typs Zend_Db_Adapter_Abstract ist.

<?php

$db = Zend_Db::factory('PDO_MYSQL', $options);
Zend_Registry::set('my_db', $db);

// Später...

$table = new Bugs(array('db' => 'my_db'));

Wie das Setzen eines Standardadapters, bietet auch dieses sicher zu stellen das die gleiche Adapter Instanz in der gesamten Anwendung verwendet wird. Nutzen der Registry ist flexibler, da mehr als eine Adapterinstanz gepeichert werden kann. Eine angegebene Adapterinstanz ist spezifisch für eine bestimmte RDBMS Marke und Datenbankinstanz. Wenn die Anwendung Zugriff auf mehrere Datenbanken benötigt oder auch mehrere Datenbank Marken, dann müssen mehrere Adapter verwendet werden.

Ein automatischer Primärschlüssel erzeigt einen eindeutigen Integerwert wenn die Spalte des Primären Typs in der eigenen SQL INSERT Anweisung unterdrückt wird.

Wenn die geschützte Variable $_sequence, in Zend_Db_Table_Abstract, als boolscher Wert true definiert wird, nimmt die Klasse an das die Tabelle einen automatischen Primärschlüssel hat.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';

    // Das ist der Standardwert in der Zend_Db_Table_Abstract Klasse;
    // er muß nicht definiert werden.
    protected $_sequence = true;
}

MySQL, Microsoft SQL Server, und SQLite sind Beispiele von RDBMS Marken die automatische Primärschlüssel unterstützen.

PostgreSQL hat eine SERIAL Notation die implizit eine Sequenz definiert die auf den Tabellen- und Spaltennamen basiert, und diese Sequenz verwendet, um einen Schlüsselwert für neue Zeilen zu erstellen. IBM DB2 hat eine IDENTITY Notation die ähnlich arbeitet. Wenn eine dieser Notationen verwendet wird, muß der Zend_Db_Table Klasse mitgeteilt werden das Sie eine automatische Spalte hat, indem $_sequence auf true gesetzt wird.

Eine Sequenz ist ein Datenbank Objekt das einen eindeutigen Wert erstellt, der als Wert des Primärschlüssels in einer oder mehreren Tabellen der Datenbank verwendet werden kann.

Wenn $_sequence als String definiert wird, nimmt Zend_Db_Table_Abstract an das der String den Namen des Sequenz Objektes in der Datenbank benennt. Die Sequenz wird aufgerufen um einen neuen Wert zu erstellen, und dieser Wert wird in der INSERT Operation verwendet.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';

    protected $_sequence = 'bug_sequence';
}

Oracle, PostgreSQL, und IBM DB2 sind Beispiele von RDBMS Marken die Sequenz Objekte in der Datenbank unterstützen.

PostgreSQL und IBM DB2 haben auch einen Syntax der Sequenzen implizit definiert und diese mit Spalten assoziiert. Wenn diese Notation verwendet wird, muß der Tabelle gesagt werden das Sie eine automatische Schlüsselspalte besitzt. Der Name der Sequenz muß nur in den Fällen als String definiert werden in denen die Sequenz explizit aufgerufen wird um den nächsten Schlüsselwert zu erhalten.

Einige Tabellen haben natürliche Schlüssel. Das bedeutet das der Schlüssel nicht automatisch durch die Tabelle oder eine Sequenz erstellt wird. Der Wert für den Primärschlüssel muß in diesem Fall selbst definiert werden.

Wenn $_sequence als boolsches false definiert wird, nimmt Zend_Db_Table_Abstract an das die Tabelle einen natürlichen Primärschlüssel hat. Es müssen Werte für die Spalte des Primärschlüssels im Array der Daten definiert werden die an die insert() Methode übergeben werden, andernfalls wird diese Methode eine Zend_Db_Table_Exception werfen.

<?php

class BugStatus extends Zend_Db_Table_Abstract
{
    protected $_name = 'bug_status';

    protected $_sequence = false;
}

Hinweis: Alle RDBMS Marken unterstützen Tabellen mit natürlichen Schlüsseln. Beispiele von Tabellen die oft so definiert werden das Sie natürliche Schlüssel besitzen sind Lookup Tabellen, Durchschnitts Tabellen in viele-zu-viele Beziehungen, oder die meisten Tabellen mit komponierten Primärschlüsseln.

Standardmäßig geben die Methoden der Table Klasse ein Rowset als Instanzen der konkreten Klasse Zend_Db_Table_Rowset, und Rowsets enthalten eine Kollektion von Instanzen der konkreten Klasse Zend_Db_Table_Row. Eine alternative Klasse kann für jede von Ihnen als alternative Klasse definiert werden die verwendet werden soll, aber es müssen Klassen sein die Zend_Db_Table_Rowset_Abstract erweitern und respektiv Zend_Db_Table_Row_Abstract.

Es können Zeilen und Rowset Klassen definiert werden indem das Optionsarray des Table Konstruktors verwendet wird, respektiv die Schlüssel 'rowClass' und 'rowsetClass'. Die Namen der Klassen müssen spezifiziert werden indem Strings verwendet werden.

<?php

class My_Row extends Zend_Db_Table_Row_Abstract
{
    ...
}

class My_Rowset extends Zend_Db_Table_Rowset_Abstract
{
    ...
}

$table = new Bugs(
    array(
        'rowClass'    => 'My_Row',
        'rowsetClass' => 'My_Rowset'
    )
);

$where = $table->getAdapter()->quoteInto('bug_status = ?', 'NEW')

// Gibt ein Objekt des Typs My_Rowset zurück
// das ein Array von Objekten des Typs My_Row enthält.
$rows = $table->fetchAll($where);

Die klassen können geändert werden indem Sie mit den setRowClass() und setRowsetClass() Methoden spezifiziert werden. Das entspricht den Zeilen und Rowsets die nachfolgend erstellt werden; es ändert aber nicht die Klasse von Zeilen- oder Rowsetobjekten die bereits davor erstellt wurden.

<?php

$table = new Bugs();

$where = $table->getAdapter()->quoteInto('bug_status = ?', 'NEW')

// Gibt ein Objekt vom Typ Zend_Db_Table_Rowset zurück das ein Array
// von Objekten des Typs Zend_Db_Table_Row enthält.
$rowsStandard = $table->fetchAll($where);

$table->setRowClass('My_Row');
$table->setRowsetClass('My_Rowset');

// Gibt ein Objekt vom Typ My_Rowset zurück das ein Array
// von Objekten des Typs My_Row enthält.
$rowsCustom = $table->fetchAll($where);

// Das $rowsStandard Objekt existiert noch immer, und es bleibt unverändert.

Für weitere Informationen über Zeilen und Rowset Klassenm siehe Zend_Db_Table_Row und Zend_Db_Table_Rowset.

Die insert() und update() Methoden in der Table Klasse können überschrieben werden. Das bietet die Möglichkeit eigenen Code einzufügen der ausgeführt wird bevor die Datenbank Operation durchgeführt wird. Es muß sichergestellt werden das die Methode der Elternklasse aufgerufen wird wenn man fertig ist.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';

    public function insert(array $data)
    {
        // Einen Zeitstempel hinzufügen
        if (empty($data['created_on'])) {
            $data['created_on'] = time();
        }
        return parent::insert($data);
    }

    public function update(array $data, $where)
    {
        // Einen Zeitstempel hinzufügen
        if (empty($data['updated_on'])) {
            $data['updated_on'] = time();
        }
        return parent::update($data, $where);
    }
}

Auch die delete() Methode kann überschrieben werden.

Es können eigene Abfrage Methoden in der Table Klasse implementiert werden, wenn oft die Notwendigkeit besteht Abragen mit speziellen Kriterien auf der Table Klasse durchzuführen. Die meisten Abfragen können mit fetchAll() geschrieben werden, das bedeutet aber das Code dupliziert werden muß um Abfragekonditionen zu formen die Abfrage in verschiedenen Orten der Anwendung auszuführen. Hierfür kann es nützlich sein eine Methode in der Table Klasse zu definieren um oft benutzte Abfragen an dieser Tabelle durchzuführen.

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bugs';

    public function findByStatus($status)
    {
        $where = $this->getAdapter()->quoteInto('bug_status = ?', $status);
        return $this->fetchAll($where, 'bug_id');
    }
}

Einige Leute bevorzugen das der Name der Table Klasse einem Tabellennamen in der RDBMS, durch eine Stringumwandlung die Beugung (Inflection) genannt wird, entspricht.

Wenn zum Beispeil der Name der Table Klasse "BugsProducts" ist, würde Sie der physikalischen Tabelle in der Datenbank entsprechen die "bugs_products" heißt, wenn die explizite Definition der $_name Eigenschaft der Klasse unterdrückt wird. In dieser Übereinstimmung der Beugung, wird der Klassenname im "CamelCase" Format geschrieben und in Kleinschreibung transformiert, und Wörter mit einem Unterstrich seperiert.

Der Tabellenname der Datenbank kann unabhängig vom Klassennamen spezifiziert werden indem der Tabellenname mit der Klasseneigenschaft $_name in jeder der eigenen Tabellenklassen deklariert wird.

Zend_Db_Table_Abstract fürht keine Beugung durch um die Klassennamen mit den Tabellennamen in Übereinstimmung zu brigen. Wenn die Deklaration von $_name in der eigenen Tabellenklasse unterdrückt wird, wird die Klasse mit der Datenbanktabelle in Verbindung gebracht die der Schreibweise des Klassennamens exakt entspricht.

Es ist unzureichend Identifizierer von der Datenbank zu transformieren, da das zu Doppeldeutigkeiten führen kann oder einige Identifizierer sogar unerreichbar macht. Die Verwendung der SQL Identifizierer exakt so wie Sie in der Datenbank vorhanden sind, macht Zend_Db_Table_Abstract sowohl einfacher als auch flexibler.

Wenn man es vorzieht Beugung zu verwenden, muß die Transformation selbst durch das Überschreiben der _setupTableName() Methode in der eigenen Tabellenklasse implementiert werden. Ein Weg um das zu tun ist die Definition einer abstrakten Klase die Zend_Db_Table_Abstract erweitert. Der Rest der eigenen Klassen erweitert dann die eigene neue abstrakte Klasse.

<?php

abstract class MyAbstractTable extends Zend_Db_Table_Abstract
{
    protected function _setupTableName()
    {
        if (!$this->_name) {
            $this->_name = myCustomInflector(get_class($this));
        }
        parent::_setupTableName();
    }
}

class BugsProducts extends MyAbstractTable
{
}

Man ist selbst für das Schreiben von Funktionen verantwortlich um die Transformation der Beugung auszuführen. Der Zend Framework bietet solche Funktionen nicht an.