PHP 8.5 调用阿里云短信 SDK 报 Class not found 是因使用已归档的旧版 SDK，须改用 composer require alibabacloud/dysmsapi（≥3.0.0），初始化用 AlibabaCloud\Dysmsapi\Dysmsapi，并通过 Credential 实例传密钥、显式指定 Region。
PHP 8.5 调用阿里云短信 SDK 报 Class "AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi" not found
这是最常见问题：阿里云新版 SDK（v3+）已废弃旧版 Dysmsapi 命名空间，PHP 8.5 下直接 require 旧示例代码必然报错。新版统一走 AlibabaCloud\TeaOpenApi + AlibabaCloud\Dysmsapi 分离式设计，且最低要求 PHP 8.0+，PHP 8.5 完全兼容，但必须用对版本。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 删掉所有基于
aliyun-openapi-php-sdk（旧版，GitHub 已归档）的代码和vendor/aliyun目录 - 用 Composer 安装新版：
composer require alibabacloud/dysmsapi（注意不是aliyun-openapi-php-sdk） - 确认
composer show alibabacloud/dysmsapi输出版本 ≥3.0.0，低于此版本仍可能触发命名空间错误 - 初始化客户端时不再 new
Dysmsapi，而是 newAlibabaCloud\Dysmsapi\Dysmsapi（注意完整命名空间）
PHP 8.5 下 sendSms 调用返回 InvalidAccessKeyId.NotFound
不是密钥写错了，大概率是 Credential 初始化方式不匹配新版 SDK 的运行时校验逻辑。PHP 8.5 对对象属性动态赋值更严格，旧写法如 $config->accessKeyId = ... 在新 SDK 中会被忽略，导致默认用空值签名。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须使用
AlibabaCloud\Credentials\Credential实例传参，不能手动拼 config 数组 - 正确写法：
$credential = new Credential('<code>your-access-key-id', 'your-access-key-secret'); - Region 必须显式指定（如
cn-hangzhou），不能依赖默认值；阿里云短信仅在部分 Region 开通，cn-shanghai或cn-beijing可能返回权限错误 - 检查
ALIYUN_ACCESS_KEY_ID和ALIYUN_ACCESS_KEY_SECRET环境变量是否被 .env 或框架配置覆盖——PHP 8.5 的getenv()默认不从 $_ENV 读取，需设putenv("foo=bar")或用$_SERVER
发送成功但收不到短信，或提示 isv.BUSINESS_LIMIT_CONTROL
这不是代码问题，是阿里云侧的业务限制触发。PHP 8.5 运行快、并发高，容易在测试阶段短时间触发频控，尤其用本地环境反复执行脚本时。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查短信签名与模板是否“已通过审核”且“已启用”，草稿状态或审核驳回会静默失败
- 单个手机号 24 小时内最多接收 10 条（默认），测试时用不同号码轮换，别死磕一个号
- 模板变量传参必须严格匹配审核时的格式，比如审核模板是“验证码${code}”，你传
['code' => '1234']才行；传['verify_code' => '1234']会触发BUSINESS_LIMIT_CONTROL - 国内短信必须带
PhoneNumbers（字符串，逗号分隔多个号），不能是数组；国际短信要用PhoneNumber字段且加国家码（如+8613800138000）
PHP 8.5 + Swoole / Hyperf 环境下复用 Client 导致内存泄漏
新版 SDK 内部使用了静态连接池和全局 HTTP 客户端实例，如果在常驻进程中每次请求都 new 一个 Dysmsapi，TCP 连接不会自动释放，几个小时后 fd 耗尽，报 Too many open files。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- Client 实例必须单例化，不要在控制器方法里 new —— 放到 DI 容器或 static 属性中
- 禁用 SDK 自动重试（默认 3 次）：
$client->setRetryConfig(['retryPolicy' => 'none']);，避免异常时堆积连接 - 若用 Hyperf，推荐封装为
SmsService并标注@Inject，由框架管理生命周期 - 上线前用
lsof -p $(pgrep php)观察 ESTABLISHED 连接数变化，突增即说明复用失效
真正麻烦的是签名审核和模板变量名大小写——阿里云后台显示的“模板CODE”和实际 API 里要传的 TemplateCode 字段值未必一致，中间可能混入下划线或大小写转换，这个只能去控制台逐字比对，复制粘贴都救不了。
