PHP无法直接解析音频波形，必须借助ffmpeg+audiowaveform等外部工具生成下采样JSON数据供前端渲染，纯PHP读WAV头画图仅适用于极简单声道PCM，实际项目不可用。
PHP本身不直接解析音频波形，上传后必须借助外部工具或服务完成解码与采样——纯PHP读WAV头+画图只能应付极简单声道PCM，真实项目里基本不可用。
为什么不能只用PHP读WAV文件画波形
WAV文件包含格式头、元数据和原始样本数据，但PHP没有内置音频解码能力。即使你手动解析data块，也会立刻撞上几个硬伤：
- 多声道（立体声）需先做通道合并或选左/右通道，PHP没现成函数做加权平均
- 16-bit PCM样本是小端有符号整数，直接
unpack('v*', $data)后不转成[-1, 1]浮点区间，画出来的图全压在底部 - 一个2分钟44.1kHz单声道WAV有超500万个样本，全读进内存再遍历画图，PHP会OOM或超时
- 浏览器端要显示波形图，最终得输出PNG，而PHP的
imagecreatetruecolor画万级像素点效率极低，且无法抗锯齿
推荐方案：用ffmpeg + audiowaveform生成JSON波形数据
这是目前最稳、最轻量、也最容易集成到PHP流程里的做法。关键不是“PHP画图”，而是“PHP调用命令行工具生成可前端渲染的数据”。
步骤如下：
立即学习“PHP免费学习笔记（深入）”；
- 用户上传MP3/WAV后，PHP用
exec()调用ffmpeg统一转成标准WAV（避免编码兼容问题）：ffmpeg -i uploaded.mp3 -ar 44100 -ac 1 -f wav -y normalized.wav - 再调用
audiowaveform生成下采样后的JSON波形点：audiowaveform -i normalized.wav -o waveform.json -z 256 -b 8
其中-z 256表示水平方向每256个原始样本取1个峰值，-b 8表示用8位精度存振幅（0–255） - PHP把
waveform.json内容读出，用json_decode()转成数组，传给前端JS（比如用canvas或svg渲染）
注意：audiowaveform比ffmpeg -i x.mp3 -filter_complex showwavespic更可靠——后者生成的是静态图，缩放失真；前者给的是原始振幅序列，前端可自由缩放、拖动、高亮播放位置。
PHP调用时容易被忽略的坑
很多PHP脚本卡在“执行了命令但没返回结果”，其实问题不在代码逻辑，而在环境权限和路径：
-
exec()默认被禁用？检查php.ini中disable_functions是否含exec,shell_exec,system，删掉再重启PHP-FPM - ffmpeg/audiowaveform不在
$PATH？务必写绝对路径，例如/usr/local/bin/ffmpeg，别信which ffmpeg在Web用户下能生效 - 上传临时文件
$_FILES['audio']['tmp_name']可能被PHP回收？先move_uploaded_file()到你可控的目录（如/tmp/uploads/），再传给ffmpeg - 权限错误？确保Web用户（如
www-data）对临时目录和ffmpeg二进制都有读/执行权限，chmod +x /usr/local/bin/audiowaveform - 超时？大文件处理时间长，临时加
set_time_limit(300)，但更稳妥的是异步：上传完立即返回任务ID，后台用队列（如Redis+Worker）跑命令，前端轮询结果
如果服务器不允许装第三方工具，只能用PHP+FFmpeg扩展
走php-ffmpeg/php-ffmpeg库路线，它底层还是调ffmpeg，但封装了异常捕获和路径管理：
- 安装：
composer require php-ffmpeg/php-ffmpeg - 关键不是“生成图”，而是“拿到样本统计值”：
用$audio->getStreams()->audios()[0]->get('codec_name')确认编码可用；
再用ffprobe提取时长、采样率：$ffprobe->streams($file)->videos()（注意音频流要查audios()） - 它不提供波形点提取接口，所以仍得自己拼
exec()调ffmpeg -i x.mp3 -filter:v showwavespic=s=1200x200:mode=point生成PNG占位图——适合仅需封面图的场景，但无法交互
真正需要拖动定位、点击跳转的波形，永远绕不开“原始振幅序列”。这点无论前端用WaveSurfer.js还是自研Canvas渲染，数据源头都得是下采样后的浮点或整型数组，而不是一张PNG。
