例 9.69. 行からカラムを読み込む例

<?php

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

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

?>

例 9.70. toArray() メソッドの使用例

<?php

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

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

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

?>

例 9.71. 行のカラムの内容を変更する例

<?php

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

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

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

?>

例 9.72. テーブルに新しい行を作成する例

<?php

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

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

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

?>

例 9.73. テーブルに新しい行を作成し、値を代入する例

<?php

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

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

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

?>

例 9.74. setFromArray() で新しい行の値を設定する例

<?php

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

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

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

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

?>

例 9.75. 行の削除の例

<?php

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

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

?>

例 9.76. 行のシリアライズの例

<?php

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

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

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

?>

例 9.77. シリアライズした行の復元の例

<?php

$rowClone = unserialize($serializedRow);

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

?>

例 9.78. 行の復活の例

<?php

$rowClone = unserialize($serializedRow);

$bugs = new Bugs();

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

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

?>

例 9.80. 行クラスでの独自ロジックの例

独自ロジックが、そのテーブルのすべての操作に適用されるとは限りません。 状況に応じて独自ロジックを適用するには、 そのロジックを行クラスで実装し、 その行クラスを指定してテーブルクラスのインスタンスを作成します。 指定しなければ、テーブルクラスはデフォルトの行クラスを使用します。

このテーブルでは、データに対する操作内容を Zend_Log オブジェクトに記録する必要があります。 ただし、それはアプリケーションの設定でログ記録を有効にしている場合のみとします。

<?php

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();
}

?>

例 9.81. 挿入するデータの記録を複数のテーブルで行う行クラスの例

複数のテーブルで、共通の独自ロジックを使用することもあるでしょう。 同じロジックをすべてのテーブルクラスで実装するのではなく、 その場合はその動作を行クラスで定義しましょう。 そして各テーブルでその行クラスを使用するのです。

この例では、ログ記録用のコードは全テーブルクラスで同一です。

<?php

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

?>

例 9.82. 変換処理の定義例

これにより、カラム名を変形させたものでアクセスできるようになります。 行クラスの _transformColumn() メソッドを使用して、データベースのテーブル内のカラム名を変更しています。

<?php

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';

?>