又拍云存储PHP SDK，基于 又拍云存储HTTP REST API接口 开发。
- 增加 composer 支持，特别感谢 @totoleo 将
upyun/sdk仓库源修改为 UPYUN 官方项目地址 - 移除不再推荐使用的 API:
rmDir deleteFile readDir getWritedFileInfo)，建议使用推荐方法替代 - note:
2.1.0版本之前已经被 @totoleo 使用
- 使用1.0.x系列版本SDK的用户，注意原有部分方法已经不再推荐使用(
@deprecated标注)，但是出于兼容考虑目前任然保留，建议更新升级程序使用新版SDK提供的方法。
推荐使用 composer 安装
composer require upyun/sdk
require_once('vendor/autoload.php');
$upyun = new UpYun('bucketname', 'operator_name', 'operator_pwd');参数 bucketname 为空间名称，operator_name、operator_pwd 为授权操作员的账号密码。
根据国内的网络情况，又拍云存储API目前提供了电信、联通网通、移动铁通三个接入点，在初始化的时候可以添加可选的第四个参数来指定API接入点。
$upyun = new UpYun('bucketname', 'operator_name', 'operator_pwd', UpYun::ED_TELECOM);接入点有四个值可选：
UpYun::ED_AUTO根据网络条件自动选择接入点UpYun::ED_TELECOM电信接入点UpYun::ED_CNC联通网通接入点UpYun::ED_CTT移动铁通接入点
默认参数为自动选择API接入点。但是我们推荐根据服务器网络状况，手动设置合理的接入点已获取最佳的访问速度。
超时时间设置
在初始化UpYun上传时，可以选择设置上传请求超时时间（默认30s）:
$upyun = new UpYun('bucketname', 'operator_name', 'operator_pwd', UpYun::ED_TELECOM, 600);示例代码中所有bucketname，operator_name，operator_pwd以及路径需要替换成实际环境的值，账户密码请注意保密
文件类空间可以上传任意形式的二进制文件
1.直接读取整个文件内容:
$upyun->writeFile('/path/to/server/file.ext', 'your file content', true);2.文件流的方式上传，可降低内存占用:
$file_handler = fopen('demo.png', 'r');
$upyun->writeFile('/path/to/server/demo.png', $file_handler, true);
fclose($file_handler);writeFile()第三个参数为可选，true表示自动创建相应目录，默认值为false。
文件空间上传成功后返回true。
如果上传失败，则会抛出异常。
图片可以上传到图片类空间或文件类空间
- 图片空间上传的图片不能超过20M，图片
宽*高*帧数不能超过2亿 - 文件空间上传的图片不能超过1G 建议站点图片上传到图片空间，便于在请求图片时可以生成自定义版本图片
1.上传图片并创建缩略图:
writeFile()方法第四个参数为数组类型可选参数，用来设置文件类型、缩略图处理。
$opts = array(
UpYun::X_GMKERL_THUMBNAIL => 'square' //创建缩略图
);
$fh = fopen('demo.png', 'r');
$upyun->writeFile('/temp/upload_demo.png', $fh, true, $opts);
fclose($fh);writeFile()方法第四个参数可以设置的值还包括：
- 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上传文件
- 图片空间上传成功后会返回一维数组，包含了图片信息，示例如下:
array(
'x-upyun-width' => 2000,
'x-upyun-height' => 1000,
'x-upyun-frames' => 1
'x-upyun-file-type' => "JPEG"
)如果上传失败，则会抛出异常。
1.直接读取文件内容:
$data = $upyun->readFile('/temp/upload_demo.png');2.使用文件流模式下载:
$fh = fopen('/tmp/demo.png', 'w');
$upyun->readFile('/temp/upload_demo.png', $fh);
fclose($fh);直接获取文件时，返回文件内容，使用数据流形式获取时，成功返回true。
如果获取文件失败，则抛出异常。
$upyun->makeDir('/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/');
//your code here
} catch(Exception $e) {
echo $e->getCode(); // 错误代码
echo $e->getMessage(); // 具体错误信息
}- Fork
- 为新特性创建一个新的分支
- 发送一个 pull request 到 develop 分支
UPYUN PHP-SDK基于 MIT 开源协议