早期 Web 盛行 Flash (SWF),需在服務端生成縮略圖/預覽圖。PHP 在 Windows 平台可通過 COM 組件調用 SunCN.Flash2Jpeg (第三方 ActiveX 控件) 實現 SWF 幀截圖。注意:此方案僅適用於 Windows + 已安裝該控件的環境,現代項目建議遷移至 HTML5/MP4。
Flash2Jpeg.ocx 並註冊:regsvr32 Flash2Jpeg.ocx。com_dotnet 擴展 (php.ini 中 extension=com_dotnet)。<?php
$oldswf = "/uploads/swf/test.swf"; // 源 SWF 路徑
$oldjpg = "/uploads/litpic/test.jpg"; // 輸出 JPG 路徑
try {
$flash2jpeg = new COM("SunCN.Flash2Jpeg");
if ($flash2jpeg) {
// 參數:源文件、寬、高、目標文件
$success = $flash2jpeg->Flash2Jpeg($oldswf, 150, 200, $oldjpg);
if ($success) {
$litpic = $oldjpg;
echo "截圖成功:$litpic";
} else {
$litpic = '/images/defaultpic.gif';
echo "截圖失敗,使用默認圖";
}
} else {
throw new Exception("COM 組件實例化失敗");
}
} catch (com_exception $e) {
$litpic = '/images/defaultpic.gif';
error_log("Flash2Jpeg COM Error: " . $e->getMessage());
echo "組件調用異常,使用默認圖";
}
// 輸出圖片或重定向
header("Content-Type: image/jpeg");
readfile($litpic);
Flash2Jpeg(source, width, height, dest):寬高為輸出圖片尺寸,非源 SWF 尺寸。| 問題 | 解決/替代 |
|---|---|
| COM 組件未註冊/權限不足 | 以管理員運行 regsvr32、DCOM 配置 (dcomcnfg) 授權啟動權限 |
| Linux/Docker 環境無法運行 | **根本無法在 Linux 運行**;改用 swftools (swfrender) + Xvfb、或 ffmpeg -i input.swf -vframes 1 output.jpg (需 SWF 支持) |
| Flash Player 已停止更新/安全風險 | **強烈建議遷移**:前端不再支持 Flash,服務端截圖無意義。歷史 SWF 轉 HTML5/視頻 (Ruffle/Flashpoint/人工重寫) |
| 多併發下 COM 單線程瓶頸 | 隊列化處理、限制並發數、或改用無頭瀏覽器 (Puppeteer/Playwright) 渲染 HTML5 替代品 |