6.5. Zend_Db_Table_Row
前のページ | 第6章 Zend_Db | 次のページ

## 6.5. Zend_Db_Table_Row

### 6.5.1. 導入

Zend_Db_Table_Row は、Zend Framework の行データゲートウェイです。 一般に、Zend_Db_Table_Row のインスタンスを直接生成することはありません。 その代わりに、Zend_Db_Table::find() や Zend_Db_Table::fetchRow() の返す結果として Zend_Db_Table_Row を取得します。 取得した Zend_Db_Table_Row を用いてレコードの値を編集し (クラスのプロパティとして表されます)、 save() を使用して変更内容をもとのテーブルに反映させます。

### 6.5.2. 行の取得

最初に Zend_Db_Table クラスのインスタンスを作成します。

    <?php
    // アダプタを設定します
    require_once 'Zend/Db.php';
    $params = array (
        'host'     => '127.0.0.1',
        'username' => 'malory',
        'password' => '******',
        'dbname'   => 'camelot'
    );

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

    // すべての Zend_Db_Table オブジェクトに対するデフォルトアダプタを設定します
    require_once 'Zend/Db/Table.php';
    Zend_Db_Table::setDefaultAdapter($db);

    // データベースのテーブルに接続します
    class RoundTable extends Zend_Db_Table {}
    $table = new RoundTable();
    ?>

次に、Zend_Db_Table::find() に単一のキーを指定するか Zend_Db_Table::fetchRow() を使用して、データベースから 1 行のレコードを取得します。 返される結果は Zend_Db_Table_Row オブジェクトであり、 "underscore_words" 形式のカラム名を "camelCaps" 形式に変換したものが、そのオブジェクトのプロパティとなります。 例えば、テーブルのカラム "first_name" の内容が、 オブジェクトのプロパティ "firstName" に対応します。

    <?php
    // テーブルから、レコードを Zend_Db_Table_Row オブジェクトとして取得します
    $row = $table->fetchRow('first_name = "Robin"');

    //
    // $row は Zend_Db_Table_Row オブジェクトで、
    // テーブルのカラムに対応する public プロパティを持っています
    //
    // $row->id = '3'
    // $row->nobleTitle = 'Sir'
    // $row->firstName = 'Robin'
    // $row->favoriteColor = 'yellow'
    //

    ?>

### 6.5.3. 値の変更

行の値を変更するのは簡単です。単にオブジェクトのプロパティを変更すればよいのです。 変更した後に、save() を使用してその内容をテーブルに書き戻します。

    <?php
    // データベースのテーブルに接続します
    class RoundTable extends Zend_Db_Table {}
    $table = new RoundTable();

    // テーブルから、レコードを Zend_Db_Table_Row オブジェクトとして取得します
    $row = $table->fetchRow('first_name = "Robin"');

    //
    // $row は Zend_Db_Table_Row オブジェクトで、
    // テーブルのカラムに対応する public プロパティを持っています
    //
    // $row->id = '3'
    // $row->nobleTitle = 'Sir'
    // $row->firstName = 'Robin'
    // $row->favoriteColor = 'yellow'
    //
    // 「好きな色」を変更してテーブルに書き戻します
    $row->favoriteColor = 'blue';'
    $row->save();
    ?>

しかし、主キーの値を変更することはできません。変更しようとすると Zend_Db_Table_Row は例外をスローします。

    <?php
    // データベースのテーブルに接続します
    class RoundTable extends Zend_Db_Table {}
    $table = new RoundTable();

    // テーブルから、レコードを Zend_Db_Table_Row オブジェクトとして取得します
    $row = $table->fetchRow('first_name = "Robin"');

    // 主キーである "id" を変更できますか?
    try {
        $row->id = 5;
        echo "We should not see this message, as an exception was thrown.";
    } catch (Zend_Db_Table_RowException $e) {
        echo $e->getMessage();
    }
    ?>

前のページ | 上に戻る | 次のページ
6.4. Zend_Db_Table | ホーム | 6.6. Zend_Db_Table_Rowset