Zend_Db_Table_Row_Abstract にはアクセサがあり、 行のカラムをオブジェクトのプロパティとして参照できます。

$bugs = new Bugs();
$row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));

// bug_description カラムの値を出力します
echo $row->bug_description;
                

注意: 初期のバージョンの Zend_Db_Table_Row では、 これらのアクセサをデータベースのカラムと対応させる際に inflection (変形) と呼ばれる文字列変換を行っていました。
現在の Zend_Db_Table_Row では変形を実装していません。 使用するアクセサ名は、データベース内のカラム名と正確に一致します。

行のデータに対して配列としてアクセスするには、行オブジェクトの toArray() メソッドを使用します。 これは、カラム名とその値を関連付けた連想配列を返します。

$bugs = new Bugs();
$row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));

// 行オブジェクトから カラム名/値 の連想配列を取得します
$rowArray = $row->toArray();

// 通常の配列と同様に使用します
foreach ($rowArray as $column => $value) {
    echo "カラム: $column\n";
    echo "値:  $value\n";
}
                

toArray() が返す配列は、更新できません。 配列内の値を変更することは可能ですが、 それをデータベースに保存することはできません。

Zend_Db_Table_Row_Abstract クラスには、関連するテーブルから 行や行セットを取得するメソッドが存在します。 テーブルのリレーションについての詳細な情報は 導入 を参照ください。

個々のカラムの値をアクセサで設定する方法は、 カラムを読み込む場合と同様で、オブジェクトのプロパティを使用します。

カラムのアクセサによる値の設定は、アプリケーション内の行データのカラムの値は変更しますが、 それだけではまだデータベースにコミットされていません。コミットするには save() メソッドを使用します。

$bugs = new Bugs();
$row = $bugs->fetchRow($bugs->select()->where('bug_id = ?', 1));

// ひとつあるいは複数のカラムの値を変更します
$row->bug_status = 'FIXED';

// データベース内の行を、新しい値で UPDATE します
$row->save();
                

指定したテーブルに新しい行を作成するには、テーブルクラスの createRow() メソッドを使用します。 取得した行のフィールドに対してはオブジェクト指向のインターフェイスでアクセスできますが、 save() メソッドをコールするまでは 実際にデータベースの内容が変更されることはありません。

$bugs = new Bugs();
$newRow = $bugs->createRow();

// アプリケーションに応じて適切にカラムの値を設定します
$newRow->bug_description = '...説明...';
$newRow->bug_status = 'NEW';

// 新しい行をデータベースに INSERT します
$newRow->save();
                

createRow() メソッドのオプションの引数として、連想配列を渡すことができます。 この連想配列では、新しい行のフィールドに代入する値を指定します。

$data = array(
    'bug_description' => '...説明...',
    'bug_status'      => 'NEW'
);

$bugs = new Bugs();
$newRow = $bugs->createRow($data);

// 新しい行をデータベースに INSERT します
$newRow->save();
                

注意: Zend_Db_Table の初期のリリースでは、createRow() メソッドは fetchNew() という名前でした。 今後は新しい名前を用いることを推奨しますが、 過去との互換性を確保するため古い名前も使用できるようになっています。

Zend_Db_Table_Row_Abstract の setFromArray() メソッドを使用すると、 ひとつの行の複数のカラムを一度に設定することができます。 このメソッドには、カラム名と値を関連付けた連想配列を指定します。 このメソッドは、新しい行の値を設定する場合や 既存の行を更新する場合のどちらでも有用でしょう。

$bugs = new Bugs();
$newRow = $bugs->createRow();

// データを連想配列形式にします
$data = array(
    'bug_description' => '...説明...',
    'bug_status'      => 'NEW'
);

// すべてのカラムの値を一度に設定します
$newRow->setFromArray($data);

// 新しい行をデータベースに INSERT します
$newRow->save();
                

行オブジェクトで delete() メソッドをコールすることができます。 これは、その行オブジェクトの主キーに対応するデータベースの行を削除します。

$bugs = new Bugs();
$row = $bugs->fetchRow('bug_id = 1');

// この行を DELETE します
$row->delete();
                

変更を適用するのに save() をコールする必要はありません。 これは、データベースに対して即時に適用されます。

PHP の serialize() 関数を使用して、 行オブジェクトのバイトストリームを含む文字列を作成します。

$bugs = new Bugs();
$row = $bugs->fetchRow('bug_id = 1');

// オブジェクトをシリアライズします
$serializedRow = serialize($row);

