萬盛學電腦網

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

PHP 連接 Access 資料庫並匯出文字檔:COM 元件實作與大量資料分頁處理

前言

在 Windows 環境下,PHP 可透過 COM 元件呼叫 ADO 連接 Access (.mdb/.accdb) 資料庫。本文示範完整連線、查詢、分頁讀取、寫入 Tab 分隔文字檔的實作,並解決大量資料記憶體不足的問題。

一、環境需求

  • Windows Server / Windows 10/11
  • PHP 啟用 com_dotnet 擴展(php.ini:extension=com_dotnet)
  • 安裝 Microsoft Access Database Engine(32/64 位元需與 PHP 版本一致)

二、完整實作程式碼

<?php
/**
 * Access 匯出文字檔
 * 使用 ADODB.Connection + ADODB.Recordset 分頁讀取,避免一次載入所有資料
 */
set_time_limit(0);
ini_set('memory_limit', '512M');

define('MDB_PATH', __DIR__ . '/data/callerloc.mdb');
define('TABLE_NAME', 'shoujiguishudi');
define('OUTPUT_FILE', __DIR__ . '/output.txt');
define('PAGE_SIZE', 1000); // 每頁筆數

try {
    // 1. 建立連線
    $conn = new COM('ADODB.Connection');
    $conn->Provider = 'Microsoft.Jet.OLEDB.4.0'; // .mdb
    // .accdb 使用:$conn->Provider = 'Microsoft.ACE.OLEDB.12.0';
    $conn->Open(MDB_PATH);

    // 2. 開啟 Recordset(游標型態 1=adOpenKeyset, 鎖定型態 1=adLockReadOnly)
    $rs = new COM('ADODB.Recordset');
    $sql = "SELECT * FROM " . TABLE_NAME;
    $rs->Open($sql, $conn, 1, 1);

    // 3. 分頁處理
    $page = max(1, (int)($_GET['page'] ?? 1));
    if ($page > $rs->PageCount) $page = $rs->PageCount;
    $rs->PageSize = PAGE_SIZE;
    $rs->AbsolutePage = $page;

    // 4. 開啟輸出檔案(附加模式或覆寫)
    $fp = fopen(OUTPUT_FILE, 'w');
    if (!$fp) throw new RuntimeException('無法開啟輸出檔案');

    // 5. 寫入標題列
    $headers = [];
    foreach ($rs->Fields as $field) {
        $headers[] = $field->Name;
    }
    fwrite($fp, implode("\t", $headers) . "\r\n");

    // 6. 逐筆寫入資料
    $count = 0;
    while (!$rs->EOF) {
        $row = [];
        foreach ($rs->Fields as $field) {
            $row[] = $field->Value;
        }
        fwrite($fp, implode("\t", $row) . "\r\n");

        $count++;
        $rs->MoveNext();

        // 進度顯示(CLI 模式)
        if (php_sapi_name() === 'cli' && $count % 1000 === 0) {
            echo "已處理 $count 筆...\n";
        }
    }

    fclose($fp);
    $rs->Close();
    $conn->Close();

    echo "匯出完成!共 $count 筆,檔案:".OUTPUT_FILE;

} catch (com_exception $e) {
    echo "COM 錯誤:{$e->getMessage()} (Code: {$e->getCode()})";
} catch (Throwable $e) {
    echo "錯誤:{$e->getMessage()}";
}

三、關鍵技術點解析

1. 分頁機制

  • $rs->PageSize = 1000:設定每頁筆數
  • $rs->AbsolutePage = $page:跳轉至指定頁
  • $rs->PageCount:總頁數
  • 此機制由 OLEDB 提供端實作,**不會一次載入所有資料到 PHP 記憶體**,適合百萬筆資料。

2. 欄位值取得

foreach ($rs->Fields as $field) {
    $value = $field->Value; // 自動轉換為 PHP 型別
    // 注意:DateTime 物件需自行格式化
    if ($value instanceof VARIANT) { /* 處理 VARIANT */ }
}

3. 錯誤處理

  • 捕捉 com_exception 處理 ADO 錯誤(如連線失敗、SQL 語法錯)
  • 使用 try-finally 確保連線關閉

四、Linux 環境替代方案

Linux 無 COM 元件,改用 ODBC 或 mdbtools:

# Ubuntu 安裝
sudo apt-get install unixodbc-dev mdbtools libmdbodbc

# PHP 安裝 odbc 擴展
docker-php-ext-install odbc

# 設定 /etc/odbc.ini
[MDB]
Description = MDB Database
Driver = MDBTools
Database = /path/to/file.mdb

# PHP 連線
$conn = odbc_connect('MDB', '', '');
$sql = "SELECT * FROM table";
$rs = odbc_exec($conn, $sql);
while (odbc_fetch_row($rs)) {
    $val = odbc_result($rs, 'field_name');
    // ...
}

五、效能優化建議

  • 只選需要欄位:SELECT id, name, phone FROM ... 而非 SELECT *
  • 批次寫入:累積 1000 筆字串再 fwrite,減少系統呼叫
  • 使用 CLI 執行:避免 Web 超時,支援長時間執行
  • 並行處理:大表可依主鍵範圍分多行程同時匯出,最後合併檔案

結語

PHP + COM + ADO 是 Windows 平台存取 Access 的標準做法。關鍵在於分頁游標避免記憶體爆炸、正確安裝對應位元數的 Access Database Engine、妥善處理 COM 例外與資源釋放。若專案長期依賴 Access,建議規劃遷移至 SQLite/MySQL/PostgreSQL,獲得跨平台、高效能、標準 SQL 支援。

copyright © 萬盛學電腦網 all rights reserved