PHP 調用 FFmpeg 為視頻添加字幕與縮略圖完整實戰

PHP + FFmpeg 實現視頻字幕燒錄、縮略圖提取與格式轉碼

在視頻平台、教學系統、內容審核等場景，常需對上傳視頻自動生成縮略圖、燒錄字幕、轉碼為統一格式。本文提供一套基於 PHP shell_exec 調用 FFmpeg/MEncoder 的完整方案，涵蓋批量處理、參數優化與錯誤容錯。

一、 核心依賴與環境準備

• FFmpeg：視頻解碼、縮略圖提取、格式轉換
• MEncoder（MPlayer 組件）：字幕燒錄、音頻增益、視頻編碼
• PHP 需啟用 exec、shell_exec 函數，且 Web 用戶對二進制文件有執行權限

二、 批量處理入口腳本

<?php
$dir = __DIR__ . '/videos/';
$allowedExt = ['avi', 'mp4', 'mkv', 'mov'];

if ($handle = opendir($dir)) {
    while (false !== ($file = readdir($handle))) {
        $path = $dir . $file;
        if (!is_file($path)) continue;
        $ext = strtolower(pathinfo($file, PATHINFO_EXTENSION));
        if (!in_array($ext, $allowedExt)) continue;

        $base = $dir . pathinfo($file, PATHINFO_FILENAME);
        $subFile  = $base . '.srt';   // 字幕文件
        $idxFile  = $base . '.idx';   // VobSub 索引（可選）
        $thumbFile = $base . '.jpg';  // 縮略圖
        $outFile   = $base . '.mp4';  // 輸出文件

        if (file_exists($subFile)) {
            processVideo($path, $subFile, $idxFile, $thumbFile, $outFile);
        } else {
            error_log("字幕缺失：$subFile");
        }
    }
    closedir($handle);
}

function processVideo($in, $sub, $idx, $thumb, $out) {
    // 1. 提取縮略圖（第 250 幀，16:9，286x160）
    $cmd = "ffmpeg -v 0 -y -i " . escapeshellarg($in) .
           " -vframes 1 -ss 250 -vcodec mjpeg -f rawvideo -s 286x160 -aspect 16:9 " .
           escapeshellarg($thumb);
    $res = shell_exec($cmd);
    if ($res === null || !file_exists($thumb)) {
        error_log("縮略圖生成失敗：$in");
    }

    // 2. 燒錄字幕並轉碼（H.264 + AVI 容器）
    $cmd = "mencoder " . escapeshellarg($in) .
           " -o " . escapeshellarg($out) .
           " -sub " . escapeshellarg($sub) .
           " -subfont-text-scale 3.0 -subpos 99 " .
           " -af volume=10 -aspect 16:9 -of avi -noodml " .
           " -ovc x264 -x264encopts bitrate=1200:threads=auto " .
           " -oac mp3lame -lameopts vbr=3:br=128";
    $res = shell_exec($cmd);
    if ($res === null || !file_exists($out)) {
        error_log("視頻轉碼失敗：$in");
    }
}

三、 關鍵參數深度解析

四、 進階優化方向

1. 異步隊列：將視頻任務推入 Redis/RabbitMQ，由 Worker 進程消費，避免阻塞 Web 進程。
2. 進度回調：解析 FFmpeg -progress 輸出，實時寫入數據庫，前端輪詢展示進度條。
3. 多碼率自適應：生成 360p/720p/1080p 多版本，配合 HLS/DASH 實現自適應播放。
4. 字幕格式統一：上傳前統一轉為 UTF-8 編碼的 SRT，避免 MEncoder 讀取亂碼。
5. 錯誤重試與告警：記錄非零退出碼，超過 3 次失敗觸發釘釘/郵件告警。

五、 安全與維護提示

• 所有外部參數經 escapeshellarg() 轉義，防止命令注入。
• 定期清理臨時文件，設置 tmpwatch 或 cron 任務。
• FFmpeg/MEncoder 版本鎖定，避免系統升級導致參數不兼容。
• 生產環境建議使用 ffmpeg-php 或 php-ffmpeg 等擴展替代 shell_exec，獲得更好的錯誤處理與面向對象介面。

六、 結語

通過 PHP 調用 FFmpeg/MEncoder 組合，可快速構建視頻字幕燒錄、縮略圖生成、格式統一轉碼的自動化流水線。掌握核心參數含義並引入異步隊列、進度監控，即可支撐中小型視頻業務的日常處理需求。