萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP PDO 連接 Access 資料庫類封裝實作

背景與動機

雖然 MySQL/PostgreSQL 是 PHP 開發主流,但企業環境中仍大量存在 Access (.mdb/.accdb) 資料庫遷移需求。PHP PDO 提供統一介面,配合 ODBC 驅動程式即可操作 Access,本文封裝一個可複用的資料庫操作類。

環境需求

  • PHP 5.3+ / 7.x / 8.x
  • 啟用 pdo_odbc 擴充套件
  • Windows: 安裝 Microsoft Access Database Engine (32/64 位元需與 PHP 一致)
  • Linux: 安裝 unixODBC + mdbtools (功能受限,建議遷移至 SQLite/MySQL)

資料庫連線類實作

<?php
/**
 * Access PDO 資料庫操作類
 * 支援參數綁定、預處理語句、異常處理
 */
class AccessPDO {
    private $pdo;
    private $db_path;
    
    /**
     * 建構子:建立 ODBC 連線
     * @param string $mdb_path .mdb/.accdb 絕對路徑
     * @param bool $persistent 是否持久連線
     */
    public function __construct($mdb_path, $persistent = false) {
        $this->db_path = realpath($mdb_path);
        if (!$this->db_path || !file_exists($this->db_path)) {
            throw new InvalidArgumentException("資料庫檔案不存在: $mdb_path");
        }
        
        // ODBC 連線字串 (支援 .mdb 與 .accdb)
        $driver = (pathinfo($this->db_path, PATHINFO_EXTENSION) === 'accdb') 
            ? 'Microsoft Access Driver (*.mdb, *.accdb)' 
            : 'Microsoft Access Driver (*.mdb)';
            
        $dsn = "odbc:DRIVER={$driver}; DBQ={$this->db_path};";
        
        try {
            $this->pdo = new PDO($dsn, '', '', [
                PDO::ATTR_PERSISTENT => $persistent,
                PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
                PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
                PDO::ATTR_EMULATE_PREPARES => false, // 使用真實預處理
            ]);
        } catch (PDOException $e) {
            throw new RuntimeException("Access 連線失敗: " . $e->getMessage());
        }
    }
    
    /**
     * 執行查詢 (SELECT)
     * @param string $sql SQL 語句,支援命名參數 :name
     * @param array $params 參數陣列 [':name' => 'value']
     * @return array 結果集陣列
     */
    public function query($sql, array $params = []) {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll();
    }
    
    /**
     * 執行單筆查詢
     * @return array|false 單筆關聯陣列或 false
     */
    public function queryOne($sql, array $params = []) {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetch();
    }
    
    /**
     * 執行異動 (INSERT/UPDATE/DELETE)
     * @return int 影響行數
     */
    public function execute($sql, array $params = []) {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->rowCount();
    }
    
    /**
     * 取得最後新增的自增 ID
     * @return string|false
     */
    public function lastInsertId() {
        return $this->pdo->lastInsertId();
    }
    
    /**
     * 開啟交易
     */
    public function beginTransaction() {
        return $this->pdo->beginTransaction();
    }
    
    /**
     * 提交交易
     */
    public function commit() {
        return $this->pdo->commit();
    }
    
    /**
     * 回滾交易
     */
    public function rollBack() {
        return $this->pdo->rollBack();
    }
    
    /**
     * 關閉連線
     */
    public function close() {
        $this->pdo = null;
    }
    
    // 析構函式自動關閉
    public function __destruct() {
        $this->close();
    }
}

使用範例

<?php
require_once 'AccessPDO.php';

try {
    // 實例化 (路徑請依實際調整)
    $db = new AccessPDO(__DIR__ . '/data/mydb.mdb');
    
    // 建立測試資料表
    $db->execute("CREATE TABLE IF NOT EXISTS users (
        id AUTOINCREMENT PRIMARY KEY,
        username TEXT(50),
        email TEXT(100),
        created_at DATETIME
    )");
    
    // 新增資料 (參數綁定防注入)
    $db->execute(
        "INSERT INTO users (username, email, created_at) VALUES (:u, :e, NOW())",
        [':u' => 'admin', ':e' => 'admin@example.com']
    );
    echo "新增 ID: " . $db->lastInsertId() . "<br>";
    
    // 查詢多筆
    $users = $db->query("SELECT * FROM users WHERE username LIKE :kw", [':kw' => '%admin%']);
    foreach ($users as $u) {
        echo "{$u['id']} | {$u['username']} | {$u['email']} | {$u['created_at']}<br>";
    }
    
    // 交易範例:批次轉帳
    $db->beginTransaction();
    try {
        $db->execute("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
        $db->execute("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
        $db->commit();
    } catch (Exception $e) {
        $db->rollBack();
        throw $e;
    }
    
} catch (Exception $e) {
    echo "錯誤: " . $e->getMessage();
}

Access SQL 語法差異注意事項

  • 保留字:欄位名若為保留字 (如 date, order) 需用方括號 [date]
  • 日期格式:#2023-12-31# 或 Date() 函式
  • 字串串接:使用 & 而非 || 或 CONCAT()
  • 分頁:SELECT TOP 10 * FROM table (無 LIMIT/OFFSET)
  • 參數標記:ODBC 僅支援 ? 位置參數,但 PDO 模擬支援命名參數

常見問題排查

找不到驅動程式 "Microsoft Access Driver"
安裝 Microsoft Access Database Engine 2016/2019,注意 32/64 位元必須與 PHP 版本一致 (查看 phpinfo() 的 Architecture)。
「資料庫已被鎖定」/ 無法開啟
確認 .mdb 檔案未被其他程式獨佔開啟;檔案資料夾需給 IIS/IUSR/PHP 執行身分「修改」權限。
中文亂碼
Access 預設使用系統 ANSI 編碼 (繁中為 CP950)。讀取時可用 iconv('CP950', 'UTF-8', $val) 轉碼,或改用 ADO COM 物件 (僅限 Windows)。
效能問題
Access 非高併發設計。大量資料建議遷移至 SQLite (本地) 或 MySQL/PostgreSQL (伺服器)。

總結

本封裝類提供了 PDO 標準介面操作 Access 的完整功能,包含參數綁定、交易控制、錯誤處理。雖然 Access 在 Web 環境非首選,但在舊系統整合、桌面資料匯入、小型獨立應用中仍具實用價值。

copyright © 萬盛學電腦網 all rights reserved