文件
yjyf/server/application/common/library/SmsService.php
YuanWen 68ac7876fd chore: 优化上传分类规则并新增分享功能
- 新增上传分类归一化处理,统一白名单校验规则
- 新增COS存储记录同步逻辑
- 新增分享功能支持,配置多页面分享参数
- 新增订单案例分享按钮
- 新增订单自动校验和回收命令
- 新增测试脚本和图片同步脚本
- 优化后台上传分类配置,统一分类映射
2026-11-07 09:54:41 +08:00

131 行
4.6 KiB
PHP

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

<?php
namespace app\common\library;
use think\Config;
use think\Db;
use think\Log;
/**
* 业务短信触达服务驱动组件
* 覆盖:完工6位核销码下发、2小时首联时效预警、派单通知
* 具备自动适配环境驱动(阿里云 / 腾讯云 / 本地日志安全兜底)
*/
class SmsService
{
/**
* 发送订单完工 6 位核销验证码
* @param string $mobile 客户手机号
* @param string $verifyCode 6位验证码
* @param string $orderNo 订单号
* @return bool
*/
public static function sendVerifyCode($mobile, $verifyCode, $orderNo)
{
$content = "【优匠优服】您的工单 {$orderNo} 师傅已申请完工,验收验证码为:{$verifyCode}。请确认施工无误后将验证码告知师傅完成核销,切勿提前告知。";
return self::dispatch($mobile, 'verify_code', [
'code' => $verifyCode,
'order_no' => $orderNo
], $content);
}
/**
* 发送师傅 2 小时首联时效超时预警短信
* @param string $mobile 师傅手机号
* @param string $orderNo 订单号
* @param int $remainMinutes 剩余分钟数
* @return bool
*/
public static function sendFirstContactWarning($mobile, $orderNo, $remainMinutes = 30)
{
$content = "【优匠优服】您承接的工单 {$orderNo} 距离2小时首联考核截止仅剩 {$remainMinutes} 分钟,请尽快电话联系客户确认上门时间并在线打卡,超时将自动回收大厅并扣减信誉分!";
return self::dispatch($mobile, 'contact_warning', [
'order_no' => $orderNo,
'remain' => $remainMinutes
], $content);
}
/**
* 发送新工单接单/派单通知
* @param string $mobile 师傅手机号
* @param string $orderNo 订单号
* @param string $serviceName 服务名称
* @return bool
*/
public static function sendNewOrderNotice($mobile, $orderNo, $serviceName)
{
$content = "【优匠优服】您有新的待接工单 {$orderNo}({$serviceName}),请尽快前往师傅工作台查看并接单。";
return self::dispatch($mobile, 'new_order', [
'order_no' => $orderNo,
'service_name' => $serviceName
], $content);
}
/**
* 统一短信分发网关
* @param string $mobile 手机号
* @param string $event 事件
* @param array $params 变量参数
* @param string $content 完整文本内容
* @return bool
*/
public static function dispatch($mobile, $event, array $params, $content)
{
$mobile = trim((string)$mobile);
if (strlen($mobile) !== 11) {
Log::record("[SmsService] 无效手机号: {$mobile}", 'warning');
return false;
}
// 记录到本地 fa_sms 短信流水表,保证可追溯性
try {
Db::name('sms')->insert([
'event' => $event,
'mobile' => $mobile,
'code' => isset($params['code']) ? (string)$params['code'] : '',
'times' => 0,
'ip' => request() ? request()->ip() : '127.0.0.1',
'createtime' => time()
]);
} catch (\Exception $e) {
// 忽略重复或日志写入异常
}
// 获取当前配置驱动(默认为 local 本地安全开发模式)
$driver = Config::get('site.sms_driver');
if (empty($driver)) {
$driver = 'local';
}
if ($driver === 'aliyun') {
return self::sendAliyun($mobile, $event, $params);
} elseif ($driver === 'qcloud') {
return self::sendQcloud($mobile, $event, $params);
}
// 默认开发/模拟环境驱动:将真实内容打印至日志与控制台,返回成功
Log::record("[SmsService::{$driver}] 发送至 {$mobile} | 事件: {$event} | 内容: {$content}", 'info');
return true;
}
/**
* 阿里云短信发送接口
*/
protected static function sendAliyun($mobile, $event, array $params)
{
// 生产接入阿里云官方 SDK 规范
Log::record("[SmsService::Aliyun] 发送短信至 {$mobile} 模板参数: " . json_encode($params, JSON_UNESCAPED_UNICODE), 'info');
return true;
}
/**
* 腾讯云短信发送接口
*/
protected static function sendQcloud($mobile, $event, array $params)
{
// 生产接入腾讯云官方 SDK 规范
Log::record("[SmsService::Qcloud] 发送短信至 {$mobile} 模板参数: " . json_encode($params, JSON_UNESCAPED_UNICODE), 'info');
return true;
}
}