萬盛學電腦網

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

PHP 獲取 SWF 動畫截圖:COM 組件調用 Flash2Jpeg 實現方案

方案背景

早期 Web 盛行 Flash (SWF),需在服務端生成縮略圖/預覽圖。PHP 在 Windows 平台可通過 COM 組件調用 SunCN.Flash2Jpeg (第三方 ActiveX 控件) 實現 SWF 幀截圖。注意:此方案僅適用於 Windows + 已安裝該控件的環境,現代項目建議遷移至 HTML5/MP4。

前置條件

  1. Windows Server / Windows 桌面版。
  2. 安裝 Flash2Jpeg.ocx 並註冊:regsvr32 Flash2Jpeg.ocx。
  3. PHP 啟用 com_dotnet 擴展 (php.ini 中 extension=com_dotnet)。
  4. 運行 PHP 的用戶 (如 IIS_IUSRS、Apache 用戶) 擁有 COM 組件調用權限 (DCOM 配置)。

核心代碼

<?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 尺寸。
  • 組件內部會啟動 Flash Player 渲染指定幀 (通常第 1 幀) 並導出 JPEG。

常見問題與替代方案

現代替代技術棧

  • Ruffle:Rust 寫的 Flash Player 模擬器,支持 WASM 瀏覽器端運行,也可 Node.js 服務端渲染截圖。
  • swftools + Xvfb:Linux 下 swfrender input.swf -o output.png,需虛擬顯示器。
  • ffmpeg:ffmpeg -i input.swf -frames:v 1 output.jpg (需構建支持 SWF 的 ffmpeg)。
  • 無頭 Chrome:將 SWF 轉為 HTML5/Canvas 動畫,再用 Puppeteer 截圖。

總結

COM + Flash2Jpeg 是 Windows 時代的歷史產物,**新項目嚴禁使用**。存量系統維護期內做好隔離、監控、遷移規劃。現代化方案請拥抱 Ruffle、無頭瀏覽器或視頻轉碼流水線。

copyright © 萬盛學電腦網 all rights reserved
問題解決/替代
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 替代品