PHPAPI短信发送怎么集成

wen PHP项目 2026-07-06 191

本文目录导读：

PHPAPI短信发送怎么集成

基本集成步骤
具体服务商集成示例
验证码发送示例
最佳实践建议
注意事项

我将为您详细介绍PHP集成API短信发送的完整流程，这里以常见的短信服务商为例（如阿里云短信、腾讯云短信等）。

基本集成步骤

1 准备工作

// 1. 注册短信服务商账号
// 2. 获取API密钥（AccessKey/SecretKey）
// 3. 申请短信签名和模板

2 通用发送函数

<?php
/**
 * 短信发送通用函数
 */
class SmsService {
    private $apiKey;
    private $apiSecret;
    private $signName; // 短信签名
    public function __construct($apiKey, $apiSecret, $signName) {
        $this->apiKey = $apiKey;
        $this->apiSecret = $apiSecret;
        $this->signName = $signName;
    }
    /**
     * 发送短信
     * @param string $phone 手机号码
     * @param string $templateCode 模板代码
     * @param array $params 模板参数
     * @return bool
     */
    public function send($phone, $templateCode, $params = []) {
        // 具体实现取决于短信服务商
        return $this->callApi($phone, $templateCode, $params);
    }
}

具体服务商集成示例

1 阿里云短信集成

<?php
// 需要安装阿里云SDK: composer require alibabacloud/dysmsapi
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;
class AliyunSmsService {
    private $accessKeyId;
    private $accessKeySecret;
    private $signName;
    public function __construct($accessKeyId, $accessKeySecret, $signName) {
        $this->accessKeyId = $accessKeyId;
        $this->accessKeySecret = $accessKeySecret;
        $this->signName = $signName;
        // 初始化客户端
        AlibabaCloud::accessKeyClient($accessKeyId, $accessKeySecret)
            ->regionId('cn-hangzhou')
            ->asDefaultClient();
    }
    /**
     * 发送短信
     */
    public function sendSms($phone, $templateCode, $templateParam = []) {
        try {
            $result = AlibabaCloud::rpc()
                ->product('Dysmsapi')
                ->version('2017-05-25')
                ->action('SendSms')
                ->method('POST')
                ->host('dysmsapi.aliyuncs.com')
                ->options([
                    'query' => [
                        'RegionId' => 'cn-hangzhou',
                        'PhoneNumbers' => $phone,
                        'SignName' => $this->signName,
                        'TemplateCode' => $templateCode,
                        'TemplateParam' => json_encode($templateParam),
                    ],
                ])
                ->request();
            $response = $result->toArray();
            if ($response['Code'] == 'OK') {
                return [
                    'success' => true,
                    'message' => '发送成功',
                    'data' => $response
                ];
            } else {
                return [
                    'success' => false,
                    'message' => $response['Message'],
                    'code' => $response['Code']
                ];
            }
        } catch (ClientException $e) {
            return [
                'success' => false,
                'message' => $e->getErrorMessage()
            ];
        } catch (ServerException $e) {
            return [
                'success' => false,
                'message' => $e->getErrorMessage()
            ];
        }
    }
}
// 使用示例
$sms = new AliyunSmsService('your_access_key_id', 'your_access_key_secret', '您的签名');
$result = $sms->sendSms('13800138000', 'SMS_123456789', ['code' => '123456']);

2 腾讯云短信集成

<?php
// 需要安装腾讯云SDK: composer require tencentcloud/tencentcloud-sdk-php
use TencentCloud\Common\Credential;
use TencentCloud\Common\Profile\ClientProfile;
use TencentCloud\Common\Profile\HttpProfile;
use TencentCloud\Sms\V20190711\SmsClient;
use TencentCloud\Sms\V20190711\Models\SendSmsRequest;
class TencentSmsService {
    private $secretId;
    private $secretKey;
    private $appId;
    private $signName;
    public function __construct($secretId, $secretKey, $appId, $signName) {
        $this->secretId = $secretId;
        $this->secretKey = $secretKey;
        $this->appId = $appId;
        $this->signName = $signName;
    }
    /**
     * 发送短信
     */
    public function sendSms($phone, $templateId, $templateParams = []) {
        try {
            $cred = new Credential($this->secretId, $this->secretKey);
            $httpProfile = new HttpProfile();
            $httpProfile->setEndpoint('sms.tencentcloudapi.com');
            $clientProfile = new ClientProfile();
            $clientProfile->setHttpProfile($httpProfile);
            $client = new SmsClient($cred, 'ap-guangzhou', $clientProfile);
            $req = new SendSmsRequest();
            $req->SmsSdkAppid = $this->appId;
            $req->Sign = $this->signName;
            $req->TemplateID = $templateId;
            $req->PhoneNumberSet = ['+86' . $phone];
            $req->TemplateParamSet = $templateParams;
            $resp = $client->SendSms($req);
            $result = json_decode($resp->toJsonString(), true);
            if ($result['SendStatusSet'][0]['Code'] == 'Ok') {
                return [
                    'success' => true,
                    'message' => '发送成功',
                    'data' => $result
                ];
            } else {
                return [
                    'success' => false,
                    'message' => $result['SendStatusSet'][0]['Message'],
                    'code' => $result['SendStatusSet'][0]['Code']
                ];
            }
        } catch (\Exception $e) {
            return [
                'success' => false,
                'message' => $e->getMessage()
            ];
        }
    }
}
// 使用示例
$sms = new TencentSmsService('your_secret_id', 'your_secret_key', '1400xxxxxx', '您的签名');
$result = $sms->sendSms('13800138000', '123456', ['123456']);

