xutl/yii2-aliyun

The aliyun extension for the Yii framework

Installs: 4 359

Dependents: 3

Suggesters: 0

Security: 0

Stars: 4

Watchers: 2

Forks: 0

Open Issues: 0

Type:yii2-extension

2.0.1.1 2018-01-24 03:54 UTC

This package is auto-updated.

Last update: 2024-12-11 02:16:33 UTC


README

适用于 Yii2 的 Aliyun SDK。使用了DI实现的,可自行继承扩展。

Latest Stable Version Total Downloads License

支持的接口和服务:

  • CDN
  • 实人认证
  • 云相册
  • 云推送
  • 邮件推送
  • DNS
  • 域名
  • 内容安全
  • HTTPDNS
  • 移动安全
  • 直播
  • 媒体转码
  • 负载均衡
  • 短信
  • 视频点播
  • VPC

Installation

Next steps will guide you through the process of installing using composer. Installation is a quick and easy three-step process.

Step 1: Install component via composer

Either run

composer require --prefer-dist xutl/yii2-aliyun

or add

"xutl/yii2-aliyun": "~2.0.0"

to the require section of your composer.json.

Step 2: Configuring your application

Add following lines to your main configuration file:

'components' => [
    'aliyun' => [
        'class' => 'xutl\aliyun\Aliyun', //这个类其实就是 继承了  `\yii\di\ServiceLocator` 类。 
        'accessId' => '123456',
        'accessKey' => '654321',
        'params'=> [//这里是非扩展的配置参数,如队列任务等
            'CloudPush.appKey' => 123456789
        ],
        'components' => [
             //各子组件配置,如果无需配置不写即可。也可动态注入配置。
             //如果子组件使用独立的 `accessId` 和 `accessKey` 那么在子组件中单独配置即可,如果没有配置默认使用父  `accessId` 和 `accessKey` 。
             //如果你自己扩展了其他的子组件,这里定义下新的组件配置即可,配置方式,数组接口和 YII 原生组件一致!
            //etc
        ]
    ],
],

Use

使用方式非常简单

$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来合并更新。工作日工作时间,基本能实时响应合并。

License

This is released under the MIT License. See the bundled LICENSE.md for details.