Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johnlui/aliyunoss
阿里云 OSS 官方 SDK 的 Composer 封装，支持任何 PHP 项目，包括 Laravel、Symfony、TinyLara 等等。
https://github.com/johnlui/aliyunoss
aliyun aliyun-oss laravel oss php
Last synced: 4 days ago
JSON representation
阿里云 OSS 官方 SDK 的 Composer 封装，支持任何 PHP 项目，包括 Laravel、Symfony、TinyLara 等等。
- Host: GitHub
- URL: https://github.com/johnlui/aliyunoss
- Owner: johnlui
- Created: 2015-01-06T12:13:19.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2020-06-19T04:46:43.000Z (over 4 years ago)
- Last Synced: 2024-05-18T17:45:01.999Z (6 months ago)
- Topics: aliyun, aliyun-oss, laravel, oss, php
- Language: PHP
- Homepage:
- Size: 291 KB
- Stars: 489
- Watchers: 25
- Forks: 189
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
AliyunOSS
---------
```
___ __ _ ____ _____ _____
/ | / / (_) __ __ __ __ ____ / __ \ / ___/ / ___/
/ /| | / / / / / / / / / / / / / __ \ / / / / \__ \ \__ \
/ ___ | / / / / / /_/ / / /_/ / / / / / / /_/ / ___/ / ___/ /
/_/ |_|/_/ /_/ \__, / \__,_/ /_/ /_/ \____/ /____/ /____/
/____/
```
AliyunOSS 是阿里云 OSS 官方 SDK 的 Composer 封装，支持任何 PHP 项目，包括 Laravel、Symfony、TinyLara 等等。
#### 适配 Laravel 7 的新包已经发布：[AliyunOSS-Laravel7](https://github.com/johnlui/AliyunOSS-Laravel7)
## 更新记录
* 2017-03-08 `Release v2.0.0` v2 发布，在 API 易用性上进行了大量优化
* 2016-09-12 `Release v1.3.5` 加入文件元信息的设置功能
* 2016-07-20 `Release v1.3.4` 加入文件元信息的获取功能
* 2016-01-31 `Release v1.3.2` 获取指定虚拟文件夹下的所有文件
* 2015-10-23 `Release v1.3` 增加删除、复制、移动文件功能
* 2015-08-07 `Release v1.2` 修复内存泄露 bug
* 2015-01-12 `Release v1.1` 增加内外网配置分离
* 2015-01-09 `Release v1.0` 完善功能，增加 Laravel 框架详细使用教程及代码
## 安装
安装有两种方式：
### ① 直接编辑配置文件
将以下内容增加到 composer.json：
```json
require: {
"johnlui/aliyun-oss": "~2.0"
}
```
然后运行 `composer update`。
### ② 执行命令安装
运行命令：
```bash
composer require johnlui/aliyun-oss:~2.0
```
## 使用（以 Laravel 为例）
### 构建 Service 文件
新建 `app/services/OSS.php`，内容可参考：[OSS.php](https://github.com/johnlui/AliyunOSS/blob/master/example/OSS.php)，然后修改配置：
```php
... ...
private $city = '青岛';
// 经典网络 or VPC
private $networkType = '经典网络';
private $AccessKeyId = '';
private $AccessKeySecret = '';
... ...
```
### 放入自动加载
#### 遵循 psr-0 的项目（如Laravel 4、CodeIgniter、TinyLara）中：
在 `composer.json` 中 `autoload -> classmap` 处增加配置：
```json
"autoload": {
"classmap": [
"app/services"
]
}
```
然后运行 `composer dump-autoload`。
#### 遵循 psr-4 的项目（如 Laravel 5、Symfony）中：
无需配置，保证目录 `App/Services` 和命名空间 `namespace App\Services;` 一致即可自动加载。
### 使用
```php
use App\Services\OSS;
// 在外网上传一个文件并指定 options 如：Content-Type 类型
// 更多 options 见：https://github.com/johnlui/AliyunOSS/blob/master/src/oss/src/Aliyun/OSS/OSSClient.php#L142-L148
OSS::publicUpload('bucket', '目标 object 名', '本地文件绝对路径', [
'ContentType' => 'application/pdf',
... ...
]);
```
更多用法等待着你去[发现](https://github.com/johnlui/AliyunOSS/blob/master/example/OSS.php)。
### Symfony 3 用法示例
如果你正在使用基于 Symfony 创建的第三方应用程序，而又恰好不懂命名空间及 Composer 自动加载，那么看下面就知道本库在 Symfony 中的用法了：
#### 构建 Service 文件
新建 `src/AppBundle/Services/OSS.php`，内容参考：[OSS.php](https://github.com/johnlui/AliyunOSS/blob/master/example/OSS.php)。
修改顶部的命名空间为 `namespace AppBundle\Services;`。
#### 放入自动加载
无需配置。
#### 使用
```php
use AppBundle\Services\OSS;
OSS::publicUpload('bucket', '目标 object 名', '本地文件绝对路径');
```
## 反馈
有问题请到 http://lvwenhan.com/laravel/425.html 下面留言。
## License
除 “版权所有（C）阿里云计算有限公司” 的代码文件外，遵循 [MIT license](http://opensource.org/licenses/MIT) 开源。