小程序无法直接运行PHP或调用FFmpeg生成MP4,必须通过前后端协作:小程序上传素材、发起任务请求,PHP服务端调用ffmpeg异步生成视频并返回URL,小程序轮询状态后下载保存。

小程序本身不能直接运行 PHP,也不能在前端调用 PHP 脚本生成 MP4 —— 所有 PHP 逻辑必须部署在服务器端,小程序只负责发起请求、上传素材、轮询状态、下载结果。
PHP 生成 MP4 必须在服务端执行
小程序的 JS 运行环境(WebView 或 WXS)不支持 FFmpeg、不支持文件系统写入、无法执行 shell 命令。所谓“小程序里 PHP”,实际是:小程序 → 发起 POST 请求到你的 PHP 接口 → PHP 在服务器上用 exec() 或 shell_exec() 调用 ffmpeg 生成 MP4 → 返回视频 URL 或任务 ID。
- 确保服务器已安装
ffmpeg,且 PHP 进程有权限执行它(常见坑:Permission denied或command not found) - PHP 中禁用
exec等函数时(如某些共享主机),此方案直接不可行 - 生成过程可能耗时数秒至数分钟,不能同步阻塞响应;必须用异步任务 + 状态查询机制
小程序调用 PHP 接口的典型流程
核心不是“调用 PHP”,而是设计一套前后端协作的视频生成工作流:
- 小程序上传图片/音频到服务器(如通过
wx.uploadFile传到/api/upload.php) - 小程序 POST 启动任务:携带素材路径、参数(分辨率、时长、背景色等)到
/api/generate.php - PHP 接收后生成唯一
$task_id,写入临时记录(如 JSON 文件或数据库),立即返回{"task_id": "abc123"} - 小程序用
setInterval轮询/api/status.php?task_id=abc123,PHP 检查对应 MP4 文件是否存在并返回{"status": "done", "url": "/output/abc123.mp4"} - 小程序拿到
url后用wx.downloadFile下载,再用wx.saveVideoToPhotosAlbum保存
PHP 用 ffmpeg 生成 MP4 的最小可行示例
注意路径权限、超时、错误捕获 —— 直接 exec("ffmpeg ...") 很容易静默失败:
立即学习“PHP免费学习笔记(深入)”;
if (!file_exists('/usr/bin/ffmpeg')) {
die('ffmpeg not found');
}
$input_img = '/path/to/uploaded/image.jpg';
$output_mp4 = '/path/to/output/' . $task_id . '.mp4';
$cmd = sprintf(
'/usr/bin/ffmpeg -y -loop 1 -i %s -c:v libx264 -t 5 -pix_fmt yuv420p -vf "scale=720:1280:force_original_aspect_ratio=decrease,pad=720:1280:(ow-iw)/2:(oh-ih)/2" %s 2>&1',
escapeshellarg($input_img),
escapeshellarg($output_mp4)
);
$output = [];
$return_code = 0;
exec($cmd, $output, $return_code);
if ($return_code !== 0) {
error_log('FFmpeg failed: ' . implode("\n", $output));
die('video generation failed');
}
-
-y强制覆盖,避免交互等待 -
escapeshellarg()必须使用,否则用户上传的文件名含空格或单引号会崩掉命令 -
2>&1把错误输出合并到标准输出,方便捕获日志 - 生成前检查磁盘空间和
open_basedir限制(常见于宝塔/小主机)
小程序端轮询与超时处理要务实
别设 1 秒轮询 60 次。真实场景中,MP4 生成受 CPU、I/O 影响大:
- 首 3 次用 1s 间隔,之后逐步延长(如 2s → 3s → 5s)
- 总超时建议 ≥ 120 秒,同时后端 PHP 脚本需设置
set_time_limit(300) - 若轮询返回
{"status": "failed"},应展示具体错误(如从 PHP 日志提取关键词),而不是只写“生成失败” - 避免用户反复点击触发多个并发任务 —— 后端应对同一用户/IP 加简单限流或去重
真正卡住的地方往往不是语法,而是 ffmpeg 权限、路径不可写、PHP 执行函数被禁、或没意识到小程序根本看不到服务器上的 /var/www/html/output/ —— 它只能访问能被 HTTP 直接 GET 到的路径(比如 https://yoursite.com/output/xxx.mp4)。











