PHP无法直接生成MP4,只能输出已有文件流、调用FFmpeg合成或实现流式响应;关键需正确设置HTTP头、确保moov在文件开头、前端用Blob保存二进制数据。

PHP 文件本身不能“变成” MP4,它只能生成、读取、转发或拼接视频流;真正保存为 MP4 需要后端有视频处理能力(如 FFmpeg)或前端配合接收并封装流。直接用 echo file_get_contents('video.mp4') 输出二进制数据 ≠ 生成 MP4,只是透传——能否保存成功,取决于客户端如何处理响应。
PHP 直接输出 MP4 文件流(静态文件场景)
这是最常见也最安全的做法:服务器上已有合法 MP4 文件,PHP 只负责正确设置头信息并输出内容,浏览器或下载工具可识别为视频并保存。
- 必须设置
Content-Type: video/mp4,否则浏览器可能触发下载但扩展名错乱,或直接乱码解析 - 必须设置
Content-Length(可用filesize()获取),否则部分播放器/下载器会卡在“加载中” - 避免任何输出前的空格、BOM 或
echo,否则 HTTP 头发送失败,导致 MP4 文件头部损坏,无法播放 - 大文件建议用
readfile()而非file_get_contents(),防止内存溢出
header('Content-Type: video/mp4');
header('Content-Length: ' . filesize('/path/to/video.mp4'));
header('Content-Disposition: inline; filename="demo.mp4"');
readfile('/path/to/video.mp4');
exit;
PHP 调用 FFmpeg 动态生成 MP4(需服务端支持)
如果原始数据是图片序列、音频、文字或摄像头流,PHP 本身不提供编码能力,必须调用系统命令(如 ffmpeg)合成 MP4。这要求服务器已安装 FFmpeg 且 PHP 有执行权限(exec / shell_exec 未被禁用)。
-
escapeshellarg()必须包裹所有路径参数,否则含空格或特殊字符的路径会导致命令失败 - 合成耗时操作不能放在 Web 请求中同步执行,应转为队列或异步任务,否则超时或阻塞 PHP 进程
- 检查
ffmpeg -version返回值和错误输出(2>&1),仅靠返回码 0 不足以判断 MP4 是否真生成成功 - 生成的 MP4 需验证关键帧和 moov box 位置:用
ffprobe -v quiet -show_entries format=duration /tmp/out.mp4确认可读
$input = escapeshellarg('/tmp/frame_%03d.png');
$output = escapeshellarg('/tmp/output.mp4');
$cmd = "ffmpeg -framerate 24 -i {$input} -c:v libx264 -pix_fmt yuv420p {$output} 2>&1";
$result = shell_exec($cmd);
PHP 输出视频流(如 HLS 或 MP4 流式响应)
想实现“边生成边播放”,MP4 原生不支持真正的流式传输(不像 HLS 有 .m3u8 + .ts 分片)。但可通过 Content-Range 和 206 Partial Content 支持视频拖拽——前提是客户端发起带 Range 头的请求,且 PHP 正确解析并返回对应字节段。
立即学习“PHP免费学习笔记(深入)”;
- MP4 的
moovbox 必须在文件开头(即“faststart”),否则拖拽失败;可用ffmpeg -i in.mp4 -c copy -movflags +faststart out.mp4修复 - PHP 需解析
$_SERVER['HTTP_RANGE'],计算起始/结束偏移,并用fopen()+fseek()+fread()精确输出片段 - 不能用
readfile(),它无法控制读取范围;也不能忽略Accept-Ranges: bytes响应头 - 移动端 Safari 对 MP4 Range 请求更敏感,缺失任一头字段都可能拒绝播放
前端保存 PHP 输出的视频流为 MP4 文件
即使 PHP 正确输出了 MP4 二进制流,浏览器默认不会自动保存为 .mp4 文件——需要前端主动捕获响应并触发下载。常见错误是直接 window.location.href 跳转,导致 MIME 类型丢失或跨域拦截。
- 必须用
fetch()+Response.arrayBuffer()获取原始二进制,再用Blob封装,否则 UTF-8 解码会破坏 MP4 数据 -
a.download属性在 iOS Safari 中无效,需引导用户长按链接手动“保存到文件” - 若 PHP 接口跨域,需后端设置
Access-Control-Allow-Origin和Access-Control-Allow-Headers: Range - 避免将大视频一次性 load 到内存,可用
ReadableStream+pipeTo()流式写入(现代浏览器支持)
fetch('/api/video.php')
.then(res => res.arrayBuffer())
.then(buf => {
const blob = new Blob([buf], { type: 'video/mp4' });
const a = document.createElement('a');
a.href = URL.createObjectURL(blob);
a.download = 'video.mp4';
a.click();
});
真正难的不是“怎么输出”,而是“怎么确保输出的是标准、可随机访问、首帧秒开、拖拽可靠、跨平台兼容的 MP4”。很多问题出现在 FFmpeg 参数配置、moov 位置、HTTP 头完整性、前端 Blob 构造方式这些细节里——少一个 movflags +faststart,或漏一个 Content-Length,就可能让视频在某个设备上彻底打不开。











