リレーショナルデータベースでは、テーブル間の関連 (リレーション) が設定されています。 あるテーブル内のエンティティが、 データベーススキーマで定義されている参照整合性制約を使用して 他のエンティティとリンクしているのです。

Zend_Db_Table_Row クラスは、他のテーブルの 関連する行を問い合わせるためのメソッドを持っています。

この節では、テーブル間にいくつかの種類のリレーションが 設定されているデータベースを例として使用します。 このデータベースは、ソフトウェア開発プロジェクトでのバグを管理するものです。 以下の三つのテーブルから構成されています。

このサンプルデータベースの構造を表す SQL 擬似コードを次に示します。

CREATE TABLE accounts (
  account_id        PRIMARY KEY,
  name              VARCHAR
);

CREATE TABLE products (
  product_id        PRIMARY KEY,
  product_name      VARCHAR
);

CREATE TABLE bugs (
  bug_id            PRIMARY KEY,
  product_id        FOREIGN KEY REFERENCES products(product_id),
  reported_by       FOREIGN KEY REFERENCES accounts(account_id),
  assigned_to       FOREIGN KEY REFERENCES accounts(account_id),
  verified_by       FOREIGN KEY REFERENCES accounts(account_id),
  bug_description   VARCHAR,
  bug_status        VARCHAR
);
        

products テーブルは、 bugs テーブルとの間に一対多のリレーションがあります。 また accounts テーブルも、 bugs テーブルとの間に一対多のリレーションがあります。 したがって、products テーブルと accounts テーブルの間には 多対多のリレーションがあることになります。

また、注目すべき点として、bugs テーブルから accounts テーブルに対して複数の外部キーが設定されています。 個々の外部キーは、そのバグに対してそれぞれ別の accounts の行を指しています。

これらの三つのテーブルについて、 項9.4.2. 「テーブルクラスの定義」 で説明しているようにして 抽象クラス Zend_Db_Table_Abstract を継承したクラスを定義します。 各テーブルのクラス内で、リレーションを配列変数 protected $_referenceMap および protected $_dependentTables として宣言します。

以下に、これらのテーブルに対応する PHP クラス定義を示します。

<?php

class Accounts extends Zend_Db_Table_Abstract
{
    protected $_name            = 'accounts';
    protected $_primary         = array('account_id');
    protected $_dependentTables = array('Bugs');
}

class Products extends Zend_Db_Table_Abstract
{
    protected $_name            = 'products';
    protected $_primary         = array('product_id');
    protected $_dependentTables = array('Bugs');
}

class Bugs extends Zend_Db_Table_Abstract
{
    protected $_name            = 'bugs';
    protected $_referenceMap    = array(
        'Reporter' => array(
            'columns'           => 'reported_by',
            'refTableClass'     => 'Accounts',
            'refColumns'        => 'account_id'
        ),
        'Engineer' => array(
            'columns'           => 'assigned_to',
            'refTableClass'     => 'Accounts',
            'refColumns'        => 'account_id'
        ),
        'Verifier' => array(
            'columns'           => array('verified_by'),
            'refTableClass'     => 'Accounts',
            'refColumns'        => array('account_id')
        ),
        'Product' => array(
            'columns'           => array('product_id'),
            'refTableClass'     => 'Products',
            'refColumns'        => array('product_id')
        )
    );
}

?>
        

配列 $_dependentTables を、親テーブルで宣言し、 従属しているテーブルをそこで指定します。 SQL でのテーブル名ではなく、クラス名を使用するようにしましょう。

各従属テーブルのクラス内で、配列 $_referenceMap を宣言します。これは、参照の "ルール" を定義する連想配列となります。 参照ルールとは、リレーションの親テーブルが何になるのか、 従属テーブルのどのカラムと親テーブルのどのカラムが対応するのかを示すものです。

ルールのキーを、配列 $_referenceMap のインデックスとして使用します。 このルールのキーは、各リレーションを指定する際に使用します。 わかりやすい名前をつけるようにしましょう。 あとでご覧いただくように、PHP のメソッド名の一部を使用するとよいでしょう。

