seffeng / sms
PHP extension sms
Installs: 2 913
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: >=7.1.3
- guzzlehttp/guzzle: ^6.4|^7.0|^8.0
Requires (Dev)
- phpunit/phpunit: ^9.1
README
安装
# 暂时支持 阿里云 和 腾讯云 发送短信
$ composer require seffeng/sms
目录说明
│ SmsClient.php 基类
├─Clients
│ ├─Aliyun 阿里云
│ │ Client.php 阿里云发送处理类
│ │ Error.php 阿里云错误
│ │ TemplateParams.php 短信内容参数对应
│ └─Qcloud 腾讯云
│ Client.php 腾讯云发送处理类
│ Error.php 腾讯云错误
├─Exceptions
│ SmsException.php 异常基类
└─Helpers
ArrayHelper.php 数组帮助类
示例
/** * SiteController */ use Seffeng\Sms\SmsClient; use Seffeng\Sms\Exceptions\SmsException; class SiteController extends Controller { public function index() { try { $sdkAppId = ''; // 腾讯云SDKAppID 阿里云不需要 $appSecretId = ''; // 腾讯云SecretId 或 阿里云 AccessKeyId $appSecretKey = ''; // 腾讯云SecretKey 或 阿里云 AccessKeySecret $name = 'aliyun'; // qcloud 或 aliyun $signName = '签名'; // 签名内容 $tempCode = 'SMS_153055065'; // 腾讯云 templateId[1234] 或 阿里云 TemplateCode[SMS_153055065] $content = ['111111']; // 腾讯云 ['111111'] 或 阿里云 ['code' => '111111'] $phone = '13800138000'; // 相同内容可批量发送['13800138000', '13800138001'] // 因阿里云与腾讯云的内容参数结构不一致,参考 $content;可通过 TemplateParams 实现以腾讯云结构发送 $templateParamsModel = new TemplateParams(); $client = new SmsClient($appSecretId, $appSecretKey, $sdkAppId); $result = $client->setClient($name, $templateParamsModel) ->setSignName($signName) ->setTemplateCode($tempCode) ->send($phone, $content); if ($result) { echo '发送成功!'; } else { echo '发送失败!'; } } catch (SmsException $e) { echo $e->getMessage(); } catch (\Exception $e) { echo $e->getMessage(); } } }
/** * TemplateParams * @see Seffeng\Sms\Clients\Aliyun\TemplateParams */ class TemplateParams extends \Seffeng\Sms\Clients\Aliyun\TemplateParams { /** * 重写模板对应参数 * @return array */ public static function fetchNameItems() { return [ 'SMS_153055065' => ['code'], 'SMS_153055066' => ['code', 'address'], ]; } }
备注
1、使用阿里云发送短信时 $sdkAppId 无效(不需要此参数);
2、使用阿里云发送短信时若 $content 结构是阿里云格式时 $templateParamsModel 无效(不需要此参数);
3、阿里云 AccessKeyId 和 AccessKeySecret 为子账号 AccessKey ;
4、本地 http 请求错误:(cURL error 60: SSL certificate problem: unable to get local issuer certificate.)。
4.1 下载 cacert.pem (https://curl.haxx.se/docs/caextract.html);
4.2 修改 php.ini 修改 curl.cainfo 文件路径(绝对路径):
[curl]
curl.cainfo = "/cacert.pem"