PHP无法直接运行WebAssembly模块做视频处理，实际是PHP提供视频路径或元数据，前端JavaScript加载FFmpeg.wasm等模块在浏览器中完成解码、加水印、编码等操作，PHP仅负责供给资源。
PHP 无法直接运行 WebAssembly 模块做视频处理
WebAssembly（Wasm）运行在浏览器沙箱中，PHP 是服务端语言，两者不在同一执行环境。所谓“结合 PHP 与 WebAssembly 实现前端预览视频加水印”，实际是：PHP 提供视频文件路径或元数据，前端 JavaScript 加载 Wasm 模块（如 FFmpeg.wasm）完成解码、帧提取、Canvas 绘制水印、编码回播等操作——PHP 只负责“供给”，不参与“处理”。
常见误解是以为 exec() 或 shell_exec() 能调起浏览器里的 Wasm，这完全不可行。若你在 PHP 后端尝试用 ffmpeg 命令加水印再返回结果，那属于服务端渲染，和 WebAssembly 无关。
用 FFmpeg.wasm 在前端加水印的最小可行路径
FFmpeg.wasm 是目前最成熟的浏览器端音视频处理方案，支持在 Canvas 上逐帧绘制文字/图片水印，再编码为 MP4 流供 <video> 标签播放。它不依赖 PHP，但需要 PHP 配合提供原始视频 URL（注意跨域）。
- 确保视频资源允许跨域访问：PHP 响应头需包含
Access-Control-Allow-Origin: *或指定域名 - 前端加载时用
fetch()获取视频 blob，传给ffmpeg.FFmpeg实例的writeFile() - 水印位置计算依赖帧宽高，需先用
ffprobe（FFmpeg.wasm 内置）解析视频元信息，再决定drawtext的x/y值 - 文字水印示例命令：
-vf "drawtext=text='©2024':x=w-tw-10:y=h-th-10:fontsize=24:fontcolor=white"，其中tw/th是文字宽高，需 JS 动态估算或用canvas.measureText()
PHP 侧必须规避的三个配置陷阱
即使 PHP 不处理视频，它的配置错误会直接导致前端 Wasm 流程中断：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“PHP免费学习笔记（深入）”；
- PHP 输出缓冲未关闭：若
ob_start()或output_buffering开启，且响应中混入空格或 BOM，会导致前端fetch()返回的 blob 损坏，ffmpeg.writeFile()解析失败并静默卡住 - 大视频文件超时：PHP 默认
max_execution_time=30，虽不参与转码，但若用 PHP 代理视频请求（如readfile($path)），超时会切断流，应改用 Nginx/Apache 直接 serve 静态文件 - Content-Type 错误：PHP 输出视频时若设成
text/plain或未设置，浏览器可能拒绝解析为 blob；正确做法是header('Content-Type: video/mp4')，且确保无额外输出
性能瓶颈不在 PHP，而在浏览器内存与解码能力
一段 60 秒 1080p 视频，在 FFmpeg.wasm 中解码+加水印+重编码，典型耗时 2–8 分钟，内存峰值常超 1.5GB。PHP 对此毫无感知，但用户会遇到：
- Chrome 报
RangeError: WebAssembly.instantiate(): Out of memory：说明 wasm 模块申请内存失败，需降低分辨率（前端用ffmpeg -i input.mp4 -vf scale=640:-1预缩放） - Canvas 绘制水印后黑屏：多数因帧率不匹配，需强制统一
-r 30，避免 FFmpeg.wasm 对非标准帧率处理异常 - 移动端 Safari 完全不工作：iOS Safari 对 WebAssembly 线程和大内存分配限制极严，目前无可靠绕过方案，必须降级为服务端加水印或仅显示静态水印图层
真正要盯住的不是 PHP 日志，而是浏览器开发者工具的 Memory 面板和 WebAssembly 模块的 onRuntimeInitialized 回调是否触发。
