PHP5

Указывайте таблицу, для которой определен этот класс, используя защищенную переменную $_name. Переменная должна содержать имя таблицы в том же виде, в котором она представлена в БД.

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

Если вы не определили имя таблицы, то по умолчанию оно равно имени класса. Если вы предпочитаете этот путь, то имя класса должно иметь то же написание, что и имя таблицы в БД.

<?php
 class bugs extends Zend_Db_Table_Abstract
{
    // имя таблицы соответствует имени класса
}

Вы можете также объявить схему таблицы в защищенной переменной $_schema или через добавленное перед именем таблицы имя схемы в свойстве $_name. Схема, указанная с помощью свойства $_name, имеет более высокий приоритет, чем схема, объявленная с помощью свойства $_schema. В некоторых СУРБД вместо термина "схема" используются термины "база данных" или "пространство таблиц", они используются аналогичным образом.

<?php

// Первый способ:
 class Bugs extends Zend_Db_Table_Abstract
{
    protected $_schema = 'bug_db';
    protected $_name   = 'bugs';
}

// Второй способ:
 class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name = 'bug_db.bugs';
}

// Если в обеих свойствах $_name м $_schema была объявлена схема,
// то указанная в $_name имеет больший приоритет:
 class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name   = 'bug_db.bugs';
    protected $_schema = 'ignored';
}

Схема и таблица могут быть указаны через конфигурационные директивы конструктора, которые замещают собой любые значения по умолчанию, определенные с помощью свойств $_name и $_schema. Спецификация схемы, данная через директиву name, замещает собой любое значение, переданное через опцию schema.

<?php
 class Bugs extends Zend_Db_Table_Abstract
{
}

// Первый способ:

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

// Второй способ:

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

// Если в обоих опциях 'name' и 'schema' была объявлена схема,
// то указанная в 'name' имеет больший приоритет:

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

Если вы не указали имя схемы, то по умолчанию это будет схема, к которой подключен ваш экземпляр адаптера БД.

Каждая таблица должна иметь первичный ключ. Вы можете объявить столбец для первичного ключа, используя защищенную переменную $_primary. Это может быть строка с именем одного столбца или массив имен столбцов, если первичный ключ является составным.

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

Если вы не задали первичный ключ, то Zend_Db_Table_Abstract пытается определить его, основываясь на данных, полученных через метод describeTable().

Когда создается экземпляр класса таблицы, конструктор вызывает ряд защищенных методов, инициализирующих метаданные для таблицы. Вы можете расширить любые из этих методов для того, чтобы явно определить эти метаданные. Помните, что в конце должен вызываться родительский метод.

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

Методы установки могут быть переопределены следующим образом:

Первым способом предоставления адаптера БД классу таблицы является передача объекта типа Zend_Db_Adapter_Abstract в массиве опций под ключом 'db'.

<?php

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

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

Вторым способом предоставления адаптера БД классу таблицы является декларирование объекта типа Zend_Db_Adapter_Abstract как используемого по умолчанию для всех экземпляров таблиц в вашем приложении. Вы можете делать это через статический метод Zend_Db_Table_Abstract::setDefaultAdapter(). Его аргументом является объект типа Zend_Db_Adapter_Abstract.

<?php

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

// Далее...

$table = new Bugs();

Может быть удобным создавать объект адаптера БД в центральной части вашего приложения - например, в загрузочном коде - и затем сохранять его как адаптер, используемый по умолчанию. Это дает возможность быть уверенным в том, что во всем приложении используется один и тот же экземпляр адаптера. Но установка адаптера, используемого по умолчанию, ограничена одним экземпляром адаптера.

Третий способ передачи адаптера БД классу таблицы - передача строки в массиве опций под ключом 'db'. Эта строка используется как ключ для статического экземпляра Zend_Registry, в котором под этим ключом должен храниться объект типа Zend_Db_Adapter_Abstract.

<?php

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

// Далее...

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

Как и в случае установки адаптера, используемого по умолчанию, это дает возможность быть уверенным в том, что во всем приложении используется один и тот же адаптер, но использование реестра является более гибким, т.к. вы можете хранить в нем более одного экземпляра адаптера. Экземпляр адаптера является индивидуальным для конкретной СУРБД и экземпляра БД. Если в вашем приложении необходимо подключаться к нескольким БД или даже различным СУРБД, то вам нужно использовать несколько адаптеров.

Автоинкрементный первичный ключ генерирует уникальное целочисленное значение, если вы опустите столбец для первичного ключа в своем операторе INSERT.

Если защищенная переменная в Zend_Db_Table_Abstract $_sequence имеет булево значение true, то класс предполагает, что таблица имеет автоинкрементный столбец.

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

    // Это значение по умолчанию присутствует в Zend_Db_Table_Abstract,
    // устанавливать его не обязательно
    protected $_sequence = true;
}

Примерами СУРБД, поддерживающих автоинкрементные первичные ключи являются MySQL, Microsoft SQL Server и SQLite.

PostgreSQL имеет нотацию SERIAL, которая неявно определяет последовательность, основанную на имени таблицы и столбца, и использует ее для генерации значений ключа при добавлении новых строк. IBM DB2 имеет нотацию IDENTITY которая работает аналогичным образом. Если вы используете одну из этих нотаций, то интерпретируйте свой класс Zend_Db_Table как имеющий автоинкрементный столбец, при этом члена $_sequence должен иметь значение true.

Последовательность (sequence) является объектом базы данных, генерирующим уникальные значения, которые могут использоваться как значения уникальных ключей в одной и более таблицах БД.

