PHP无法直接播放本地音频，只能扫描音频文件生成JSON列表供前端JavaScript通过audio元素播放；需配置Web服务器使音频URL可访问，并用getid3等工具获取时长。
PHP 无法直接播放或“加载”本地音频库
PHP 是服务端脚本语言，不接触浏览器音频 API，也没有内置音频解码/播放能力。所谓“加载本地音频库”，实际是指：用 PHP 扫描、组织音频文件元数据（如 mp3、m4a 路径和标题），再通过 HTML + JavaScript 在前端播放。常见误区是试图用 file_get_contents() 或 readfile() 直接“加载”音频到页面——这只会触发下载或 404，不会自动播放。
用 PHP 扫描本地音频目录并生成 JSON 列表
这是最可控的第一步：让 PHP 读取指定目录下的音频文件，过滤出支持格式，提取基础信息（文件名、大小、时长需额外工具）。注意权限和路径安全，禁止用户传入任意路径遍历。
- 确保 Web 服务器（如 Apache/Nginx）有读取目标目录的权限
- 音频目录建议放在
webroot外（如/var/audio/books/），再用symlink或配置alias映射为可访问 URL - 避免使用
glob("*.mp3")直接暴露绝对路径，应限定根目录并过滤..和非法字符
$_AUDIO_ROOT = '/var/audio/books/';
$files = array_filter(scandir($_AUDIO_ROOT), function($f) {
return in_array(pathinfo($f, PATHINFO_EXTENSION), ['mp3', 'm4a', 'ogg']);
});
$list = [];
foreach ($files as $f) {
$path = $_AUDIO_ROOT . $f;
$list[] = [
'title' => pathinfo($f, PATHINFO_FILENAME),
'url' => '/audio/books/' . rawurlencode($f), // 对应 Nginx alias 或子目录
'size' => filesize($path)
];
}
header('Content-Type: application/json');
echo json_encode($list, JSON_UNESCAPED_UNICODE);
前端用 JavaScript 加载列表并控制 audio 元素
PHP 只负责吐出结构化数据，真正“加载音频库”发生在前端：fetch() 获取列表后，动态渲染播放器 UI，并用 的 src 属性指向音频 URL。关键点是：URL 必须能被浏览器直接 GET 到（即静态资源可访问），且响应头含 Content-Type: audio/mpeg 等正确类型。
- 若音频 URL 返回 403/404，请检查 Nginx/Apache 是否允许该路径下文件被公开访问
- 不要把音频路径拼成
file:///或本地绝对路径——浏览器会拒绝加载 - 移动端 iOS Safari 对自动播放限制极严，必须由用户手势（如点击）触发
play()
fetch('/api/audio-list.php')
.then(r => r.json())
.then(list => {
const player = document.getElementById('audio-player');
list.forEach(item => {
const btn = document.createElement('button');
btn.textContent = item.title;
btn.onclick = () => { player.src = item.url; player.play(); };
document.body.appendChild(btn);
});
});
获取音频时长需额外工具，PHP 本身不支持
getid3 是最常用的 PHP 音频元数据库，能读取 mp3 的 ID3 标签和真实时长（依赖 ffmpeg 更准）。别指望 getimagesize() 或简单计算文件大小来估算时长——码率差异会导致误差极大。
立即学习“PHP免费学习笔记（深入）”；
- 安装
getid3：用 Composerrequire james-heinrich/getid3 - 调用时注意超时和大文件内存占用，建议缓存结果到数据库或 JSON 文件
- 若服务器没装
ffmpeg，getid3可能返回 0 时长；此时可 fallback 到客户端用audio.duration（需先loadmetadata）
时长不是 PHP “加载”的一部分，而是增强体验的可选步骤。跳过它，列表照样能播；加了它，UI 才能显示进度条和总时长。
