ThinkPHP8.0短信发送服务_ThinkPHP8.0短信服务封装【实战】-ThinkPHP-PHP中文网

thinkphp 8.0 不内置短信功能，必须通过接口契约+容器注入方式封装第三方sdk；旧版think-sms等包因移除静态单例、废弃辅助类及php8类型不兼容而失效。

thinkphp8.0短信发送服务_thinkphp8.0短信服务封装【实战】

ThinkPHP 8.0 本身不内置短信发送能力，所有短信服务都必须通过第三方 SDK 封装实现；直接硬套 TP6 的短信类或旧版 topthink/think-sms 包会报错、收不到验证码、甚至导致队列卡死——这不是配置问题，是底层契约已失效。

为什么 TP8 里原封装的短信类不能直接用

TP8 彻底移除了全局函数和静态单例模式，改用容器自动注入 + 接口契约驱动。像老版本中常见的 Sms::send() 或 think\sms\Sms 这类类名，在 TP8 的自动加载规则下根本找不到定义，Composer 安装后也会提示 Class "think\sms\Sms" not found。更关键的是，多数老短信包依赖 think\facade\Cache 或 think\helper\Str 等已被重构/废弃的辅助类，运行时抛出 Call to undefined method 是常态。

TP6 的 think-sms 包未适配 PHP 8.0+ 的类型声明（如 mixed、never）和构造器参数变更
短信网关回调地址路由需走 TP8 的中间件生命周期，旧版直接写 $_POST 会绕过 CSRF 防护和请求验证
日志上下文不再支持 Log::record()，必须用 think\facade\Log + channel() 显式指定通道

推荐封装方式：基于接口 + 容器绑定 + 配置驱动

不写死厂商，不耦合业务逻辑，让 SmsServiceInterface 成为统一入口。实际项目中我用的是阿里云 SMS + 腾讯云 SMS 双通道 fallback 方案，核心结构如下：

第一步：定义接口

interface SmsServiceInterface
{
    public function send(string $phone, string $template, array $data = []): bool;
    public function sendBatch(array $phones, string $template, array $data = []): int;
}

第二步：实现类（以阿里云为例）

class AliyunSmsService implements SmsServiceInterface
{
    protected $client;

    public function __construct(\AlibabaCloud\Client\AlibabaCloud $client)
    {
        $this->client = $client;
    }

    public function send(string $phone, string $template, array $data = []): bool
    {
        try {
            $result = $this->client->rpc()
                ->product('Dysmsapi')
                ->version('2017-05-25')
                ->action('SendSms')
                ->method('POST')
                ->options([
                    'query' => [
                        'PhoneNumbers' => $phone,
                        'TemplateCode' => $template,
                        'TemplateParam' => json_encode($data, JSON_UNESCAPED_UNICODE),
                    ],
                ])
                ->request();
            return $result->getBody()->getContents() !== '';
        } catch (\Exception $e) {
            \think\facade\Log::channel('sms')->error('Aliyun SMS fail', ['phone' => $phone, 'error' => $e->getMessage()]);
            return false;
        }
    }
}

第三步：在 app/provider.php 中绑定

return [
    SmsServiceInterface::class => \app\service\AliyunSmsService::class,
];

这样控制器里就能直接 public function send(SmsServiceInterface $sms) 注入使用，测试时换实现类即可，不用改一行业务代码。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

短信回调必须走 TP8 的事件系统，别再写裸路由

微信/阿里云等平台的短信状态回执（如“发送成功”“到达失败”）是 POST 到你指定 URL 的纯 HTTP 请求，TP6 时代很多人直接在 route/app.php 里写闭包路由处理，但在 TP8 中这会导致：

无法使用中间件（如验签、限流、日志记录）
请求体解析失败（$request->post() 在非标准 Content-Type 下为空）
异常无法被捕获到 app/exception/Handle.php 统一处理

正确做法是注册一个专用事件：

在 app/event.php 中添加：

return [
    'sms.receive.status' => [\app\listener\SmsStatusListener::class],
];

然后在控制器中触发：

public function callback(Request $request)
{
    $raw = $request->getRawBody();
    $data = json_decode($raw, true) ?: $request->param();

    // 验签、格式校验等前置逻辑放这里

    event('sms.receive.status', [$data]);

    return json(['code' => 0, 'msg' => 'ok']);
}

监听器里再做入库、触发通知、重试等动作。这样既解耦，又可复用 TP8 的事务、缓存、队列能力。

容易被忽略的三个硬性约束

不是所有短信 SDK 都能在 TP8 下跑通，部署前务必确认以下三点：

SDK 最低要求 PHP 版本 ≥ 8.0 —— 比如腾讯云 tencentcloud-sdk-php v3.0.1094 才开始正式支持 PHP 8.2，旧版会因 mixed 类型报错
必须关闭 Composer 的 autoloader-suffix（默认开启），否则某些 SDK 的命名空间映射会失效：在 composer.json 中加 "optimize-autoloader": true, "classmap-authoritative": true 并执行 composer dump-autoload -o
生产环境禁用 display_errors 后，SDK 抛出的异常可能静默消失，建议在 config/app.php 中设置 'app_debug' => false 时，强制启用 'log' => ['level' => 'error']