3C.5　非SELECT文の実行

### 非select文の実行
$res =& $db->query($sql);
if(PEAR::isError($res)){ /* エラー処理 */ }

　例題( SQLフォーム ) では全ての非SELECT文を query() メソッドで処理しています。 単一の非SELECT文に対しては query() メソッドが最も使い勝手が良いです。

mixed &
DB_common::query
( string $query
[, mixed $data = array()])

　query() メソッドは単一のSQL文を実行しますが、原理的に一対の prepare()/execute() メソッドと同じ動作をします。 例えば上例は、次のように変えても原理的には同じです。（但し、エラー処理やリソースの開放などの処理が加わります）

$sth = $db->prepare($sql);
$res =& $db->execute($sth);

resource
DB_common::prepare
( string $query )

mixed &
DB_common::execute
( resource $stmt
[,mixed $data = array()])

　prepare文をネイティブにサポートしているデータベースの場合、 repare() メソッドを実行するとSQL文がコンパイルされます。 従って、繰り返しexecute()するような場合、SQL文を高速に処理できます。

プレースホルダ

　例えば、以下のSQL文を見て下さい。

UPDATE syain SET bumon_no=? WHERE syain_name=?
SELECT * FROM  syain WHERE syain_name = ?

上例の ? をプレースホルダ ( またはワイルドカード ) と呼びます。 prepare()/execute() が最も効率よく働くのはSQL文にプレースホルダを使用している場合です。 なぜなら、プリペアド文は繰り返し execute() で実行することができるからです。 しかもその都度異なった値をプレースホルダ に与えることができるので非常に効率のよいやり方です。

$sth = $db->prepare('INSERT INTO syain VALUES (?, ?, ?)');
$db->execute($sth, array(1,'Suzuki',  3));
$db->execute($sth, array(2,'Yamamoto',1));
$db->execute($sth, array(3,'Tanaka',  2));

プレースホルダには以下の３種類があります。

• ? --- クォート処理する文字列
• ! --- クォート処理しない文字列
• & --- バイナリデータを登録するためにファイル名

これらの文字( ? , ! , & ) を それ自体の文字としてSQL文の中で使用する場合は、 \ を前に付けてエスケープする必要がありますので注意して下さい。 それは、例えば次のような場合です。

SELECT * FROM  syain WHERE syain_name like 'Suzuki!%'  # これは構文エラーになります!

プレースホルダにはもう１つの利点があります。 それはエスケープとクオート処理を自動で行ってくれる点です。 自前でエスケープまたはクオート処理を行うには以下で説明する escapeSimple() または quotoSmart() を使います。

クオート処理

　SQL文では文字列をクォート文字で囲み、NULL値 は 'NULL' と記述するなどの規則があります。 また、文字列中の特殊な文字をエスケープする必要もあります。 このような処理を自前でするのは手間の掛かることです。 PEAR::DBでは、以下に示すような便利なメソッドが準備されています。

string
DB_common::escapeSimple
( string $str )

$sql = "SELECT * FROM syain WHERE syain_name = '"
       . $db->escapeSimple($name) . "'";

mixed
DB_common::quoteSmart
( mixed $in )