3 简单HTTP请求方式（不依赖SDK）

<?php
class SimpleSmsService {
    private $apiUrl;
    private $apiKey;
    public function sendSms($phone, $content) {
        $postData = [
            'api_key' => $this->apiKey,
            'phone' => $phone,
            'content' => $content
        ];
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $this->apiUrl);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode == 200) {
            return json_decode($response, true);
        } else {
            return false;
        }
    }
}

验证码发送示例

<?php
class VerificationCodeService {
    private $smsService;
    public function __construct($smsService) {
        $this->smsService = $smsService;
    }
    /**
     * 生成并发送验证码
     */
    public function sendVerificationCode($phone) {
        // 生成6位随机验证码
        $code = str_pad(rand(0, 999999), 6, '0', STR_PAD_LEFT);
        // 存储验证码到缓存（Redis/数据库）
        $this->storeVerificationCode($phone, $code);
        // 发送短信
        $result = $this->smsService->sendSms(
            $phone,
            'SMS_VERIFICATION_TEMPLATE',
            ['code' => $code, 'minute' => 5]
        );
        return $result;
    }
    /**
     * 验证验证码
     */
    public function verifyCode($phone, $code) {
        $storedCode = $this->getStoredVerificationCode($phone);
        if ($storedCode && $storedCode == $code) {
            // 验证成功后删除验证码
            $this->deleteVerificationCode($phone);
            return true;
        }
        return false;
    }
    private function storeVerificationCode($phone, $code) {
        // 使用Redis存储，5分钟过期
        // \Redis::setex('sms_code:' . $phone, 300, $code);
    }
    private function getStoredVerificationCode($phone) {
        // return \Redis::get('sms_code:' . $phone);
    }
    private function deleteVerificationCode($phone) {
        // \Redis::del('sms_code:' . $phone);
    }
}

最佳实践建议

1 错误处理

class SmsException extends \Exception {
    protected $errorCode;
    public function __construct($message, $code = 0) {
        parent::__construct($message, $code);
        $this->errorCode = $code;
    }
}
try {
    $result = $smsService->sendSms($phone, $templateCode, $params);
    if (!$result['success']) {
        throw new SmsException($result['message'], $result['code']);
    }
} catch (SmsException $e) {
    // 记录日志
    error_log("短信发送失败: " . $e->getMessage());
    // 返回错误信息
    return ['error' => $e->getMessage()];
}

2 频率限制

class SmsRateLimiter {
    private $redis;
    private $maxPerMinute = 1; // 每分钟最大发送次数
    private $maxPerDay = 5;    // 每天最大发送次数
    public function canSend($phone) {
        $minuteKey = "sms_limit:minute:{$phone}";
        $dayKey = "sms_limit:day:" . date('Ymd') . ":{$phone}";
        // 检查分钟限制
        $minuteCount = $this->redis->get($minuteKey) ?: 0;
        if ($minuteCount >= $this->maxPerMinute) {
            return false;
        }
        // 检查天限制
        $dayCount = $this->redis->get($dayKey) ?: 0;
        if ($dayCount >= $this->maxPerDay) {
            return false;
        }
        return true;
    }
}

3 日志记录

// 使用Monolog记录日志
$log = new \Monolog\Logger('sms');
$log->pushHandler(new \Monolog\Handler\StreamHandler('path/to/sms.log', \Monolog\Logger::INFO));
$log->info('短信发送', [
    'phone' => $phone,
    'template' => $templateCode,
    'result' => $result,
    'time' => date('Y-m-d H:i:s')
]);