Manager モジュール

データベースの作成

例 39-3events_db データベースの作成および設定 <?php // MDB2 の準備 require_once 'MDB2.php'; $dsn = 'mysql://root:test@localhost'; // DB 名を省略していることに注意しましょう $mdb2 =& MDB2::factory($dsn); // Manager モジュールを読み込みます $mdb2->loadModule('Manager'); // データベースを作成します $mdb2->createDatabase('events_db'); // 新しいデータベースで作業するように設定します $mdb2->setDatabase('events_db'); // 次回以降の DSN は次のようになります // mysql://root:test@localhost/events_db ?>

テーブルの作成

データベースが作成できたので、こんどはそこにテーブルを追加していきましょう。 メソッド createTable() には三つのパラメータを指定します。 それぞれテーブル名、フィールド定義の配列および追加のオプション (任意。RDBMS 固有のもの) となります。

例 39-4events テーブルの作成 <?php $definition = array ( 'id' => array ( 'type' => 'integer', 'unsigned' => 1, 'notnull' => 1, 'default' => 0, ), 'name' => array ( 'type' => 'text', 'length' => 255 ), 'datetime' => array ( 'type' => 'timestamp' ) ); $mdb2->createTable('events', $definition); ?>

定義配列のキーは、テーブルのフィールド名となります。 その値は配列で、必須のキー 'type' と、 'type' の値にもとづいたその他のキーで構成されます。 'type' キーの値は、MDB2 のデータ型と同じものです。 データ型によって、その他のオプションは変化します。

<?php
$table_options = array(
    'comment' => 'Repository of people',
    'charset' => 'utf8',
    'collate' => 'utf8_unicode_ci',
    'type'    => 'innodb',
);
$definition = array (
    'id' => array (
        'type' => 'integer',
        'unsigned' => 1,
        'notnull' => 1,
        'default' => 0,
    ),
    'name' => array (
        'type' => 'text',
        'length' => 255
    )
);
$mdb2->createTable('people', $definition, $table_options);
?>

<?php
$definition = array (
    'event_id' => array (
        'type' => 'integer',
        'unsigned' => 1,
        'notnull' => 1,
        'default' => 0,
    ),
    'person_id' => array (
        'type' => 'integer',
        'unsigned' => 1,
        'notnull' => 1,
        'default' => 0,
    ),
);
$mdb2->createTable('event_participants', $definition, $table_options);
?>

制約の作成

サンプルデータベースのテーブルでは、id が主キーでなければなりません。 主キーを作成するために使用するのが createConstraint() メソッドです。このメソッドのパラメータは、テーブル名と 制約名、そして定義配列の三つです。

配列 definition の完全な構造は、このようになります (これは、外部キー制約を表すものです)。

<?php $definition = array ( 'primary' => false, 'unique' => false, 'foreign' => true, 'check' => false, 'fields' => array ( 'field1name' => array(), // ひとつのエントリがひとつのフィールドに対応します 'field2name' => array(), // フィールドの並び順とあわせます 'field3name' => array( 'sorting' => ascending|descending, 'position' => 3, ), ) 'references' => array( 'table' => name, 'fields' => array( 'field1name' => array( // ひとつのエントリがひとつの参照フィールドに対応します 'position' => 1, ), ) 'deferrable' => false, 'initiallydeferred' => false, 'onupdate' => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION, 'ondelete' => CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION, 'match' => SIMPLE|PARTIAL|FULL, ); ?>

例 39-7events テーブルおよび people テーブルの主キーの作成 <?php $definition = array ( 'primary' => true, 'fields' => array ( 'id' => array() ) ); $mdb2->createConstraint('events', 'keyname', $definition); $mdb2->createConstraint('people', 'keyname', $definition); ?>

注意: RDBMS によっては、制約名を無視するものもあります。たとえば MySQL では、主キーを作成する際には メソッドコール時に指定した keyname の値を使用せず、PRIMARY を使用します。 また、外部キーを作成する際にも メソッドコール時に指定した keyname の値を使用せず、[tablename]_ibfk_[n] を使用します。

定義配列では、制約にどのフィールドを含めるのかを fields キーで指定します。 定義配列で使用できるその他のキーは primary と unique でこれらは boolean 値となります。

別のキーを event_participants で作成してみましょう。 これは、各行が一意でなければならない、つまり、 ある人間がひとつのイベントには一度しか参加しないというものです。 定義配列の fields には両方のフィールドを指定し、 unique キーを true に設定します。

例 39-8unique 制約の作成 <?php $definition = array ( 'unique' => true, 'fields' => array ( 'event_id' => array(), 'person_id' => array(), ) ); $mdb2->createConstraint('event_participants', 'unique_participant', $definition); ?>

インデックスの作成

インデックスを作成するには createIndex() メソッドを使用します。このメソッドのシグネチャは createConstraint() と同じです。つまり、 テーブル名とインデックス名そして定義配列を指定します。 定義配列のキーはひとつ、fields で、 その値は連想配列となります。この連想配列には、 インデックスを構成するフィールドが含まれます。 フィールド情報は配列で指定し、そのキーは以下のようになります。

• sorting には ascending あるいは descending を指定します。

• length には整数値を指定します。

<?php
$definition = array(
    'fields' => array(
        'datetime' => array()
    )
);
$mdb2->createIndex('events', 'event_timestamp', $definition);
?>

シーケンスの作成

MDB2 がシーケンスを処理する方法については、 こちら を参照ください。今回のサンプルデータベースの events テーブルでは、 'id' を自動インクリメントさせる必要があります。そのために使用するメソッドが nextId() で、これはシーケンスの次の値を取得します。 nextId() は、もしシーケンステーブルがなければ作成します。 しかし、事前にそれを createSequence() で作成しておくこともできます。このメソッドには、シーケンス名のほかに オプションでシーケンスの開始値を指定します。

例 39-10シーケンスの作成 <?php $mdb2->createSequence('events'); $mdb2->createSequence('people', 1); ?>

デフォルトの MDB2 の設定では、上の例は 二つのテーブル events_seq および people_seq を作成します。 それぞれのテーブルについて、ひとつのフィールド 'sequence' が存在します。しかし、このフィールド名やテーブル名の最後の '_seq' は変更可能です。変更するには、MDB2 のオプション seqname_format および seqcol_name を使用します。