上のサンプル PHP コードでは、ルールのキーは 'Reporter'、 'Engineer'、 'Verifier' および 'Product' となります。

配列 $_referenceMap の各ルールエントリの内容もまた、連想配列です。 このルールエントリの内容について、以下で説明します。

親テーブルに対するクエリの結果を Row オブジェクトとして取得すれば、 その行を参照している従属テーブルの行を取得することができます。 使用するメソッドは、次のようになります。

$row->findDependentRowset($table, [$rule])

        

このメソッドは Zend_Db_Table_Rowset_Abstract オブジェクトを返します。 その中には、従属テーブル $table の行のうち、$row が指す行を参照しているものが含まれます。

最初の引数 $table には、 従属テーブルのクラス名を表す文字列を指定します。 文字列ではなく、テーブルクラスのオブジェクトで指定することもできます。

<?php

$accountsTable      = new Accounts();
$accountsRowset     = $accountsTable->find(1234);
$user1234           = $accountsRowset->current();

$bugsReportedByUser = $user1234->findDependentRowset('Bugs');

?>
            

二番目の引数 $rule はオプションです。 これは、従属テーブルクラスの配列 $_referenceMap でのルールのキーの名前を指定します。 ルールを指定しなかった場合は、配列の中で その親テーブルを参照している最初のルールを使用します。 最初のもの以外のルールを使用する必要がある場合は、 キーを指定しなければなりません。

上の例のコードでは、ルールのキーを指定していません。 したがって、親テーブルにマッチする最初のルールをデフォルトで使用します。 ここでは 'Reporter' がそれにあたります。

<?php

$accountsTable      = new Accounts();
$accountsRowset     = $accountsTable->find(1234);
$user1234           = $accountsRowset->current();

$bugsAssignedToUser = $user1234->findDependentRowset('Bugs', 'Engineer');

?>
            

別の方法として、"マジックメソッド" を使用して従属テーブルの行を問い合わせることもできます。 以下のパターンのいずれかに該当するメソッドを Row オブジェクトでコールすると、 Zend_Db_Table_Row_Abstract は findDependentRowset('<TableClass>', '<Rule>') メソッドを実行します。

上のパターンにおいて、<TableClass> および <Rule> は、それぞれ 従属テーブルのクラス名、親テーブルとの参照関係を表す 従属テーブルのルールのキーとなります

	注意
	他のアプリケーションフレームワーク、たとえば Ruby on Rails などでは、いわゆる "inflection (語尾変化)" という仕組みを採用しているものもあります。 これにより、使用する状況に応じて識別子のスペルを変更できるようになります。 あまり複雑にならないようにするため、 Zend_Db_Table_Row ではこの仕組みを提供していません。 メソッドのコール時に指定するテーブルの ID やルールのキーは、 クラス名やキー名と正確に一致しなければなりません。

<?php

$accountsTable    = new Accounts();
$accountsRowset   = $accountsTable->find(1234);
$user1234         = $accountsRowset->current();

// デフォルトの参照ルールを使用します
$bugsReportedBy   = $user1234->findBugs();

// 参照ルールを指定します
$bugsAssignedTo   = $user1234->findBugsByEngineer();

?>
            

従属テーブルに対するクエリの結果を Row オブジェクトとして取得すれば、 その従属行が参照している親テーブルの行を取得することができます。 使用するメソッドは、次のようになります。

$row->findParentRow($table, [$rule])

        

従属テーブルに対応する親テーブルの行は、常にひとつだけです。 したがって、このメソッドは Rowset オブジェクトではなく Row オブジェクトを返します。

最初の引数 $table には、 親テーブルのクラス名を表す文字列を指定します。 文字列ではなく、テーブルクラスのオブジェクトで指定することもできます。

<?php

$bugsTable         = new Bugs();
$bugsRowset        = $bugsTable->fetchAll('bug_status = ?', 'NEW');
$bug1              = $bugsRowset->current();

$reporter          = $bug1->findParentRow('Accounts');

?>
            