Если вы присвоили $_sequence строковое значение, то Zend_Db_Table_Abstract считает строку именем объекта последовательности в БД. Последовательность запускается для генерации нового значения, и это значение используется в операции INSERT.

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

    protected $_sequence = 'bug_sequence';
}

Примерами СУРБД, поддерживающих объекты последовательностей являются Oracle, PostgreSQL и IBM DB2.

PostgreSQL и IBM DB2 также имеют синтаксис, который неявно определяет последовательности и связывает их со столбцами. Если вы используете эту нотацию, то интерпретируйте таблицу как имеющую автоинкрементный ключевой столбец. Задавайте имя последовательности в виде строки только в тех случаях, когда вы собираетесь явно вызывать последовательности для получения следующего значения ключа.

Некоторые таблицы имеют естественные ключи. Это означает, что ключ не генерируется автоматически таблицей или последовательностью. В этом случае вы должны установить значение первичного ключа.

Если вы присвоили $_sequence булево значение false, то Zend_Db_Table_Abstract считает, что таблица имеет естественный первичный ключ. Вы должны предоставлять значения для столбцов первичного ключа в массиве данных для метода insert(), иначе метод бросает исключение Zend_Db_Table_Exception.

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

    protected $_sequence = false;
}

	Замечание
	Все СУРБД поддерживают таблицы с естественными ключами. Примеры таблиц, часто объявляемых как имеющие естественные ключи: справочные таблицы, таблицы пересечений в отношениях "многие-ко-многим", большинство таблиц с составными ключами.

По умолчанию методы класса таблицы возвращают наборы строк в экземплярах класса Zend_Db_Table_Rowset, и эти наборы строк содержат в себе коллекции экземпляров класса Zend_Db_Table_Row. Вы можете указать альтернативные классы, используемые вместо них, но они должны наследовать от классов Zend_Db_Table_Rowset_Abstract и Zend_Db_Table_Row_Abstract соответственно.

Вы можете указать классы строки и набора строк в массиве опций конструктора таблицы под ключами 'rowClass' и 'rowsetClass' соответственно. Задавайте имена классов в виде обычных строк.

<?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')

// Возвращает объект типа My_Rowset,
// содержащий массив объектов типа My_Row
$rows = $table->fetchAll($where);

Вы можете сменить используемые классы, указав их через методы setRowClass() и setRowsetClass(). Это применяется к создаваемым впоследствии строкам и наборам строк и не влияет на класс объектов строк и наборов строк, созданных ранее.

<?php

$table = new Bugs();

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

// Возвращает объект типа Zend_Db_Table_Rowset,
// содержащий массив объектов типа Zend_Db_Table_Row.
$rowsStandard = $table->fetchAll($where);

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

// Возвращает объект типа My_Rowset,
// содержащий массив объектов типа My_Row.
$rowsCustom = $table->fetchAll($where);

// Объект $rowsStandard по прежнему существует и не изменился.

За более подробной информацией о классах строки и набора строк см. Раздел 10.6, «Zend_Db_Table_Row» и Раздел 10.7, «Zend_Db_Table_Rowset».

Вы можете переопределить методы insert() в своем классе таблицы. Это дает возможность реализовать собственный код, который исполняется до того, как будет выполнена операция с БД. Всегда вызывайте метод родительского класса после своих действий.

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

    public function insert(array $data)
    {
        // добавление timestamp
        if (empty($data['created_on'])) {
            $data['created_on'] = time();
        }
        return parent::insert($data);
    }

    public function update(array $data, $where)
    {
        // добавление timestamp
        if (empty($data['updated_on'])) {
            $data['updated_on'] = time();
        }
        return parent::update($data, $where);
    }
}

Вы можете также переопределить метод delete().

Вы можете реализовать собственные методы запросов в своем классе таблицы, если приходится часто делать запросы к таблице с одними и теми же условиями. Большинство запросов могут быть написаны с использованием fetchAll(), но это требует написания повторяющегося кода для формирования условий запроса в том случае, если вам нужно выполнять запрос в нескольких местах вашего приложения. Поэтому будет удобным добавить метод в класс таблицы для выполнения часто используемых запросов к таблице.

<?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');
    }
}

Некоторые разработчики предпочитают, чтобы имя класса таблицы сопоставлялось с именем таблицы в СУРБД с применением преобразования, называемой инфлекцией.

Например, если имя вашего класса таблицы - "BugsProducts", то класс должен соответствовать физической таблице в БД с названием "bugs_products", если вы не произвели явное объявление свойства класса $_name. В данном преобразовании имя класса в формате "CamelCase" должно приводиться к нижнему регистру с разделением слов символом подчеркивания.

Вы можете указать имя таблицы БД независимо то имени класса, объявив его в свойстве $_name во всех классах этой таблицы.

Zend_Db_Table_Abstract не производит инфлекцию при получении имени таблицы. Если вы опустите объявление свойства $_name в своем классе таблицы, то класс будет соответствовать таблице в БД с точно таким же именем, как и у него.

Было бы неуместным использовать преобразование идентификаторов из БД, поскольку это может привести к неоднозначности или сделать некоторые идентификаторы недоступными. Использование SQL-идентификаторов в том виде, в котором они присутствуют в БД, делает Zend_Db_Table_Abstract проще и гибче в использовании.

Если вы предпочитаете использовать инфлекцию, то должны реализовать преобразование сами, переопределив метод _setupTableName() в своем классе таблицы. Одним из возможных способов является определение абстрактного класса, наследующего от Zend_Db_Table_Abstract, и объявление классов остальных таблиц как наследующих от этого нового класса.

<?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
{
}

?>

Реализация функций для произведения инфлекционного преобразования возлагается на разработчика. Zend Framework не предоставляет для этих целей готовых функций.