PHP压缩视频上传体积技巧

PHP本身无法直接压缩视频，真正有效的压缩必须依赖ffmpeg等外部工具进行重编码，而非使用gzencode等无损压缩函数——后者不仅无效，还会损坏视频文件；文章详解了如何通过合理设置分辨率、码率（-crf）、编码器（libx264/libx265）和关键参数（如-movflags +faststart）实现高质量体积缩减，同时强调了安全校验、超时控制、路径过滤、临时文件清理等生产级必备实践，并补充了前端WebAssembly预压缩等轻量替代方案，直击开发者在视频上传优化中常踩的误区与性能陷阱。

PHP 本身不能直接压缩视频，它没有内置的视频编解码能力；真正起作用的是外部命令行工具（如 ffmpeg），PHP 只负责调用、传参、控制流程。盲目在 PHP 层做“文件读取 + base64 + gzencode”这类操作，只会损坏视频或完全无效。

为什么不能用 PHP 的 gzencode() 或 file_put_contents() 直接压缩视频文件

视频是二进制封装格式（如 MP4、AVI），内部含编码后的帧数据、音频流、元信息等。PHP 的压缩函数（如 gzencode()）属于通用无损压缩，对已高度压缩的视频流几乎无效，反而可能增大体积（因添加压缩头）或导致文件损坏无法播放。

• gzencode(file_get_contents('video.mp4')) 生成的是 gzip 包裹的原始二进制，不是合法 MP4
• 浏览器或播放器无法识别该文件，上传后通常报错“invalid file format”或“corrupted”
• 真正有效的压缩必须重编码（re-encode）：降低分辨率、码率、帧率或改用更高效编码器（如 H.265）

必须用 ffmpeg 命令行完成视频压缩，PHP 调用时的关键参数

PHP 通过 exec()、shell_exec() 或 proc_open() 调用 ffmpeg。重点不是“能不能调”，而是“参数是否合理”，否则压完画质崩坏或体积没变。

• 优先用 -vcodec libx264（兼容性好）或 -vcodec libx265（同画质下体积小 30–50%，但编码慢、部分老设备不支持）
• 用 -crf 23 控制质量（数值越小越清晰，18–28 是常用区间；别用 -b:v 固定码率，容易过爆或过糊）
• 加 -vf "scale=1280:-2" 限制宽度为 1280px，高度自动适配（-2 表示保持宽高比）
• 务必加 -movflags +faststart，让 MP4 元数据移到开头，实现网页播放“边下边播”
• 禁用音频？用 -an；保留音频但降码率？加 -acodec aac -b:a 128k

ffmpeg -i input.mp4 -vcodec libx264 -crf 26 -vf "scale=1280:-2" -acodec aac -b:a 96k -movflags +faststart output.mp4

PHP 调用 ffmpeg 的安全与稳定性要点

用户上传任意视频，直接丢给 ffmpeg 风险极高：超大文件拖垮服务器、恶意参数注入、路径遍历、超时卡死。

• 上传前用 $_FILES['video']['size'] 限制原始大小（如 ≤ 500MB），避免 OOM
• 输入文件名必须过滤：用 basename() + 正则校验（只允许字母、数字、下划线、点），严禁拼接进命令字符串
• 设置执行超时：exec("timeout 300 ffmpeg -i ...", $output, $return_code)（Linux）；Windows 用 start /b /wait cmd /c "timeout /t 300 & ffmpeg ..."
• 检查 $return_code === 0 再继续，非零说明转码失败（常见原因：源文件损坏、不支持编码格式、磁盘满）
• 输出路径必须在 Web 不可写目录（如 /tmp/ 或独立 uploads/processed/），且处理完立即 unlink() 原始上传文件

替代方案：前端预压缩（MediaRecorder + WebAssembly）适合轻量场景

如果业务允许用户用现代浏览器上传，可在前端直接压缩，减轻服务端压力。但注意：这不是“上传后压缩”，而是“上传前压缩”。

• 用 MediaRecorder 录制时指定 bitrate（如 {mimeType: 'video/webm; codecs=vp9', bitsPerSecond: 1000000}）
• 或使用 WebAssembly 库（如 @ffmpeg/ffmpeg）在浏览器内调用 FFmpeg，支持裁剪、转码、缩放
• 缺点：兼容性受限（Safari 对 MediaRecorder 支持差）、用户设备性能影响压缩速度、无法处理已存在的大视频文件
• 适用场景：UGC 短视频拍摄上传，而非上传本地已有高清视频

import { createFFmpeg, fetchFile } from '@ffmpeg/ffmpeg';
const ffmpeg = createFFmpeg({ log: true, corePath: '/ffmpeg-core.js' });
await ffmpeg.load();
ffmpeg.FS('writeFile', 'input.mp4', await fetchFile('input.mp4'));
await ffmpeg.run('-i', 'input.mp4', '-vcodec', 'libx264', '-crf', '28', 'output.mp4');
const data = ffmpeg.FS('readFile', 'output.mp4');

真正的视频压缩从来不是“PHP 函数一调就完事”。关键路径永远是：校验上传 → 安全落盘 → 外部工具重编码 → 验证输出 → 清理临时文件。漏掉任一环，都可能引发 500 错误、CPU 拉满、磁盘写满或返回损坏文件。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP压缩视频上传体积技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。