PHP 通過百度百會 API 實現 Word/Excel 文件線上預覽

PHP 通過百度百會 API 實現 Word/Excel 文件線上預覽

伺服器無 LibreOffice/OnlyOffice 環境時，可借助第三方文件轉換 API 實現 Office 文件線上預覽。本文介紹百度百會 GeGe 遠端文件 API 的接入方式。

接入流程

1. 註冊百會開發者帳號，申請 apikey。
2. 構建上傳表單，目標指向 https://gege.baihui.com/remotedoc.im。
3. 指定 output=editor 獲取可編輯預覽頁，或 output=html 獲取靜態 HTML。

Excel 預覽完整範例

<!DOCTYPE html>
<html>
<head><meta charset="UTF-8"><title>測試百會遠端 API</title></head>
<body>
<form action="https://gege.baihui.com/remotedoc.im?apikey=你的KEY&output=editor" 
      target="_self" enctype="multipart/form-data" method="post">
    上傳文件: <input type="file" name="content" />
    <input type="hidden" name="filename" value="my.xls,my.xlsx" />
    <input type="hidden" name="saveurl" value="https://your.com/callback" />
    <input type="hidden" name="id" value="21012145" />
    <input type="hidden" name="format" value="xlsx" />
    <input type="hidden" name="persistence" value="true" />
    <input type="submit" value="提交預覽" />
</form>
</body>
</html>

Word 文件同理

將 format 改為 docx，filename 包含 doc,docx 即可。

參數說明

優缺點評估

• ✅ 無需伺服器安裝 Office/LibreOffice，零維護。
• ✅ 支援 Word/Excel/PPT 多格式，轉換質量較好。
• ❌ 依賴外部服務，資料敏感度高場景不適用。
• ❌ 免費版有頻率/檔案大小限制，商用需付費。
• ❌ 國內訪問速度受網路影響，海外用戶延遲高。

替代方案

• OnlyOffice Document Server：自建 Docker 容器，完全私有化，支援協同編輯。
• LibreOffice Headless + unoconv：轉 PDF 再用 PDF.js 預覽，適合單向預覽。
• Microsoft Graph API：企業級 OneDrive/SharePoint 整合方案。