PHP通過COM組件操作Access數據庫實戰指南

Windows環境下PHP操作Access數據庫：ADO連接與查詢實戰

在Windows平台上，PHP通過COM組件調用ADO（ActiveX Data Objects）訪問Access（.mdb/.accdb）是常見的遷移或集成方案。本文詳細講解連接字符串構建、記錄集操作、常見錯誤排查，並提供生產環境可用的封裝類。

環境前置要求

1. Windows Server/桌面版：Linux無法直接使用COM組件（需Wine或ODBC方案）
2. PHP啟用COM擴展：php.ini 中 extension=com_dotnet（PHP 7.4+ 需額外安裝）
3. Access驅動程序：安裝 Microsoft Access Database Engine（32位/64位需與PHP進程位數一致）
4. 文件權限：PHP進程用戶（如IIS_IUSRS）需有.mdb文件讀寫權限

基礎連接與查詢代碼

<?php
try {
    // 1. 創建ADO連接對象
    $conn = new COM("ADODB.Connection") or die("ADO Connection failed");
    
    // 2. 構建連接字符串
    // 注意：realpath() 獲取絕對路徑，驅動名稱需與安裝版本匹配
    $dbPath = realpath("DATUM/cnbt.mdb");
    $connStr = "Driver={Microsoft Access Driver (*.mdb)}; Dbq=$dbPath;";
    // Access 2007+ (.accdb) 使用：
    // $connStr = "Driver={Microsoft Access Driver (*.mdb, *.accdb)}; Dbq=$dbPath;";
    
    // 3. 打開連接
    $conn->Open($connStr);
    
    // 4. 創建記錄集執行查詢
    $rs = new COM("ADODB.Recordset");
    // 參數：SQL, 連接, 游標類型(1=adOpenKeyset), 鎖類型(3=adLockOptimistic)
    $rs->Open("SELECT * FROM dbo_dirs", $conn, 1, 3);
    
    // 5. 遍歷結果集
    $data = [];
    while (!$rs->EOF) {
        $row = [];
        // 通過字段名訪問
        foreach ($rs->Fields as $field) {
            $row[$field->Name] = $field->Value;
        }
        $data[] = $row;
        $rs->MoveNext();
    }
    
    // 6. 釋放資源
    $rs->Close();
    $conn->Close();
    unset($rs, $conn);
    
    print_r($data);
    
} catch (com_exception $e) {
    echo "COM錯誤: " . $e->getMessage();
}

生產級封裝類：AccessDB

<?php
class AccessDB {
    private $conn;
    private $dbPath;
    
    public function __construct(string $dbPath) {
        $this->dbPath = realpath($dbPath);
        if (!$this->dbPath || !file_exists($this->dbPath)) {
            throw new InvalidArgumentException("數據庫文件不存在: $dbPath");
        }
    }
    
    private function connect() {
        if ($this->conn) return true;
        $this->conn = new COM("ADODB.Connection");
        $driver = strtolower(pathinfo($this->dbPath, PATHINFO_EXTENSION)) === 'accdb' 
            ? 'Microsoft Access Driver (*.mdb, *.accdb)' 
            : 'Microsoft Access Driver (*.mdb)';
        $connStr = "Driver={$driver}; Dbq={$this->dbPath};";
        $this->conn->Open($connStr);
    }
    
    /** 執行查詢返回關聯數組 */
    public function query(string $sql): array {
        $this->connect();
        $rs = new COM("ADODB.Recordset");
        $rs->Open($sql, $this->conn, 1, 3); // adOpenKeyset, adLockOptimistic
        
        $results = [];
        while (!$rs->EOF) {
            $row = [];
            foreach ($rs->Fields as $field) {
                $row[$field->Name] = $field->Value;
            }
            $results[] = $row;
            $rs->MoveNext();
        }
        $rs->Close();
        return $results;
    }
    
    /** 執行非查詢SQL（INSERT/UPDATE/DELETE） */
    public function execute(string $sql): int {
        $this->connect();
        $affected = 0;
        $this->conn->Execute($sql, $affected);
        return $affected;
    }
    
    /** 獲取最後插入ID（Access不支持auto_increment標準，需查詢@@IDENTITY） */
    public function lastInsertId(): int {
        $this->connect();
        $rs = $this->conn->Execute("SELECT @@IDENTITY");
        return (int)$rs->Fields(0)->Value;
    }
    
    public function close() {
        if ($this->conn) {
            $this->conn->Close();
            $this->conn = null;
        }
    }
    
    public function __destruct() {
        $this->close();
    }
}

// 使用示例
$db = new AccessDB(__DIR__ . '/data/app.mdb');
$users = $db->query("SELECT id, username, email FROM users WHERE status = 1");
$db->execute("INSERT INTO logs (action, time) VALUES ('login', NOW())");
echo "新日誌ID: " . $db->lastInsertId();
$db->close();

常見問題與解決方案

遷移建議：從Access到MySQL/SQLite

Access適合單用戶、小數據量、桌面應用。Web項目建議遷移至：

• SQLite：無需服務器、文件式、PHP PDO原生支持、併發讀性能好
• MySQL/MariaDB：標準Web數據庫、支持高併發、生態完善
• PostgreSQL：功能強大、支持JSON、GIS、更好的標準兼容性

遷移工具：mdbtools (Linux)、Access2MySQL、Bullzip Access to MySQL 或自寫腳本逐表導出CSV再導入。

1. 上一篇文章： PHP基於SSH2實現SFTP文件傳輸完整教程
2. 下一篇文章： Linux下PHP獲取磁盤分區信息：df命令解析與SPL替代方案

PHP 相關知識

PHP支付系統核心架構設計與實戰案例深度解析

PHP支付系統核心架構設計與實戰案例深度解析 因業務拓展需求

WAMP 環境安裝配置 Zend Debugger 完整教學（PHP 5.2/5.3/5.4/5.5/5.6/7.0+）

Zend Debugger 是 Zend Studio、Ph

PHP 反引號執行系統命令：一句話 CmdShell 原理與風險

PHP 中反引號 ` ` 可直接執行系統命令並返回輸出，本文

Linux 下 Excel 數據導入 MSSQL 完整實作指南

整體流程五步驟 檔案上傳至伺服器 讀取 Excel 資料並