最可靠方式是用 ffprobe 直接读取音频时长,它100%兼容主流格式且不依赖文件头;需确保 PHP 启用 shell_exec、ffprobe 在 PATH 或用绝对路径、文件权限正确,并以浮点数存储时长避免精度丢失。

用 ffprobe 直接读取音频元信息最可靠
PHP 自带的 getid3 库或 exif_read_data 对音频支持弱,尤其对 MP3、M4A、OGG 等格式时长识别常不准甚至报错。生产环境建议绕过 PHP 扩展,直接调用系统级工具 ffprobe(FFmpeg 套件中的轻量元数据提取工具),它几乎 100% 兼容主流音频格式,且不依赖文件头完整性。
实操建议:
- 确认服务器已安装 FFmpeg:运行
ffprobe -version,若返回版本号即可;没装则需apt install ffmpeg(Debian/Ubuntu)或brew install ffmpeg(macOS) - 上传后拿到音频绝对路径,例如
/var/www/uploads/song.mp3 - 用
shell_exec()执行命令,注意过滤非法字符防止命令注入:escapeshellarg($filepath) - 推荐命令模板:
ffprobe -v quiet -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 {filepath},它只输出纯数字秒数(如213.45),便于后续类型转换
shell_exec 返回空或报错的常见原因
不是代码写错,而是权限和上下文问题居多。
常见错误现象与应对:
-
shell_exec返回null或空字符串 → 检查 PHP 是否禁用了该函数(disable_functions中是否含shell_exec),查看phpinfo()的disable_functions行 - 返回错误信息类似
/bin/sh: ffprobe: not found→ffprobe不在 PHP 进程的$PATH中,改用绝对路径调用,例如/usr/bin/ffprobe(用which ffprobe查准路径) - 返回
Permission denied→ 上传目录或临时文件被 web 用户(如www-data)无权读取,确保chown www-data:www-data $filepath或至少chmod 644 $filepath - 超时中断(尤其大文件)→ 设置执行时限:
set_time_limit(30),并捕获 stderr:2>&1加到命令末尾方便调试
PHP 层做兜底:用 getid3 仅当 ffprobe 不可用
别把 getid3 当主力,它适合本地开发快速验证,但线上音频来源不可控(比如用户上传的损坏 MP3、非标准 ID3 标签、采样率异常的 WAV),getid3 极易返回 0 或抛出 Warning。
如果真要集成,注意三点:
- 务必用最新版
getID3(v1.9.20+),旧版对 AAC/M4A 支持差 - 初始化后必须调用
$getID3->analyze($filepath),再从$info['playtime_seconds']取值,不是$info['duration'] - 加
@抑制 Warning,但别忽略返回值是否为 float:若$info['playtime_seconds'] ,视为失败,切回ffprobe或报错
精度与单位:别直接用整数秒存数据库
音频时长本质是浮点值(如 187.923 秒),强制 (int) 截断会丢失精度,前端播放器进度条可能跳变。更麻烦的是,不同格式时间戳精度不同:MP3 常精确到毫秒,WAV 可能只到帧(如 44.1kHz 下一帧 ≈ 0.023ms)。
存储和传输建议:
- MySQL 存为
DECIMAL(10,3),够存 27 小时内任意精度时长 - JSON 输出给前端时保留小数点后三位(
number_format($duration, 3, '.', '')),避免 PHP 默认科学计数法 - 前端计算进度百分比时,用原始浮点值参与运算,别先四舍五入再除
真正难处理的是用户上传的“无声音频”或“静音 MP3”——ffprobe 能正确返回时长,但播放器可能因编码问题卡住。这类边界情况得靠前端试播 + 后端异步校验双保险,单靠 PHP 提取时长解决不了。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











