php调用听书插件前必须确认curl、json、mbstring扩展已启用，系统已安装espeak等cli工具并授权web用户执行，php版本与sapi模式匹配，openssl证书配置正确，音频目录可写且mime类型支持完备。
PHP 调用听书插件前必须确认的运行时依赖
绝大多数听书类插件（如基于 TTS 服务的封装库或第三方 SDK）不是纯 PHP 实现，往往依赖外部系统组件。不提前检查这些，require 或 exec() 会直接失败，且错误信息常指向“找不到命令”或“扩展未启用”，而非真实原因。
-
php-curl扩展必须启用——几乎所有云 TTS 接口（阿里云、腾讯云、百度语音）都走 HTTPS API，禁用后file_get_contents()或curl_init()会报curl_init(): undefined function - 若插件含本地语音合成（如 eSpeak、Festival），需在系统级安装对应 CLI 工具，并确保 PHP 进程有执行权限：
which espeak必须返回路径，且 Web 用户（如www-data）能调用 - 部分插件依赖
json和mbstring，PHP 编译时未开启会导致json_encode()报错或中文乱码，检查用php -m | grep -E "json|mbstring"
常见听书插件对 PHP 版本和 SAPI 的隐性要求
很多开源听书类 Composer 包（如 overtrue/tts、aliyun-openapi-php-sdk）在 composer.json 中声明了 php >= 7.4，但实际运行时，Apache + mod_php 和 CLI 模式表现不同——尤其涉及音频流输出或长连接时。
- CLI 模式下可稳定调用
sleep()或处理大音频文件；而 Apache 模块下默认max_execution_time=30，TTS 合成稍长就会中断，需在代码中加set_time_limit(0)或改配置 - PHP 8.1+ 的
enum类型被部分新版本 SDK 使用，若你还在跑 PHP 7.4，强行composer install会提示Declaration of ... must be compatible with ... - 某些插件内部用
proc_open()启动 FFmpeg 转码，而 Windows IIS 的 CGI 模式默认禁用该函数，需手动在php.ini中取消注释disable_functions = proc_open
网络与证书：HTTPS 调用失败的三大隐藏原因
听书插件几乎全部依赖 HTTPS 请求，但 PHP 的 OpenSSL 配置常被忽略，导致 cURL error 60: SSL certificate problem 这类错误反复出现。
- Linux 系统需确认 CA 证书路径是否正确：检查
openssl.cafile是否指向有效的ca-bundle.crt（如/etc/ssl/certs/ca-certificates.crt） - 若使用自建代理或内网环境，插件调用时未显式设置
CURLOPT_SSL_VERIFYPEER => false（不推荐生产环境），或未传入正确的CURLOPT_CAINFO - 阿里云、腾讯云等 SDK 默认启用
http_build_query()拼参，若 PHP 的urlencode()行为因mbstring.func_overload被修改，会导致签名验签失败，错误表现为InvalidSignature
音频输出环节最容易被忽略的权限与路径问题
插件生成的 MP3/WAV 文件若无法写入或播放，90% 不是代码问题，而是目录权限或 Web 服务器沙箱限制。
立即学习“PHP免费学习笔记（深入）”；
- 确保目标目录（如
./audio/）对 Web 进程用户可写：chown www-data:www-data audio/ && chmod 755 audio/，仅777是危险且无效的惯性操作 - 部分插件默认用
sys_get_temp_dir()存临时音频，而 Docker 容器或共享主机中该路径可能不可写或空间不足，需通过构造函数或配置项显式指定temp_path -
浏览器直接访问生成的音频 URL 失败？检查 Web 服务器是否允许
.mp3MIME 类型，Nginx 需在mime.types中包含audio/mpeg mp3，Apache 需启用mod_mime
// 示例：检查关键扩展是否就绪（放入 webroot 下运行）
<?php
$required = ['curl', 'json', 'mbstring'];
foreach ($required as $ext) {
if (!extension_loaded($ext)) {
die("Missing PHP extension: {$ext}");
}
}
echo "All extensions OK.\n";
?>
别只盯着插件文档里的 composer require，真正卡住的永远是 phpinfo() 里那几行没注意的配置项。 
