 導入 - 準備と実行 (Previous)
|
(Next) 導入 - 移植性
|
||||
| |
|||||
|
|||||
導入 - autoPrepare & autoExecute
Description
目的
autoPrepare() および autoExecute() を使用することで、あのうんざりするような INSERT 文や UPDATE 文を書く必要がなくなります。例えばテーブルにフィールドを 追加したような場合に、いちいち書き直す必要もなくなります。
3 つのフィールド (id、name そして country) を持つ 'user' というテーブルがあるとしましょう。 この場合、以下のような SQL クエリを書くことになるでしょう。
INSERT INTO table (id, name, country) VALUES (?, ?, ?) UPDATE table SET id=?, name=?, country=? WHERE ...
autoPrepare
autoPrepare() を使用すると、insert クエリや update クエリを書く必要がなくなります。例えば、
<?php
// $db という名前の DB オブジェクトを取得しているとします...
$table_name = 'user';
$table_fields = array('id', 'name', 'country');
$sth = $db->autoPrepare($table_name, $table_fields,
DB_AUTOQUERY_INSERT);
if (PEAR::isError($sth)) {
die($sth->getMessage());
}
?>
INSERT INTO user (id, name, country) VALUES (?, ?, ?)
レコードを追加するには、以下のようにして execute() あるいは executeMultiple() を使用する必要があります。
<?php
// ... 上の例の続きです...
$table_values = array(1, 'Fabien', 'France');
$res =& $db->execute($sth, $table_values);
if (PEAR::isError($res)) {
die($res->getMessage());
}
?>
<?php
// $db という名前の DB オブジェクトを取得しているとします...
$table_name = 'user';
$table_fields = array('name', 'country');
$table_values = array('Bob', 'USA');
$sth = $db->autoPrepare($table_name, $table_fields,
DB_AUTOQUERY_UPDATE, 'id = 1');
if (PEAR::isError($sth)) {
die($sth->getMessage());
}
$res =& $db->execute($sth, $table_values);
if (PEAR::isError($res)) {
die($res->getMessage());
}
?>
UPDATE user SET name=?, country=? WHERE id=1
何も WHERE 句を指定しなかった場合は、 テーブルのすべてのレコードが更新されてしまうことに注意しましょう。
autoExecute
insert クエリや update クエリを実行する一番簡単な方法は、 autoExecute() を使用することです。 これは autoPrepare() および execute() を組み合わせたものです。
必要なのは、フィールド名をキーとしてフィールドの値を対応させた 連想配列のみでず。例えばこのようになります。
<?php
// $db という名前の DB オブジェクトを取得しているとします...
$table_name = 'user';
$fields_values = array(
'id' => 1,
'name' => 'Fabien',
'country' => 'France'
);
$res = $db->autoExecute($table_name, $fields_values,
DB_AUTOQUERY_INSERT);
if (PEAR::isError($res)) {
die($res->getMessage());
}
?>
INSERT INTO user (id, name, country) VALUES (1, 'Fabien', 'France')
UPDATE クエリの場合も同様です。
<?php
// $db という名前の DB オブジェクトを取得しているとします...
$table_name = 'user';
$fields_values = array(
'name' => 'Fabien',
'country' => 'France'
);
$res = $db->autoExecute($table_name, $fields_values,
DB_AUTOQUERY_UPDATE, 'id = 1');
if (PEAR::isError($res)) {
die($res->getMessage());
}
?>
UPDATE user SET name='Fabien', country='France' WHERE id = 1
何も WHERE 句を指定しなかった場合は、 テーブルのすべてのレコードが更新されてしまうことに注意しましょう。
$data に渡す値は、リテラルである必要があります。 SQL 関数 (例えば CURDATE() など) を渡さないでください。 実行時に処理される SQL 関数は、プリペアドステートメント内に記述する 必要があります。
|
導入 - 準備と実行 (Previous)
|
(Next) 導入 - 移植性
|
||||||||
| |
|||||||||
|
|||||||||