PHP 實現 Word 轉 HTML：基於 COM 元件呼叫 Microsoft Word 完整方案

PHP 伺服器端 Word 轉 HTML：COM 自動化方案詳解與避坑指南

若需在 Linux/Windows 伺服器完美還原 Word 排版（含複雜表格、浮水印、公式、SmartArt），唯有呼叫真正的 Microsoft Word 引擎。本文介紹 Windows + PHP COM 擴充套件啟動 Word Application 另存為 HTML 的完整流程，並說明 LibreOffice/WPS 方案的局限。

前置需求

1. Windows Server 安裝 Microsoft Word (Office 2016/2019/365)
2. PHP 啟用 com_dotnet 擴充：php.ini 取消註解 extension=php_com_dotnet.dll 並設 com.allow_dcom = true
3. Apache/Nginx + PHP 需以**有桌面互動權限的使用者身分**執行（非 Local System），否則 Word 視窗無法顯示/操作

核心轉換代碼

<?php
function word2html(string $wordPath, string $htmlPath): bool {
  if (!file_exists($wordPath)) return false;
  try {
    $word = new COM("Word.Application") or die("無法啟動 Word");
    $word->Visible = 0; // 無頭模式
    $word->DisplayAlerts = 0; // 關閉彈窗
    $doc = $word->Documents->Open(realpath($wordPath), ReadOnly: true);
    // wdFormatFilteredHTML = 10, wdFormatHTML = 8
    $doc->SaveAs($htmlPath, 8);
    $doc->Close(false);
    $word->Quit();
    $word = null;
    unset($word);
    // 釋放 COM 參考
    while (com_release($word) > 0) {}
    return file_exists($htmlPath);
  } catch (com_exception $e) {
    error_log("Word 轉換失敗: " . $e->getMessage());
    return false;
  }
}

// 使用
word2html('D:/www/test/6.docx', 'D:/www/test/6.html');

關鍵參數說明

常見問題與解決

1. 頁面長時間無回應： Word 進程卡住（彈窗、授權、宏提示）。解法：$word->DisplayAlerts = 0、確保 Word 已完成首次啟動授權、檔案無密碼保護。
2. 輸出 HTML 極其龐大/雜亂： Word 輸出含大量 <o:p>、<w:...> 標籤。後續可用 tidy 或自訂正則清洗。
3. 併發衝突： Word Application 單執行緒，同一時間只能處理一個轉換。生產環境需建立**轉換佇列 + 背景 Worker 串行處理**，或採用 LibreOffice Headless 叢集作為替代（犧牲部分排版精度）。
4. 權限錯誤 (0x800A11FD)： 儲存路徑無寫入權限，或目標檔案被佔用。

替代方案比較

建議架構

生產環境建立「轉換微服務」：API 接收上傳 → 存入暫存 → 推入 Redis/RabbitMQ 佇列 → Worker 串行呼叫 COM → 結果回調/輪詢 → 回傳 HTML URL。並設定超時殺進程、磁碟空間監控、Word 進程定期重啟防記憶體洩漏。