阿里云短信SDK命名空间冲突需分版本解决：PHP 7.4+用composer require alibabacloud/sdk并统一use AlibabaCloud\SDK\Dysmsapi\V20170525\DysmsapiClient；低版本PHP须改namespace为Aliyun*并避免手动require。
阿里云短信 SDK 安装与命名空间冲突怎么解
阿里云老版 PHP SDK（dysms_php.zip）不支持 Composer 自动加载，直接 require 会因 Aliyun\Core\Config 和 Aliyun\Api\Sms\Request\V20170525\SendSmsRequest 等类路径错乱报 Class not found。新版官方推荐用 alibabacloud/sdk，但要注意兼容性断层：
- PHP 7.2+ 才能用
alibabacloud/sdkv2.x；PHP 5.6–7.1 只能退回到aliyuncs/aliyun-sdk（已归档，无维护） -
aliyuncs/aliyun-sdk的DefaultProfile::addEndpoint()在 PHP 8.0+ 会触发Deprecated: Required parameter $region follows optional parameter $product - 若项目用了 ThinkPHP，把 SDK 放进
extend/Aliyun/后，必须统一改所有namespace为Aliyun\*，否则use Aliyun\Core\DefaultProfile会找不到类
最稳的解法是：PHP 7.4+ 直接 composer require alibabacloud/sdk，删掉所有手动 require，用 use AlibabaCloud\SDK\Dysmsapi\V20170525\DysmsapiClient; 走新版客户端。
腾讯云 SmsSingleSender 发送失败常见错误码含义
调用 SmsSingleSender->send() 返回 JSON 后 $json['result'] !== 0 是常态，但错误信息藏得深：
-
"result":1014表示签名未审核通过——不是“没填”，而是控制台里签名状态仍是“审核中” -
"result":1025是模板参数个数不匹配，比如模板写的是「验证码{1}，有效期{2}分钟」，但传的$params = ["1234"]少了一个 -
"result":1019多见于测试阶段：手机号被腾讯云风控拦截，需在控制台「短信管理 → 黑白名单」里加白 - 注意
$ssender->send()第一个参数是$type（0=普通短信，1=营销短信），营销短信必须提前报备模板，否则返回1023
别依赖 $json['errmsg'] == "OK" 判断成功——腾讯云有些错误仍返回 "OK"，但 "result" 非 0，务必校验 result 字段。
立即学习“PHP免费学习笔记（深入）”；
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
两个平台都绕不开的签名与模板审核时效
阿里云和腾讯云对签名和模板都走人工审核，但节奏不同：
- 阿里云签名通常 1–2 小时出结果，模板快则 15 分钟，慢则 24 小时；若填了“网站备案号”，必须和 ICP 备案信息完全一致（连空格、中英文括号都不能差）
- 腾讯云签名审核更严，要求提供可访问的官网截图+域名归属证明；模板若含“抽奖”“返利”等词，大概率驳回，得改成“互动活动”“用户回馈”再试
- 测试期别用真实手机号反复提交——阿里云对同一号码 1 小时内最多发 5 条，腾讯云限制为 10 条，超限后该号码当日收不到任何短信
上线前至少预留 1 个工作日跑完签名→模板→接口联调全链路，别卡在审核环节等上线时间。
生产环境密钥泄漏风险怎么控
硬编码 $accessKeyId 和 $appKey 在代码里是最高危操作，尤其当项目上 Git 或交由第三方运维时：
- 阿里云必须用子账号 + RAM 策略限定仅
Dysmsapi:SendSms权限，主账号 AK 绝对禁止写进代码 - 腾讯云 SDK 不支持从环境变量自动读取
appid/appkey，得自己封装一层：getenv('TENCENT_SMS_APPID') ?: include 'config/sms.php' - ThinkPHP 项目建议把密钥放
config/sms.php并加入.gitignore；Laravel 用.env+config/services.php注入 - 如果用 CI/CD 流水线，密钥必须设为 secret 变量，禁止 echo 输出或写入日志——曾有团队因
error_log($appKey)导致密钥泄露被刷光余额
哪怕只是本地测试，也别图省事把密钥贴在 sendSms.php 顶部。多一步配置，少三天救火。
