PHP PDOStatement:bindParam 插入資料錯誤問題分析

錯誤的插入作業碼：

<?php $dbh = new PDO('mysql:host=localhost;dbname=test', "test");

$query = <<<QUERY
  INSERT INTO `user` (`username`, `city`) VALUES (:username, :city);
QUERY;
$statement = $dbh->prepare($query);

$bind_params = array(':username' => "Jason", ':city' => "shanghai");
foreach( $bind_params as $key => $value ){
    $statement->bindParam($key, $value);
}

$statement->execute();

最終執行的SQL是:
INSERT INTO `user` (`username`, `city`) VALUES ("shanghai", "shanghai");

原因是bindParam和bindValue是不同的, bindParam要求第二個參數是一個引用變數(reference).
讓我們把上面的代碼的foreach拆開, 也就是這個foreach:

代碼如下:
<?php
foreach( $bind_params as $key => $value ){
    $statement->bindParam($key, $value);
}

相當於如下代碼:
<?php
//第一次迴圈
$value = $bind_params[":username"];
$statement->bindParam(":username", &$value); //此時, :username是對$value變數的引用

//第二次迴圈
$value = $bind_params[":city"]; //oops! $value被覆蓋成了:city的值
$statement->bindParam(":city", &$value);

所以, 在使用bindParam的時候, 尤其要注意和foreach聯合使用的這個陷阱. 那麼正確的作法呢?
1. 不要使用foreach, 而是手動賦值

代碼如下:
<?php
$statement->bindParam(":username", $bind_params[":username"]); //$value是引用變數了
$statement->bindParam(":city", $bind_params[":city"]);

2. 使用bindValue代替bindParam, 或者直接在execute中傳遞整個參數數組.

3. 使用foreach和reference(不推薦)
代碼如下:
<?php
foreach( $bind_params as $key => &$value ) { //注意這裡
    $statement->bindParam($key, $value);
}