從 MySQL 遷移至 ADOdb：跨數據庫兼容的插入更新與元數據處理最佳實踐

遷移動機

應用從 MySQL 遷移至其他數據庫（PostgreSQL、SQL Server、Oracle、Access 等）時，原生 SQL 方言差異導致插入/更新失敗。ADOdb（PHP 跨數據庫抽象層）提供統一 API 吸收差異，本文總結核心遷移模式。

一、插入與更新：兩大核心差異點

1. 日期格式標準化 — DBDate()

MySQL 默認 YYYY-MM-DD，SQL Server MM/DD/YYYY，Oracle DD-MON-YY，Access #MM/DD/YYYY#。

$sql = "INSERT INTO events (event_date) VALUES (" . $db->DBDate($timestamp) . ")";
$db->Execute($sql);

DBDate() 根據目標數據庫自動輸出正確字面量格式。

2. 字符串轉義與引號處理 — qstr()

MySQL 使用反斜杠轉義（don\'t），SQL Server/Access 使用雙單引號（don''t），PostgreSQL 標準單引號轉義（don't 或 E'don\'t'）。

$note = "sugar why don't we call it off";
$sql = "INSERT INTO notes (content) VALUES (" . $db->qstr($note) . ")";
$db->Execute($sql);

qstr() 自動處理引號轉義、NULL 值（返回 NULL 而非空字符串）、二進制數據編碼。

3. 完整範例：多字段插入

$ID = 3;
$TheDate = mktime(0,0,0,8,31,2001);  // 2001-08-31
$Note = "sugar why don't we call it off";

$sql = "INSERT INTO mytable (id, thedate, note) VALUES (" 
     . $ID . ", " 
     . $db->DBDate($TheDate) . ", " 
     . $db->qstr($Note) . ")";
$db->Execute($sql);

4. 影響行數與自增 ID 獲取

$affected = $connection->Affected_Rows();  // UPDATE/DELETE 影響行數
$insertId = $recordset->Insert_ID();       // 最後一條 INSERT 自增 ID
// 注意：並非所有驅動均支持，使用前請查閱對應驅動文檔

二、元數據處理：MetaTypes 統一類型系統

1. 字段信息獲取

$recordset = $conn->Execute("SELECT adate FROM table");
$f0 = $recordset->FetchField(0);
// $f0->name  = 'adate'
// $f0->type  = 'date' (原生類型名，各庫不同)
// $f0->max_length = -1 (未知時)

2. 類型標準化映射 — MetaType()

ADOdb 將各數據庫原生類型映射為統一類別：

$metaType = $db->MetaType($f0->type, $f0->max_length);
// 統一邏輯判斷
if ($metaType == 'D') { /* 日期字段處理 */ }

三、遷移檢查清單

1. 全局搜索裸露日期字面量，替換為 $db->DBDate()
2. 全局搜索字符串拼接 SQL，替換為參數化查詢或 $db->qstr()
3. 檢查 LIMIT 分頁語法差異（MySQL/PostgreSQL: LIMIT 10 OFFSET 20；SQL Server: OFFSET 20 ROWS FETCH NEXT 10 ROWS ONLY；Oracle: ROWNUM 子查詢）— ADOdb SelectLimit() 可抹平。
4. 驗證自增列獲取邏輯（Insert_ID() vs LAST_INSERT_ID() vs SCOPE_IDENTITY()）
5. 測試 NULL 與空字符串語義差異（Oracle 空字符串即 NULL）
6. 負載測試驗證連接池、預處理語句複用性能