小米AI语音识别无官方PHP SDK，需用PHP通过HTTP请求调用/v1/asr接口：先OAuth2.0获取access_token，再以multipart/form-data上传WAV音频（16kHz、单声道、PCM），注意token缓存、超时设置及音频预处理。
小米AI语音识别PHP SDK不提供官方支持
直接调用小米AI语音识别服务，PHP没有官方SDK。你搜到的所谓“小米语音PHP包”，基本是第三方非维护项目或简单封装，稳定性、鉴权方式、接口版本都不可靠。
真正可行路径只有一条：用PHP发起标准HTTP请求，对接小米开放平台的 /v1/asr 接口（ASR即Automatic Speech Recognition）。前提是已申请小米AI开放平台账号、创建应用、获取 client_id 和 client_secret。
- 小米语音API要求上传音频为WAV格式（PCM编码，16kHz采样率，单声道），不是MP3或AMR —— PHP里用
ffmpeg转码必须提前做 - 鉴权用OAuth2.0流程：先用
client_id和client_secret换取access_token，再在后续请求头中带上Authorization: Bearer {token} - 每次请求需携带
app_id（你在后台看到的“应用ID”），它和client_id不是一回事，别填错
POST音频文件到/v1/asr必须用multipart/form-data
小米接口不接受base64字符串或JSON body传音频，只认multipart/form-data表单里的file字段。PHP用cURL发请求时，CURLOPT_POSTFIELDS必须传数组，不能传JSON字符串。
常见错误现象：{"code":400,"message":"invalid file"} 或 {"code":401,"message":"invalid token"} —— 前者大概率是file没传对，后者多因token过期（有效期2小时）或app_id不匹配。
立即学习“PHP免费学习笔记（深入）”；
- PHP 5.6+可用
curl_file_create()构造上传文件句柄；PHP 8.1+推荐用CURLFile类 - 音频文件路径必须是服务器本地绝对路径，不能是URL或相对路径
- 务必设置
Content-Type为audio/wav，且文件扩展名得是.wav（哪怕内容是PCM） - 示例关键片段：
curl_setopt($ch, CURLOPT_POSTFIELDS, [ 'file' => new CURLFile('/tmp/record.wav', 'audio/wav', 'audio.wav') ]);
返回结果里text字段可能为空或延迟返回
小米ASR接口分同步和异步两种模式。文档里写的/v1/asr是同步接口，但实际响应时间受网络、音频长度、服务负载影响——超过15秒没返回，cURL会超时，PHP就收不到text。
更麻烦的是：即使请求成功，返回JSON里"text"可能是空字符串，或只有标点符号。这不是PHP问题，而是语音质量差、背景噪音大、语速过快导致识别失败。
- 建议在PHP里加
curl_setopt($ch, CURLOPT_TIMEOUT, 30)，避免默认30秒不够用 - 检查返回HTTP状态码是否为200，再解析JSON；别直接
json_decode($res)->text，要先判断isset($data->text) - 用户端录音建议加静音检测（VAD），截掉开头结尾空白段，能显著提升识别率
- 如果业务允许，可降级处理：识别失败时返回固定提示，比如
"请再说一遍"，而不是抛异常
生产环境必须处理access_token缓存与刷新
每次调用ASR前都要先取token，但token有效期仅2小时。如果每识别一次都重新请求token接口，既慢又容易触发限流（小米默认QPS限制严格）。
最简方案是在PHP里用文件或Redis缓存access_token和过期时间戳，每次调用前先检查是否快过期（比如提前5分钟刷新）。
- 不要把
client_secret硬编码在PHP文件里，应通过环境变量读取（如getenv('XIAOMI_CLIENT_SECRET')） - token刷新失败时，需有fallback逻辑（比如记录日志、返回降级响应），不能让整个语音功能瘫痪
- 小米token接口返回的
expires_in单位是秒，注意换算成时间戳存入缓存