二番目の引数 $rule はオプションです。 これは、従属テーブルクラスの配列 $_referenceMap でのルールのキーの名前を指定します。 ルールを指定しなかった場合は、配列の中で その親テーブルを参照している最初のルールを使用します。 最初のもの以外のルールを使用する必要がある場合は、 キーを指定しなければなりません。

上の例のコードでは、ルールのキーを指定していません。 したがって、親テーブルにマッチする最初のルールをデフォルトで使用します。 ここでは 'Reporter' がそれにあたります。

<?php

$bugsTable         = new Bugs();
$bugsRowset        = $bugsTable->fetchAll('bug_status = ?', 'NEW');
$bug1              = $bugsRowset->current();

$engineer          = $bug1->findParentRow('Accounts', 'Engineer');

?>
            

別の方法として、"マジックメソッド" を使用して親テーブルの行を問い合わせることもできます。 以下のパターンのいずれかに該当するメソッドを Row オブジェクトでコールすると、 Zend_Db_Table_Row_Abstract は findParentRow('<TableClass>', '<Rule>') メソッドを実行します。

上のパターンにおいて、<TableClass> および <Rule>() は、それぞれ 親テーブルのクラス名、親テーブルとの参照関係を表す 従属テーブルのルールのキーとなります

	注意
	メソッドのコール時に指定するテーブルの ID やルールのキーは、 クラス名やキー名と正確に一致しなければなりません。

<?php

$bugsTable         = new Bugs();
$bugsRowset        = $bugsTable->fetchAll('bug_status = ?', 'NEW');
$bug1              = $bugsRowset->current();

// デフォルトの参照ルールを使用します
$reporter          = $bug1->findParentAccounts();

// 参照ルールを指定します
$engineer          = $bug1->findParentAccountsByEngineer();

?>
            

多対多のリレーションの片方のテーブル (この例では "元テーブル" と呼ぶことにします) に対するクエリの結果を Row オブジェクトとして取得すれば、もう一方のテーブル (この例では "対象テーブル" と呼ぶことにします) の対応する行を取得することができます。 使用するメソッドは、次のようになります。

$row->findManyToManyRowset($table, $intersectionTable, [$rule1, [$rule2]])

        

このメソッドは Zend_Db_Table_Rowset_Abstract オブジェクトを返します。 その中には、テーブル $table の行のうち、多対多のリレーションを満たすものが含まれます。 元テーブルの行 $row を使用して中間テーブルの行を探し、 さらにそれを対象テーブルと結合します。

最初の引数 $table には、 多対多のリレーションの対象テーブルのクラス名を表す文字列を指定します。 文字列ではなく、テーブルクラスのオブジェクトで指定することもできます。

二番目の引数 $intersectionTable には、 多対多のリレーションの中間テーブルのクラス名を表す文字列を指定します。 文字列ではなく、テーブルクラスのオブジェクトで指定することもできます。

<?php

$accountsTable    = new Accounts();
$accountsRowset   = $accountsTable->find(1234);
$user1234         = $accountsRowset->current();

$productsRowset   = $user1234->findManyToManyRowset('Products', 'Bugs');

?>
            

三番目と四番目の引数 $rule1 および $rule2 はオプションです。 これは、中間テーブルの配列 $_referenceMap でのルールのキーの名前を表す文字列です。

$rule1 は、中間テーブルから元テーブルへのリレーションを表す ルールのキーです。この例では、Bugs から Accounts へのリレーションがそれにあたります。

$rule2 は、中間テーブルから対象テーブルへのリレーションを表す ルールのキーです。この例では、Bugs から Products へのリレーションがそれにあたります。

親や従属行を取得するメソッドと同様、もしルールを指定しなければ、 配列 $_referenceMap の中でそのリレーションに該当する最初のルールを使用します。 最初のもの以外のルールを使用する必要がある場合は、 キーを指定しなければなりません。

上の例のコードでは、ルールのキーを指定していません。 したがって、マッチする最初のルールをデフォルトで使用します。 ここでは、$rule1 が 'Reporter'、 そして $rule2 が 'Product' になります。

