前置條件與限制
- 作業系統:僅限 32 位元 Windows(或 64 位元 Windows 配合 32 位元 PHP + 32 位元 ODBC 驅動)
- PHP 版本:PHP 4.0.7+ 內建 COM 支援;PHP 5/7/8 需啟用
extension=com_dotnet
- 權限:執行 PHP 的使用者需具備存取資料庫檔案、啟動 Office 應用程式的權限
- 安全性警示:COM 呼叫在伺服器端執行,極易導致資源洩漏、程序殭屍,生產環境慎用
案例一:ADO 連線 Access 資料庫
<?php
try {
// 1. 建立 ADO 連線物件
$conn = new COM("ADODB.Connection") or die("無法建立 ADODB.Connection");
// 2. 設定 Provider(MSDASQL = ODBC 封裝層)
$conn->Provider = "MSDASQL";
// 3. 開啟連線:DSN 名稱、檔案路徑、或完整連線字串
// 方式 A:系統 DSN
$conn->Open("nwind");
// 方式 B:DSN-less 連線字串(推薦,免設定 DSN)
// $conn->Open("Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\path\\db.mdb;Uid=Admin;Pwd=;");
// 4. 執行 SQL 查詢
$rs = $conn->Execute("SELECT ProductID, ProductName, UnitPrice FROM Products");
// 5. 迭代記錄集
echo "<table border='1'><tr><th>ID</th><th>名稱</th><th>價格</th></tr>";
while (!$rs->EOF) {
echo "<tr>";
echo "<td>" . $rs->Fields(0)->Value . "</td>";
echo "<td>" . $rs->Fields(1)->Value . "</td>";
echo "<td>" . $rs->Fields(2)->Value . "</td>";
echo "</tr>";
$rs->MoveNext();
}
echo "</table>";
// 6. 釋放資源(極重要!)
$rs->Close();
$conn->Close();
$rs = null;
$conn = null;
} catch (com_exception $e) {
echo "COM 錯誤:{$e->getMessage()}";
}
?>
案例二:自動化 Microsoft Word
<?php
try {
$word = new COM("Word.Application") or die("無法啟動 Word");
$word->Visible = true; // 顯示視窗(僅適用桌面互動模式)
$doc = $word->Documents->Add(); // 新增文件
$word->Selection->TypeText("這是 PHP 透過 COM 產生的測試文件。\n");
$word->Selection->TypeText("建立時間:" . date("Y-m-d H:i:s"));
// 儲存並關閉
$savePath = "C:\\temp\\php_com_test.docx";
$doc->SaveAs($savePath);
$doc->Close();
$word->Quit();
$word = null;
echo "文件已產生:$savePath";
} catch (com_exception $e) {
echo "Word 自動化失敗:{$e->getMessage()}";
}
?>
關鍵最佳實務
- 務必釋放 COM 物件:設為
null 觸發參考計數釋放,否則會留下 WINWORD.EXE 或 msaccess.exe 殭屍程序
- 錯誤處理:包裹在
try-catch 捕捉 com_exception
- 避免長時間執行:Office 自動化非執行緒安全,不適合高併發 Web 請求
- 替代方案:
- Access/Excel:改用
PDO_ODBC、PHPExcel/PhpSpreadsheet
- Word/PDF:改用
PhpWord、LibreOffice headless、wkhtmltopdf
常見錯誤代碼對照
| HRESULT | 常見原因 |
| 0x8000401A (CO_E_NOTINITIALIZED) | COM 程式庫未初始化,確認 php.ini com.allow_dcom=true |
| 0x80070005 (E_ACCESSDENIED) | 權限不足,DCOM 設定需授權啟動/存取權限給 IIS_IUSRS 或對應使用者 |
| 0x800401F3 (CO_E_CLASSSTRING) | ProgID 錯誤,確認 Office 版位元數與 PHP 一致 |