Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/xutl/yii2-aliyun

适用于阿里云的 Yii2 API组件
https://github.com/xutl/yii2-aliyun

aliyun php php-library xutl yii2-extension

Last synced: 24 days ago
JSON representation

适用于阿里云的 Yii2 API组件

Awesome Lists containing this project

README

        

# Aliyun Extension for Yii 2

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

[![Latest Stable Version](https://poser.pugx.org/xutl/yii2-aliyun/v/stable.png)](https://packagist.org/packages/xutl/yii2-aliyun)
[![Total Downloads](https://poser.pugx.org/xutl/yii2-aliyun/downloads.png)](https://packagist.org/packages/xutl/yii2-aliyun)
[![License](https://poser.pugx.org/xutl/yii2-aliyun/license.svg)](https://packagist.org/packages/xutl/yii2-aliyun)

支持的接口和服务:

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

Installation
------------

Next steps will guide you through the process of installing using [composer](http://getcomposer.org/download/). 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

```json
"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:

```php
'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

使用方式非常简单

```php
$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](LICENSE.md)
for details.