PHP8.5怎么用ffmpeg调整视频亮度对比度-php教程-PHP中文网

php 8.5 通过安全调用 ffmpeg 的 eq 滤镜调整视频亮度、对比度和饱和度，需确保 ffmpeg 已安装、路径明确、权限正确，并使用 escapeshellarg() 防御命令注入，配合 returncode、frame 输出及文件校验判断真实成功。

php8.5怎么用ffmpeg调整视频亮度对比度

PHP 8.5 本身不直接处理视频像素，调整视频亮度、对比度、饱和度需依赖 FFmpeg 命令行工具。PHP 的作用是**安全拼接并执行 FFmpeg 滤镜命令**，核心滤镜是 `eq`（equalizer），它支持动态调节这三个参数。以下为实用、可落地的操作方式，适配 PHP 8.5 环境：

确认 FFmpeg 已就绪且路径明确

PHP 8.5 不改变底层依赖，仍需系统级 FFmpeg 可执行文件：

运行 which ffmpeg 或 ffmpeg -version 验证安装
推荐使用绝对路径（如 /usr/bin/ffmpeg 或 C:\ffmpeg\bin\ffmpeg.exe），避免 PATH 不一致问题
确保 Web 进程用户（如 www-data、nginx、IIS_IUSRS）对输入视频和输出目录有读写权限

用 exec() 安全调用 eq 滤镜命令

FFmpeg 的 eq 滤镜语法简洁明确：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

brightness：范围 -1.0 ~ +1.0（0 为默认，+0.3 表示提亮）
contrast：范围 -1000 ~ +1000（1.0 为默认，200 表示增强对比）
saturation：范围 0.0 ~ 3.0（1.0 为默认，1.8 表示更鲜艳）

示例命令（提升亮度 0.2、对比度 150、饱和度 1.5）：

/usr/bin/ffmpeg -i /path/in.mp4 -vf "eq=brightness=0.2:contrast=150:saturation=1.5" -c:a copy -y /path/out.mp4 2>&1

PHP 8.5 安全调用写法（含错误捕获）

必须过滤路径、捕获 stderr、检查实际输出，不能只看 returnCode：

$input = escapeshellarg('/var/videos/src.mp4');
$output = escapeshellarg('/var/videos/adjusted.mp4');
$cmd = "/usr/bin/ffmpeg -i {$input} -vf \"eq=brightness=0.25:contrast=120:saturation=1.6\" -c:a copy -y {$output} 2>&1";

$outputLines = [];
$returnCode = 0;
exec($cmd, $outputLines, $returnCode);

// 判断是否真成功：returnCode=0 + 输出含 'frame=' + 文件存在且非空
if ($returnCode === 0 && !empty($outputLines) && strpos(implode(' ', $outputLines), 'frame=') !== false && is_file($output) && filesize($output) > 10240) {
    echo "调整完成";
} else {
    error_log("FFmpeg 调整失败：" . implode("\n", array_slice($outputLines, 0, 15)));
    echo "处理失败，请查看日志";
}