华为云语音评测API调用必须使用AK/SK签名认证，PHP需手动拼接X-Sdk-Date、X-Project-Id等请求头并HMAC-SHA256签名；音频须为16kHz单声道PCM格式并Base64编码；得分在response'result'['score']及detail嵌套中；cURL需分设连接与总超时并启用重试。
华为云语音评测 API 的 PHP 调用必须带签名，不签就 403 Forbidden
华为云所有 AI 服务（包括语音评测 speech.asr 和 speech.eval）都强制要求使用 AK/SK 签名认证，不是简单加个 Authorization: Bearer xxx 就能通。PHP 里没现成的 SDK 支持语音评测（speech.eval），得自己拼 X-Sdk-Date、X-Project-Id、Host，再用 HMAC-SHA256 算签名——漏一项，返回就是 403 Forbidden 或 InvalidSignature。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别手写签名逻辑，直接用华为云官方
huaweicloud-sdk-php-core+ 手动注册speech.eval服务（它默认不包含该服务） -
X-Project-Id必须填你所在区域的实际项目 ID（比如华东-上海一对应0123456789abcdef0123456789abcdef），不是控制台显示的“项目名称” - 请求头
Content-Type必须是application/json;charset=utf-8，少一个;charset=utf-8也可能被拒 - 音频必须 Base64 编码后作为
audio字段传入 JSON，不能传文件路径或二进制流
发音准确度（pronunciation）和流利度（fluency）得分来自同一接口，但字段提取位置不同
调用 /v1/{project_id}/assessment/speech 接口返回的 JSON 结构里，pronunciation 和 fluency 不在最外层，而是在 result.detail 数组里的每个音节/词粒度结果中；总分则藏在 result.overall 下的 score 字段里。很多人只扫了一眼顶层字段就以为没返回——其实得分全在深层嵌套里。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先检查响应状态码是否为
200，再读$response['result']['overall']['score']拿总分 - 准确度看
$response['result']['detail'][0]['pronunciation']（首词），流利度看同位置的'fluency'；若要整体评估，得遍历detail数组取平均或加权 - 注意
detail可能为空（如静音过长、无有效语音），此时不能直接取下标[0]，得先isset()判断 - 华为云返回的
pronunciation是 0–100 的整数，但文档没说是否四舍五入——实测有小数位（如87.6），PHP 接收时别用(int)强转丢精度
音频格式和采样率不匹配会导致 InvalidAudioFormat 或低分误判
华为云语音评测明确要求输入音频为 PCM 编码、单声道、16bit、采样率 16kHz（audio/L16;rate=16000;channels=1）。PHP 里用 file_get_contents() 直接读 MP3/WAV 文件上传，基本必错——WAV 头没剥离、MP3 没转 PCM，都会触发 InvalidAudioFormat 错误，或者更隐蔽地导致评测分数严重偏低（比如把正常发音判成“不连贯”）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 本地预处理用
ffmpeg命令转格式：ffmpeg -i input.mp3 -ac 1 -ar 16000 -f s16le -vn output.pcm，再读output.pcm - PHP 中不要用
getimagesize()类函数判断音频类型，它对 PCM 无效；改用finfo_open(FILEINFO_MIME_TYPE)看 MIME 是否为audio/x-pcm - 如果前端传的是录音 Blob，JavaScript 侧需确保 MediaRecorder 输出为
audio/webm; codecs=pcm（实际支持有限），更稳的方式是前端录成 WAV 再用 JS 库（如web-audio-recorder-js）转 PCM ArrayBuffer
PHP cURL 默认超时太短，语音评测常因响应延迟被中断
语音评测接口平均响应在 800ms–2s 之间（尤其带长句或网络抖动时），而 PHP curl_setopt($ch, CURLOPT_TIMEOUT, 30) 看似够用，但这是整个请求周期（DNS+连接+上传+等待+下载）的总限时。一旦上传 PCM 数据稍大（比如 30 秒音频约 960KB），上传阶段就可能吃掉 2s+，后面留给服务处理的时间只剩不到 1s，直接触发 CURLOPT_TIMEOUT 断连，返回空响应或 000 状态码。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 拆开设超时：
CURLOPT_CONNECTTIMEOUT_MS设为5000（5秒连通），CURLOPT_TIMEOUT_MS设为15000（15秒总耗时） - 启用
CURLOPT_TCP_NODELAY减少小包延迟，对上传 PCM 有明显改善 - 加一层重试：遇到
000或504时，等 500ms 后重发一次（华为云接口幂等，可安全重试） - 别用
file_get_contents()+stream_context_create()调语音评测——它不支持细粒度超时控制，出问题难定位
真正卡住的地方往往不是算法逻辑，而是签名算错一位、PCM 少转一个参数、或者 cURL 超时设在了错误的位置。这些点不踩一遍，光看文档根本意识不到。