<?php

$accountsTable    = new Accounts();
$accountsRowset   = $accountsTable->find(1234);
$user1234         = $accountsRowset->current();

$productsRowset   = $user1234->findManyToManyRowset('Products', 'Bugs', 'Engineer');

?>
            

別の方法として、"マジックメソッド" を使用して多対多のリレーションの対象テーブルの行を問い合わせることもできます。 以下のパターンのいずれかに該当するメソッドをコールすると、 Zend_Db_Table_Row_Abstract は findManyToManyRowset('<TableClass>', '<IntersectionTableClass>', '<Rule1>', '<Rule2>') メソッドを実行します。

上のパターンにおいて、<TableClass> および <IntersectionTableClass> は、それぞれ 対象テーブルのクラス名および中間テーブルのクラス名となります。 また <Rule1> および <Rule2> は、それぞれ中間テーブルから元テーブル、 週間テーブルから対象テーブルへの参照を表すルールのキーとなります。

	注意
	メソッドのコール時に指定するテーブルの ID やルールのキーは、 クラス名やキー名と正確に一致しなければなりません。

<?php

$accountsTable     = new Accounts();
$accountsRowset    = $accountsTable->find(1234);
$user1234          = $accountsRowset->current();

// デフォルトの参照ルールを使用します
$productsReporting = $user1234->findProductsViaBugs();

// 参照ルールを指定します
$productsFixing    = $user1234->findProductsViaBugsByEngineer();

?>
            

データベースでの DRI の宣言

Zend_Db_Table の連鎖操作を宣言するのは、 RDBMS が宣言参照整合性 (DRI) をサポートしていない場合 のみ を想定しています。 たとえば、MySQL の MyISAM ストレージエンジンや SQLite では DRI をサポートしていません。 このような場合は、Zend_Db_Table での連鎖操作の宣言が有用となるでしょう。 もし RDBMS が DRI の ON DELETE 句 および ON UPDATE 句を実装しているのなら、 データベーススキーマでそれを宣言すべきです。 Zend_Db_Table の連鎖機能を使ってはいけません。 RDBMS が実装する連鎖 DRI を使用したほうが、 データベースのパフォーマンスや一貫性、整合性の面で有利です。 もっとも重要なのは、RDBMS と Zend_Db_Table クラスの両方で同時に連鎖操作を宣言してはいけないということです。

親テーブルに対して UPDATE あるいは DELETE を行った際に、 従属テーブルに対して行う操作を指定することができます。

<?php

$productsTable  = new Products();
$productsRowset = $productsTable->find(1234);
$product1234    = $productsRowset->current();

$product1234->delete();
// 自動的に Bugs テーブルにも連鎖し、
// 従属する行が削除されます

?>
            

同様に、UPDATE で親テーブルの主キーの値を変更した場合は、 従属テーブルの外部キーの値も自動的に新しい値に更新したくなることでしょう。 これにより、その参照を最新の状態にすることができます。

シーケンスなどの機能を用いて主キーを生成している場合は、 通常はその値を変更する必要はありません。しかし、 自然キー を使用している場合は、 値が変わる可能性もあります。そのような場合は、 従属テーブルに対して連鎖更新を行う必要があるでしょう。

Zend_Db_Table で連鎖リレーションを宣言するには、 $_referenceMap の中でのルールを編集し、 連想配列のキー 'onDelete' および 'onUpdate' に文字列 'cascade' (あるいは定数 self::CASCADE) を設定します。 親テーブルから行が削除されたり主キーの値が更新されたりする前に、 その行を参照している従属テーブルの行が まず削除あるいは更新されます。

<?php

class Bugs extends Zend_Db_Table_Abstract
{
    ...
    protected $_referenceMap    = array(
        'Product' => array(
            'columns'           => array('product_id'),
            'refTableClass'     => 'Products',
            'refColumns'        => array('product_id'),
            'onDelete'          => self::CASCADE,
            'onUpdate'          => self::RESTRICT
        ),
        ...
    );
}

?>