前置條件
- PHP 安裝
pdo_odbc 擴展(php.ini 啟用 extension=pdo_odbc)
- 系統安裝 Microsoft Access Database Engine (ACE OLEDB Provider)
- 32-bit Office → 安裝 32-bit Access Database Engine
- 64-bit Office → 安裝 64-bit Access Database Engine
- PHP 執行架構 (CLI/FPM) 必須與 Driver 位數一致
- Windows 系統 DSN 或使用無 DSN 連接字串
連接字串範例
<?php
// .mdb (Access 2003 及之前)
$dsn = "odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=" . __DIR__ . "/data.mdb;";
// .accdb (Access 2007+)
$dsn = "odbc:Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=" . __DIR__ . "/data.accdb;";
try {
$pdo = new PDO($dsn, '', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false, // 使用原生預處理
]);
echo "連線成功\n";
// 測試查詢
$stmt = $pdo->query("SELECT TOP 5 * FROM Users");
foreach ($stmt as $row) {
print_r($row);
}
} catch (PDOException $e) {
die("連線失敗: " . $e->getMessage());
}
?>
常見錯誤與解決
| 錯誤訊息 | 原因 | 解決 |
| could not find driver | pdo_odbc 未啟用或 ODBC 驅動未安裝 | 啟用 extension、安裝 ACE Driver |
| Data source name not found | 驅動名稱錯誤 | 確認驅動名稱:odbcad32.exe → 驅動程式頁籤 |
| Architecture mismatch | PHP 64-bit + Driver 32-bit (或相反) | 統一位數,或用 32-bit PHP (CGI/CLI) |
| General error: 1 [ODBC Driver Manager] Invalid string or buffer length | 連接字串格式錯誤 | 檢查 Dbq 路徑、分號、大括號 |
| Unrecognized database format | 檔案損壞或版本不符 | 用 Access 開啟修復、另存新版本 |
進階操作
預處理語句 (防注入)
$stmt = $pdo->prepare("SELECT * FROM Users WHERE Email = ? AND Active = ?");
$stmt->execute([$email, 1]);
$user = $stmt->fetch();
交易控制
$pdo->beginTransaction();
try {
$pdo->exec("INSERT INTO Log (msg) VALUES ('test')");
$pdo->exec("UPDATE Counter SET val = val + 1");
$pdo->commit();
} catch (Exception $e) {
$pdo->rollBack();
throw $e;
}
大量資料匯入技巧
- 關閉索引/約束 → 匯入 → 重建
- 使用
LOAD DATA 不支援,改用批次 INSERT + 交易
- 或轉為 CSV → Access 內建匯入 → 再連線查詢
替代方案
- ADODB / COM (Windows Only):
new COM('ADODB.Connection'),功能完整但效能差、難維護。
- 遷移至 SQLite/MySQL/PostgreSQL:長期專案強烈建議遷移,Access 非多使用者高併發設計。
- ODBC 連接其他資料庫:同樣 DSN 方式可連 SQL Server、Oracle、DB2 等。