# buildadmin-plugin-Alioss

**Repository Path**: ttdms/buildadmin-plugin-alioss

## Basic Information

- **Project Name**: buildadmin-plugin-Alioss
- **Description**: 适用于BuildAdmin的阿里云OSS插件
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-09-21
- **Last Updated**: 2022-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: buildadmin, alioss, ali-oss-sdk

## README

<br />
<div align="center">
    <img src="http://cdn.mgbubu.com/logo-title.png" alt="" />
</div>
<br />
<p align="center">
    <a href="https://www.buildadmin.com/" target="_blank">
        <img src="https://img.shields.io/badge/buildadmin-%3E=1.0.5-blue?color=91aac3&labelColor=439EFD" alt="vue">
    </a>
    <a href="https://github.com/aliyun/aliyun-oss-php-sdk?spm=a2c4g.11186623.0.0.1f5b2d508U8ZD5" target="_blank">
        <img src="https://img.shields.io/badge/aliyuncs/oss--sdk--php-%5E2.6-blue?color=91aac3&labelColor=439EFD" alt="license">
    </a>
    <a href="https://github.com/aliyun/openapi-sdk-php/tree/master/src/Sts?spm=a2c4g.11186623.0.0.4ba13767SSkQPJ" target="_blank">
        <img src="https://img.shields.io/badge/aliyuncs/alibabacloud/sts--20150401-%5E1.1.2-blue?color=91aac3&labelColor=439EFD" alt="license">
    </a>
    <a href="https://github.com/ali-sdk/ali-oss?spm=a2c4g.11186623.0.0.1399110azRnG7t" target="_blank">
        <img src="https://img.shields.io/badge/ali--oss-%5E6.17.1-blue?color=91aac3&labelColor=439EFD" alt="license">
    </a>
</p>
<br>

### 阿里云对象存储OSS 插件介绍
🌈 整合阿里云对象存储OSS，可实现文件上传到OSS，删除OSS文件

### 主要特性
**🚀 STS服务授权：**
通过阿里云STS服务给上传用户颁发一个临时访问凭证。该用户可使用临时访问凭证在规定时间内访问您的OSS资源。临时访问凭证无需透露您的长期密钥，使您的OSS资源访问更加安全。

**💥 前端直传：**
无需通过服务端上传，前端可直接将文件上传至阿里云OSS，减轻您的服务器负担。

### 注意事项
- 创建阿里云账户，并创建bucket<br>
- 本插件使用STS授权访问生成临时凭证，所以你需要提前准备【RAM账户的Access ID和AccessKey Secret】和【RAM角色】（使用主账户的Access ID和AccessKey Secret会报错）。<br>
- 本插件不能与其他云存储插件共存，使用前请先卸载其他云存储插件并备份相关资源文件。

### 安装使用
1. 创建 RAM 账户<br>
1.1 使用阿里云账号登录 [RAM控制台](https://ram.console.aliyun.com/?spm=a2c4g.11186623.0.0.44359deaZecouI)。<br>
1.2 在左侧导航栏，选择 **身份管理 > 用户**。<br>
1.3 在用户页面，单击 **创建用户**。<br>
1.4 在创建用户页面的用户账号信息区域，输入 **登录名称** 和 **显示名称** 。<br>
1.5 访问方式区域，选择 **OpenAPI调用访问**。<br>
1.6 单击确定。<br>
1.7 记录下 RAM 账户的 **AccessKey ID** 和 **AccessKey Secret**
2. 为 RAM 账户 授权<br>
2.1 在用户页面，单击目标RAM用户操作列的 **添加权限**。<br>
2.2 **授权范围** 选择 **整个云账号**<br>
2.3 **选择权限** 选择系统策略 **AliyunOSSFullAccess** 和 **AliyunSTSAssumeRoleAccess**<br>
2.4 单击 **确定** 完成
3. 创建 RAM 角色<br>
3.1 在左侧导航栏，选择 **身份管理 > 角色**。<br>
3.2 在角色页面，单击 **创建角色**。<br>
3.3 在创建角色面板，选择 **可信实体类型为阿里云账号**，然后单击下一步。<br>
3.4 输入角色名称，可选：输入备注。<br>
3.5 云账号请选择 **当前云账号** <br>
3.6 单击完成，关闭。
4. 为 RAM角色 授权<br>
4.1 在 **角色** 页面，单击目标RAM角色操作列的 **添加权限**。<br>
4.2 **授权范围** 选择 **整个云账号**。<br>
4.3 **选择权限** 选择系统策略 **AliyunOSSFullAccess** 和 **AliyunSTSAssumeRoleAccess**<br>
4.4 单击完成，关闭。
5. 获取角色ARN<br>
5.1 在左侧导航栏，选择 **身份管理 > 角色**。<br>
5.2 单击目标RAM角色
5.3 在右上角找到 **ARN** 点击**复制**
<div align="center">
    <img src="http://cdn.mgbubu.com/ARN1.png" alt="" />
</div>
<div align="center">
    <img src="http://cdn.mgbubu.com/ARN2.png" alt="" />
</div>

### 错误反馈
- 如果发生错误，建议先访问[错误码说明](https://help.aliyun.com/document_detail/35028.html)查看相关原因
- 如有其他错误，可通过 [issues](https://gitee.com/ttdms/buildadmin-plugin-alioss/issues) 提交错误。

### 版权信息
🔐 buildadmin-plugin-Alioss 遵循`Apache2.0`开源协议发布，提供无需授权的免费使用。\
本项目包含的第三方源码和二进制文件之版权信息另行标注。