PHP 缓存音频需先校验本地文件是否存在且未过期，再下载并写入；用 readfile() 流式输出避免内存溢出；元数据可用 APCu 缓存，但音频本体必须存文件系统；Web 服务器应直接服务静态音频文件。
PHP 本身不直接“调用听书插件”，也没有内置的“听书插件”概念——所谓“听书”功能，本质是后端通过 PHP 下载、代理或生成音频 URL，前端（如微信小程序、H5 页面）播放。缓存音频文件的关键不在插件，而在你如何设计 PHP 的文件获取 + 存储 + 响应逻辑。
用 file_get_contents + file_put_contents 下载并缓存远程音频
这是最常见也最容易出问题的方式：每次请求都重新下载，没加锁、没校验、没过期控制，容易重复拉取大文件或导致并发写入损坏。
- 务必先检查本地缓存是否存在且未过期（比如用
filemtime()判断是否超过 24 小时） - 下载前用
is_writable()确认缓存目录可写，否则静默失败 - 下载时用
stream_context_create()设置超时（'timeout' => 30），避免卡死 - 写入后用
clearstatcache()避免后续file_exists()返回旧缓存结果
if (file_exists($cache_path) && time() - filemtime($cache_path) < 86400) {
$audio_content = file_get_contents($cache_path);
} else {
$context = stream_context_create(['http' => ['timeout' => 30]]);
$audio_content = file_get_contents($remote_url, false, $context);
if ($audio_content !== false) {
file_put_contents($cache_path, $audio_content);
clearstatcache(true, $cache_path);
}
}用 readfile() 流式输出缓存文件，避免内存溢出
音频文件动辄几 MB～几十 MB，若用 echo file_get_contents($path)，PHP 进程会把整个文件读进内存再吐出去，极易触发 Allowed memory size exhausted 错误。
- 必须用
readfile()直接输出文件内容到响应体 - 输出前手动设置正确的
Content-Type（如audio/mpeg对应 MP3）和Content-Length（用filesize()） - 加上
ob_end_clean()和flush()避免被输出缓冲干扰 - 不要在输出音频前有任何
echo、var_dump或空格输出，否则 HTTP 头会发送失败
if (file_exists($cache_path)) {
ob_end_clean();
header('Content-Type: audio/mpeg');
header('Content-Length: ' . filesize($cache_path));
header('Accept-Ranges: bytes');
readfile($cache_path);
exit;
}用 apcu_cache 缓存小音频元数据，别缓存音频本体
APCu / Redis 等内存缓存适合存 URL 映射、有效期、文件大小等轻量信息，**不适合缓存几 MB 的音频二进制流**——会迅速吃光内存，还可能触发 APCu 的单值大小限制（默认约 1MB）。
立即学习“PHP免费学习笔记（深入）”；
- 只缓存
$audio_info = ['url' => $remote_url, 'expires' => time() + 86400] - 用
apcu_store('audio_meta_' . $book_id, $audio_info, 86400) - 真正读取音频时仍走文件系统，内存缓存只做“路由”和“状态”判断
- 如果必须用 Redis，也只存路径（如
/cache/123.mp3），而非文件内容
注意 Nginx/Apache 的静态文件缓存配置，别让 PHP 白忙
即使 PHP 正确生成了缓存文件，如果 Web 服务器没配好，浏览器每次仍会发请求到 PHP 脚本，而不是直接读取磁盘上的 MP3 文件。
- 把音频缓存目录放在 Web 可访问路径下（如
/public/audio_cache/） - Nginx 中加 location 规则，对
.mp3、.m4a后缀直接返回静态文件，并设置expires 7d - 确保 PHP 脚本生成的文件权限为
644，Web 用户（如www-data）有读取权 - 避免用
index.php?audio=123这种方式暴露 PHP 入口——直接返回/audio_cache/123.mp3让 Web 服务器接管更高效
真正难的不是“怎么缓存”，而是怎么让缓存路径可预测、可清理、可监控；以及当多个用户同时请求同一本听书时，如何避免 10 个进程同时去下载同一个远程音频。这些细节没处理好，缓存反而会变成性能瓶颈和故障源。