// これで、$serializedRow をファイルなどに書き出すことができます
                </programlisting>

            </example>

        </sect3>

        <sect3 id="zend.db.table.row.serialize.unserializing">

            <title>シリアライズした行データの復元</title>

            <para>
                PHP の <code>unserialize()</code> 関数を使用して、
                オブジェクトのバイトストリームを含む文字列を復元します。
                この関数は、もとのオブジェクトを返します。
            </para>

            <para>
                返された行オブジェクトは、
                <emphasis>接続が切断された</emphasis> 状態であることに注意しましょう。
                行オブジェクトやそのプロパティを読み込むことはできますが、
                その値を変更することはできません。また、データベース接続を必要とするようなメソッド
                (たとえば従属テーブルに対するクエリなど) も実行できません。
            </para>

            <example id="zend.db.table.row.serialize.unserializing.example">

                <title>シリアライズした行の復元の例</title>

                <programlisting role="php"><![CDATA[
$rowClone = unserialize($serializedRow);

// これでオブジェクトのプロパティを使用できますが、読み込み専用です
echo $rowClone->bug_description;
                

注意: 復元した行は、なぜ切断された状態なのですか?
シリアライズしたオブジェクトは、可読形式の文字列となります。 データベースのアカウントやパスワードといった情報を 暗号化せずにプレーンテキストにシリアライズして保存すると、 セキュリティ上問題となります。 そのようなデータを無防備な状態でテキストファイルに保存したりしたくはないでしょう。 またメールなどで攻撃者に覗き見られることも好まないはずです。 シリアライズされたオブジェクトは、 正しい認証情報を知らない限りデータベースにアクセスすることはできません。

切断された行の接続を復活させるには、 setTable() メソッドを使用します。このメソッドへの引数としては、 Zend_Db_Table_Abstract 型のオブジェクトを作成して渡します。 テーブルオブジェクトを作成するには、データベースとの接続が必要です。 そのテーブルと行を関連付けることで、行がデータベースにアクセスできるようになります。 それ以降は、行オブジェクトの値を変更してデータベースに保存できるようになります。

$rowClone = unserialize($serializedRow);

$bugs = new Bugs();

// この行をテーブルに再接続し、
// データベースとの接続を復活させます
$rowClone->setTable($bugs);

// これで、行の内容を変更して保存することができます
$rowClone->bug_status = 'FIXED';
$rowClone->save();
                

行を作成する際にアプリケーション固有のロジックを初期化したい場合は、 その作業を init() メソッドに移動します。 このメソッドは、行のメタデータの処理がすべて終わった後にコールされます。 メタデータを変更するつもりがないのなら、 __construct メソッドを使うよりもこちらのほうを推奨します。

class MyApplicationRow extends Zend_Db_Table_Row_Abstract
{
    protected $_role;

    public function init()
    {
        $this->_role = new MyRoleClass();
    }
}
                    

行クラスは、INSERT や UPDATE、 DELETE の操作の前に、対応する protected メソッド _insert()、_update() および _delete() をコールします。 行クラスのサブクラスで、これらのメソッドに独自ロジックを追加することができます。

特定のテーブルに対して独自のロジックを必要とし、 それがそのテーブル上のすべての操作に対して発生するのなら、 その処理はテーブルクラスの insert()、update() および delete() で実装したほうがよいでしょう。 しかし、独自のロジックを行クラスで実装したほうがよい場合もあります。

独自ロジックの実装を テーブルクラスよりも行クラスで行ったほうがよい例を、 以下にいくつか示します。

class MyLoggingRow extends Zend_Db_Table_Row_Abstract
{
    protected function _insert()
    {
        $log = Zend_Registry::get('database_log');
        $log->info(Zend_Debug::dump($this->_data, "INSERT: $this->_tableClass", false));
    }
}

// $loggingEnabled はサンプルとして使用するプロパティで、
// これはアプリケーションの設定によって決まるものとします
if ($loggingEnabled) {
    $bugs = new Bugs(array('rowClass' => 'MyLoggingRow'));
} else {
    $bugs = new Bugs();
}
                

class MyLoggingRow extends Zend_Db_Table_Row_Abstract
{
    protected function _insert()
    {
        $log = Zend_Registry::get('database_log');
        $log->info(Zend_Debug::dump($this->_data, "INSERT: $this->_tableClass", false));
    }
}

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

class Products extends Zend_Db_Table_Abstract
{
    protected $_name = 'products';
    protected $_rowClass = 'MyLoggingRow';
}
                

テーブルのクラス名を RDBMS のテーブル名とあわせるために、 inflection (変形) と呼ばれる文字列変換を使用することを好む方もいます。

Zend_Db クラス群は、デフォルトでは変形をサポートしていません。 この方針については Zend_Db_Table における語尾変化の定義 で説明しています。

変形をさせたい場合は、変換処理を自前で実装する必要があります。そのためには、 独自の行クラスで _transformColumn() メソッドをオーバーライドし、 テーブルクラスでクエリを実行する際にその独自行クラスを使用します。

class MyInflectedRow extends Zend_Db_Table_Row_Abstract
{
    protected function _transformColumn($columnName)
    {
        $nativeColumnName = myCustomInflector($columnName);
        return $nativeColumnName;
    }
}

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

$bugs = new Bugs();
$row = $bugs->fetchNew();

// キャメルケース形式のカラム名を使用します。
// 変換関数により、これをデータベース内での実際の形式に
// 変換します。
$row->bugDescription = 'New description';
                

変換関数を書くのはあなたの役割です。 Zend Framework では、そのような関数は用意していません。