php用ffmpeg给视频加字幕，具体代码步骤是怎样的？

PHP使用FFmpeg向视频中添加文字字幕的实现方法

在视频处理领域,为视频添加字幕是一项常见需求，PHP作为一种广泛使用的服务器端脚本语言，结合FFmpeg这一强大的多媒体处理工具，可以高效实现视频字幕添加功能，本文将详细介绍如何通过PHP调用FFmpeg，为视频添加文字字幕，涵盖环境准备、核心代码实现、常见问题处理等内容。

环境准备与依赖安装

在使用PHP处理视频字幕之前,需确保服务器已安装FFmpeg及其相关依赖，FFmpeg是一个开源的音视频处理工具，支持多种格式的编码、解码、转码和流处理，对于Linux系统，可通过包管理器安装，例如在Ubuntu中运行sudo apt-get install ffmpeg，对于Windows系统，可从FFmpeg官网下载预编译的二进制文件并配置环境变量。

PHP需启用exec或shell_exec函数以执行FFmpeg命令，这些函数默认可能被禁用，需在php.ini中配置disable_functions项，移除相关限制，确保PHP有足够的权限访问FFmpeg及视频文件目录。

基本实现原理

通过PHP调用FFmpeg的drawtext滤镜，可在视频帧上绘制文字字幕。drawtext滤镜支持自定义字体、颜色、位置、动画效果等参数，结合PHP的动态参数传递，可实现灵活的字幕添加逻辑，核心流程包括：

1. 构建FFmpeg命令,指定输入视频、输出路径及字幕参数。
2. 使用PHP执行该命令,并监控执行状态。
3. 处理可能的错误,如文件不存在或权限不足。

核心代码实现

以下是一个完整的PHP示例,演示如何为视频添加静态字幕：

<?php
$inputFile = 'input.mp4';
$outputFile = 'output.mp4';
$text = '示例字幕';
$fontSize = 24;
$fontColor = 'white';
$position = 'x=(w-tw)/2:y=h-th-10'; // 居中底部
$command = "ffmpeg -i {$inputFile} -vf "drawtext=text='{$text}':fontfile=/path/to/font.ttf:fontsize={$fontSize}:fontcolor={$fontColor}:{$position}" {$outputFile}";
exec($command, $output, $returnCode);
if ($returnCode !== 0) {
    echo "字幕添加失败: " . implode("n", $output);
} else {
    echo "字幕添加成功！";
}
?>

关键参数说明

• -i：指定输入视频文件。
• -vf：视频滤镜，此处调用drawtext。
• text，支持变量如%{localtime:%Y-%m-%d}动态显示时间。
• fontfile：字体文件路径，需确保服务器支持该字体格式（如.ttf）。
• fontsize与fontcolor：字体大小和颜色。
• position：字幕位置，通过x和y坐标控制，支持相对定位（如w为视频宽度）。

动态字幕与SRT文件支持

若需添加动态字幕（如逐条显示），可通过SRT字幕文件实现，SRT是一种常见的字幕格式，包含时间轴和文本内容，PHP可解析SRT文件，并通过FFmpeg的subtitles滤镜直接嵌入：

$srtFile = 'subtitle.srt';
$command = "ffmpeg -i {$inputFile} -vf "subtitles={$srtFile}:force_style='Fontsize=24,PrimaryColour=&HFFFFFF&'" {$outputFile}";
exec($command);

SRT文件解析技巧

若需自定义SRT处理逻辑（如修改样式），可使用PHP的正则表达式或第三方库（如php-reader/srt）解析文件内容，再动态生成FFmpeg命令，调整字幕透明度：

$command = "ffmpeg -i {$inputFile} -vf "subtitles={$srtFile}:force_style='Fontsize=24,PrimaryColour=&HFFFFFF&,OutlineColour=&H000000&,Outline=1'" {$outputFile}";

错误处理与性能优化

常见错误排查

1. 字体文件路径错误：确保fontfile指向有效的字体文件，且PHP有读取权限。
2. FFmpeg未找到：检查PATH环境变量或使用绝对路径调用FFmpeg。
3. 视频编码不兼容：若输出格式不支持字幕，可添加-c:v libx264参数重新编码。

性能优化建议

• 对于长视频,分段处理可减少内存占用。
• 使用-threads参数多线程加速，如-threads 4。
• 缓存处理结果,避免重复执行相同命令。

相关问答FAQs

Q1: 如何为视频添加带背景的字幕？
A: 可通过drawtext滤镜的box参数为字幕添加背景色或半透明背景。

$command = "ffmpeg -i input.mp4 -vf "drawtext=text='Hello':fontcolor=white:box=1:boxcolor=black@0.5:boxborderw=5" output.mp4";

其中boxcolor=black@0.5表示黑色半透明背景，boxborderw为边框宽度。

Q2: 字幕显示时间与视频不同步怎么办？
A: 若使用SRT文件，检查时间轴格式是否正确（如00:00:01,000 --> 00:00:03,000），若为动态生成，可通过PHP计算时间偏移量，并在drawtext中使用enable参数控制显示时长，

$command = "ffmpeg -i input.mp4 -vf "drawtext=text='动态字幕':enable='between(t,1,3)'" output.mp4";

该命令仅在视频第1至第3秒显示字幕。