raypower/upyun

There is no license information available for the latest version (dev-master) of this package.

UpYun api component for laravel 4

dev-master 2014-06-02 06:33 UTC

This package is not auto-updated.

Last update: 2024-03-26 04:28:18 UTC


README

基于 又拍云存储PHP SDK 开发。

使用说明

安装

添加以下代码到composer.json的require段中

"raypower/upyun": "dev-master",

执行

composer update

配置

Service Provider

'Raypower\Upyun\UpyunServiceProvider',

Alias

'Upyun' => 'Raypower\Upyun\UpyunFacade',

执行

php artisan config:publish raypower/upyun

配置项

  • bucket_name 为空间名称
  • useranmepassword 为授权操作员的账号密码
  • timeout 为请求超时时间(默认30s)
  • end_point 为网络接入点

接入点有四个值可选:

  • Upyun::ED_AUTO 根据网络条件自动选择接入点
  • Upyun::ED_TELECOM 电信接入点
  • Upyun::ED_CNC 联通网通接入点
  • Upyun::ED_CTT 移动铁通接入点

默认参数为自动选择API接入点。但是我们推荐根据服务器网络状况,手动设置合理的接入点已获取最佳的访问速度。

上传文件

// 直接传递文件内容的形式上传
Upyun::writeFile('/temp/text_demo.txt', 'Hello World', True);

// 数据流方式上传,可降低内存占用
$fh = fopen('demo.png', 'r');
Upyun::writeFile('/temp/upload_demo.png', $fh, True);
fclose($fh);

第三个参数为可选。True 表示自动创建相应目录,默认值为False。

本方法还有一个数组类型的可选参数,用来设置文件类型、缩略图处理等参数。

$opts = array(
	Upyun::X_GMKERL_THUMBNAIL => 'square' // 缩略图版本,仅适用于图片空间
);

$fh = fopen('demo.png', 'r');
Upyun::writeFile('/temp/upload_demo.png', $fh, True, $opts);
fclose($fh);

该参数可以设置的值还包括:

  • Upyun::CONTENT_TYPE
  • Upyun::CONTENT_MD5
  • Upyun::CONTENT_SECRET
  • Upyun::X_GMKERL_THUMBNAIL
  • Upyun::X_GMKERL_TYPE
  • Upyun::X_GMKERL_VALUE
  • Upyun::X_GMKERL_QUALITY
  • Upyun::X_GMKERL_UNSHARP

参数的具体使用方法,请参考 标准API上传文件

文件空间上传成功后返回True,图片空间上传成功后一数组形式返回图片信息:

array(
  'x-upyun-width' => 2000,
  'x-upyun-height' => 1000,
  'x-upyun-frames' => 1
  'x-upyun-file-type' => "JPEG"
)

如果上传失败,则会抛出异常。

下载文件

// 直接读取文件内容
$data = Upyun::readFile('/temp/upload_demo.png');

// 使用数据流模式下载,节省内存占用
$fh = fopen('/tmp/demo.png', 'w');
Upyun::readFile('/temp/upload_demo.png', $fh);
fclose($fh);

直接获取文件时,返回文件内容,使用数据流形式获取时,成功返回True。 如果获取文件失败,则抛出异常。

创建目录

Upyun::mkDir('/demo/');

目录路径必须以斜杠 / 结尾,创建成功返回 True,否则抛出异常。

删除目录或者文件

Upyun::delete('/demo/'); // 删除目录
Upyun::delete('/demo/demo.png'); // 删除文件

删除成功返回True,否则抛出异常。注意删除目录时,必须保证目录为空 ,否则也会抛出异常。

获取目录文件列表

$list = Upyun::getList('/demo/');
$file = $list[0];
echo $file['name'];	// 文件名
echo $file['type'];	// 类型(目录: folder; 文件: file)
echo $file['size'];	// 尺寸
echo $file['time'];	// 创建时间

获取目录文件以及子目录列表。需要获取根目录列表是,使用 Upyun::getList('/') ,或直接表用方法不传递参数。 目录获取失败则抛出异常。

获取文件信息

$result = Upyun::getFileInfo('/demo/demo.png');
echo $result['x-upyun-file-type']; // 文件类型
echo $result['x-upyun-file-size']; // 文件大小
echo $result['x-upyun-file-date']; // 创建日期

返回结果为一个数组。

获取空间使用状况

Upyun::getBucketUsage();	// 获取Bucket空间使用情况

返回的结果为空间使用量,单位 Byte

异常处理

当API请求发生错误时,SDK将抛出异常,具体错误代码请参考 标准API错误代码表

根据返回HTTP CODE的不同,SDK将抛出以下异常:

  • UpYunAuthorizationException 401,授权错误
  • UpYunForbiddenException 403,权限错误
  • UpYunNotFoundException 404,文件或目录不存在
  • UpYunNotAcceptableException 406, 目录错误
  • UpYunServiceUnavailable 503,系统错误

未包含在以上异常中的错误,将统一抛出 UpYunException 异常。

为了真确处理API请求中可能出现的异常,建议将API操作放在try{...}catch(Exception $e){…} 块中

try{
	Upyun::getFolderUsage('/demo/');
	...
}
catch(Exception $e) {
	echo $e->getCode();		// 错误代码
	echo $e->getMessage();	// 具体错误信息
}