DB_common::autoExecute() (Previous) (Next) DB_common::commit()
View this page in Last updated: Sun, 17 Aug 2008
English | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Plain HTML

DB_common::autoPrepare()

DB_common::autoPrepare() --  指定した変数に基づいて、 INSERT 文あるいは UPDATE 文を準備する

概要

resource autoPrepare (string $table, array $table_fields, integer $mode = DB_AUTOQUERY_INSERT [, string $where = FALSE])

説明

SQL の INSERT 文あるいは UPDATE 文を自動的に組み立て、 execute() あるいは executeMultiple() で使用できるようにします。

パラメータ

string $table

テーブルの名前。

array $table_fields

フィールド名を含む配列。

これらのフィールドには ? プレースホルダが 割り当てられることに中いしましょう。そのため、 execute() で渡すデータは、現在の DBMS の 要求に応じて自動的にエスケープおよびクォートが行われます。

integer $mode

作成するクエリの型 (DB_AUTOQUERY_INSERT あるいは DB_AUTOQUERY_UPDATE)。

string $where

WHERE 句に使用する文字列。 $mode が DB_AUTOQUERY_UPDATE の場合にのみ使用されます。 この文字列は直接クエリに組み込まれます。そのため、DBMS の規約に 従ってリテラルのエスケープおよびクォートを行う必要があります。

返り値

resource - クエリのリソースハンドル、あるいは失敗した場合に DB_Error オブジェクトを返します。

例外・エラー

表 39-1PEAR_Error の値

エラーコードエラーメッセージ原因対応法
DB_ERROR_NEED_MORE_DATA insufficient data supplied フィールド名を含む配列が空です。 フィールド名の配列を調べ、修正します。
DB_ERROR_SYNTAX syntax error モードの指定が間違っています。 INSERT クエリ用の DB_AUTOQUERY_INSERT、あるいは UPDATE クエリ用の DB_AUTOQUERY_UPDATE のみが指定可能です。
DB_ERROR_NODBSELECTED no database selected データベースが選択されていません。 connect() の際の DSN を調べます。
その他のエラーコード  データベース固有のエラー。 PHP マニュアル のデータベース関連の部分を調べ、エラーの原因を判断してください。

注意

この関数は、スタティックにコールする ことはできません。

例

例 39-1insert モードでの autoPrepare() の使用法


<?php
// $db という名前の DB オブジェクトを取得しているとします...
$table_name   = 'user';
$table_fields = array('name', 'country');
$table_values = array('Zoe', 'France');

$sth = $db->autoPrepare($table_name, $table_fields,
                        DB_AUTOQUERY_INSERT);

if (PEAR::isError($sth)) {
    die($sth->getMessage());
}

$res =& $db->execute($sth, $table_values);

if (PEAR::isError($res)) {
    die($res->getMessage());
}
?>

例 39-2update モードでの autoPrepare() の使用法


<?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, "country = 'Japan'");

if (PEAR::isError($sth)) {
    die($sth->getMessage());
}

$res =& $db->execute($sth, $table_values);

if (PEAR::isError($res)) {
    die($res->getMessage());
}
?>

参照

"導入 - 準備と実行"、 "導入 - autoPrepare & autoExecute"、 prepare()、 execute()、 executeMultiple()、 autoExecute()

DB_common::autoExecute() (Previous) (Next) DB_common::commit()
Download Documentation Last updated: Sun, 17 Aug 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.