xutl / yii2-aliyun
为 Yii 框架提供的 Aliyun 扩展
2.0.1.1
2018-01-24 03:54 UTC
Requires
- php: >=5.4.0
- aliyuncs/oss-sdk-php: ~2.0
- yiisoft/yii2: ~2.0.6
- yiisoft/yii2-httpclient: ~2.0.0
README
适用于 Yii2 的 Aliyun SDK。通过DI实现,可自行继承扩展。
支持的接口和服务:
- CDN
- 实人认证
- 云相册
- 云推送
- 邮件推送
- DNS
- 域名
- 内容安全
- HTTPDNS
- 移动安全
- 直播
- 媒体转码
- 负载均衡
- 短信
- 视频点播
- VPC
安装
下一步将指导您通过 composer 进行安装。安装是一个简单快捷的三步过程。
步骤 1: 使用 composer 安装组件
运行以下命令之一
composer require --prefer-dist xutl/yii2-aliyun
或添加
"xutl/yii2-aliyun": "~2.0.0"
到您的 composer.json 文件的 require
部分。
步骤 2: 配置您的应用程序
将以下行添加到您的主配置文件中
'components' => [ 'aliyun' => [ 'class' => 'xutl\aliyun\Aliyun', //这个类其实就是 继承了 `\yii\di\ServiceLocator` 类。 'accessId' => '123456', 'accessKey' => '654321', 'params'=> [//这里是非扩展的配置参数,如队列任务等 'CloudPush.appKey' => 123456789 ], 'components' => [ //各子组件配置,如果无需配置不写即可。也可动态注入配置。 //如果子组件使用独立的 `accessId` 和 `accessKey` 那么在子组件中单独配置即可,如果没有配置默认使用父 `accessId` 和 `accessKey` 。 //如果你自己扩展了其他的子组件,这里定义下新的组件配置即可,配置方式,数组接口和 YII 原生组件一致! //etc ] ], ],
使用
使用方式非常简单
$aliyun = Yii::$app->aliyun; $cloudPush = $aliyun->getCloudPush(); // 查看文档 https://help.aliyun.com/knowledge_detail/48085.html 请求参数中的 `Action` 省略,其他的照着写上就发包了。 // 实现原理是 首先 Aliyun 类使用 DI 技术 将子组件注册进来,在第一次使用时,会自动初始化,接着使用PHP的魔术方法请求对应的接口,方法名称即 `Action` 参数首字母小写即可。 $res = $cloud->pushMessageToAndroid([ 'AppKey'=>'123456', 'Target' => 'ALL', 'TargetValue' => 'ALL', 'Title' => 'Hello', 'Body' => 'Hello World!', ]); var_dump($res->isOk); print_r($res->data); //或者使用队列处理 Yii::$app->queue->push(new \xutl\aliyun\jobs\PushNoticeToMobile([ //etc ])); //其他接口类似调用方式 //如果扩展 暂不支持的接口,直接继承 `\xutl\aliyun\BaseClient` 和 `\xutl\aliyun\BaseAcsClient` 基类即可自带 认证。你只需扩展方法即可。 // 然后使用YII 自带的组件机制,参见上面的安装配置,把你自定义的接口注入进来即可。
说明
如果您对这个接口感兴趣,可以直接提交PR来合并更新。工作日工作时间,基本能实时响应合并。
许可证
本软件采用 MIT 许可证发布。有关详细信息,请参阅捆绑的 LICENSE.md。