很久沒有寫關於 adodb 相關的文章了，前一陣子（好久以前）翻閱文件的時候，注意到新增了一個 AutoExecute 的 Method ，看名字就覺得很有趣，所以當然就玩了一下。

一玩不得了，這東西太好用了，所以一直想說要介紹給朋友用，但是一直忘記要寫文章，雖然過了很久，但是還是來補一下好了。

還沒有用 GetInsertSQL 跟 GetUpdateSQL 以前，通常都需要自己撰寫相關的 SQL 去操作資料庫，不免會遇到打錯 SQL 或是程式碼中一堆 SQL 語法的問題。

之後我用 adodb 的時候，通常都會跟官方文件上得範例差不多，都是用 GetInsertSQL 或是 GetUpdateSQL 癌產生 SQL ，然後才用 Execute 去執行該 SQL ，而GetUpdateSQL 之前還要 Select 一下資料庫，取出一份該筆資料得欄位跟資料內容，所以整段程式變成有點累贅，因為一些不必要的重複的 Code 不斷出現。

類似這樣：

$rs = $db->Execute("Select * from mytable where id = '{$id}'");
$updateArray['name'] = 'newName';
$UpdateSQL = $db->GetUpdateSQL($rs,$updateArray);
$db->Execute($sql);

而比較新的版本的 adodb 則新增了 AutoExecute ，則可以大幅度減少這些無謂的程式碼.

AutoExecute($table, $arrFields, $mode, $where=false, $forceUpdate=true,$magicq=false)

參數說明:

• $table 要處理的表格名稱
• $arrFields 要更新或新增的欄位內容
• $mode 模式選擇，內容需為 INSERT 或是 UPDATE 
• $where 當模式為 UPDATE 的時候，需要輸入更新條件
• $forceUpdate 一般來說預設 UPDATE 的時後，會先從資料庫取出該筆資料，然後若是欄位內容沒有修改，則不會進行UPDATE，只會更新有更新的欄位，若是姜此參數設定，則會強迫一律更新。
• $magicq 系統環境是否有把 magice_quotes 打開，預設是沒有，所以會替你將傳入的資料作 qstr

範例：

$record["firstName"] = "Carol";
$record["lasTname"] = "Smith"; 
$conn->AutoExecute($table,$record,'INSERT');
# executes "INSERT INTO $table (firstName,lasTname) values ('Carol',Smith')";

$record["firstName"] = "Carol";
$record["lasTname"] = "Jones"; 
$conn->AutoExecute($table,$record,'UPDATE', "lastname like 'Sm%'");
# executes "UPDATE $table SET firstName='Carol',lasTname='Jones' WHERE lastname like 'Sm%'";

從上面的範例可以發現，比起之前用 GetUpdateSQL 與 GetInsertSQL 更為簡潔，且更為方便了！

官方文件

http://phplens.com/adodb/reference.functions.getupdatesql.html#autoexecute