PHP无法直接触发朗读完成回调，因其运行在服务端，不接触前端音频事件；实际需前端监听onend/onended等事件后，通过AJAX向PHP接口发送完成通知，PHP则需校验来源、字段、签名并做幂等处理。
PHP 本身无法直接触发朗读完成回调
PHP 是服务端脚本语言，不接触浏览器音频播放、TTS（文本转语音）或插件的运行时事件。所谓“听书插件”的朗读完成回调（如 onSpeechEnd、onComplete），实际发生在前端 JavaScript 环境中——比如 Web Speech API、第三方 TTS SDK（如讯飞听见、百度语音合成 JS SDK）、或基于 标签的播放控制逻辑。
PHP 的角色仅限于：生成页面、提供语音资源 URL、返回待朗读文本、或接收前端发来的完成通知（通过 AJAX）。想让 PHP “触发回调”，本质是让前端在朗读结束后主动通知 PHP。
前端如何检测朗读完成并通知 PHP
关键在于监听前端语音播放/合成的结束事件，并用 fetch 或 XMLHttpRequest 向 PHP 接口提交确认。常见情形：
- 使用 Web Speech API：
speechSynthesis的onend回调最可靠；onpause/onerror也需监听以防中断 - 使用
播放预生成的 MP3：onended事件直接可用 - 使用第三方 SDK（如讯飞）：查文档找类似
onCompleted或onEvent中event === 'END'的判断
示例（Web Speech API + PHP 回调）：
立即学习“PHP免费学习笔记（深入）”；
const utterance = new SpeechSynthesisUtterance('今天天气不错');
utterance.onend = () => {
fetch('https://yoursite.com/callback.php', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
task_id: '20240520123456',
status: 'completed'
})
});
};
speechSynthesis.speak(utterance);
PHP 如何安全接收并处理这个回调
PHP 不是被动“被触发”，而是作为 HTTP 服务端，暴露一个可被前端 POST 调用的接口。必须做几件事防误报和重放：
- 校验请求来源（
$_SERVER['HTTP_ORIGIN']或 Referer，仅作参考，不可全信） - 验证必要字段（如
task_id是否存在、是否符合格式） - 用 token 或时间戳签名（例如前端传
sign=md5(task_id+secret+timestamp)，PHP 侧复算比对） - 幂等处理：插入前先查数据库是否已存在该
task_id的完成记录
简单但可用的 callback.php 骨架：
prepare('INSERT OR IGNORE INTO tts_log (task_id, status, created_at) VALUES (?, ?, ?)');
$stmt->execute([$data['task_id'], 'completed', date('Y-m-d H:i:s')]);
容易忽略的坑：状态不同步与网络不可靠
前端朗读完成 ≠ 用户真正听完了。用户可能中途关闭页面、切走标签页、或网络中断导致回调未发出。因此：
- 不要把“朗读完成回调”当作业务完成的唯一依据（比如发放积分、解锁章节）
- 建议搭配服务端定时任务：对超过 N 分钟仍为“pending”状态的
task_id主动查播放日志或降级标记 - 前端应加错误重试（如失败后 2s、5s、10s 递增重试最多 3 次），并记录到本地
localStorage防刷新丢失 - 若用 WebSocket 维持长连接，可在服务端主动推送完成事件，但复杂度陡增，一般没必要
真正的难点不在“怎么写回调”，而在于如何定义“完成”——是合成结束？播放指针走到末尾？还是用户点击了「我听完了」按钮？得先跟产品对齐语义，再选技术路径。
