本接口支持阿里OSS、腾讯COS、七牛OSS三大平台，屏蔽各个服务商之间的差异，实现统一接口调用。
使用之前必须调用对应服务商的初始化接口，传入配置参数。

阿里云OSS初始化

Lib\Api::Oss_AliyunOss($options)

请求参数

$options 参数列表

返回参数

返回操作对象

参数范例：

$options = array(
           'oss_id' => '',
           'oss_key' => '',
           'oss_bucket' => 'test',
           'oss_endpoint' => 'oss-cn-beijing.aliyuncs.com',
            'oss_url' => 'https://test.oss-cn-beijing.aliyuncs.com',
           'oss_bucket_url' => 'https://test.oss-cn-beijing.aliyuncs.com',
     );

腾讯云COS初始化

Lib\Api::Oss_TencentCos($options)

请求参数

$options 参数列表

返回参数

返回操作对象

参数范例：

$options = array(
           'oss_id' => '',
           'oss_key' => '',
           'oss_bucket' => 'test-100000',
           'oss_endpoint' => 'ap-shanghai',
            'oss_url' => 'https://test-100000.cos.ap-shanghai.myqcloud.com',
           'oss_bucket_url' => 'https://test-100000.cos.ap-shanghai.myqcloud.com',
          );

七牛云OSS初始化

Lib\Api::Oss_QiniuOss($options)

请求参数

$options 参数列表

返回参数

返回操作对象

参数范例：

$options = array(
           'oss_id' => '',
           'oss_key' => '',
           'oss_bucket' => 'test',
           'oss_endpoint' => 'test',
           'oss_url' => 'http://xxxx.hb-bkt.clouddn.com',
           'oss_bucket_url' => 'https://upload.qiniup.com;',
           
     );

连接测试

此接口用于检查与OSS链接是否正常

testOSS()

返回参数

返回测试状态，0=正常,3=上传测试失败,2=下载测试失败,1=OSS链接不能访问
1或2一般是密钥有误，3一般是oss_url填写有误，不能访问OSS资料

设置跨域

自动设置OSS跨域，方便直传。

setCors()

返回参数

无

判断OSS对象是否存在

判断OSS中是否存在某个对象

isObject($objects)

请求参数

返回参数

返回 bool 类型，true 对象存在，false 对象不存在

上传文件

用于把服务器的文件上传到OSS

uploadFile($file, $object, $Acl = null)

请求参数

返回参数

返回 bool 类型，true 上传成功，false 上传失败

调用范例

uploadFile('monkey/123.jpg','pic/123.jpg','public')
以上调用可以把服务器中的monkey/123.jpg文件上传到OSS，存储为pic/123.jpg对象，同时设置pic/123.jpg对象的属性为公有读。

流式上传文件

可以把字符串或二进制上传到OSS生成文件。

uploadData($data, $object, $Acl = null)

请求参数

返回参数

返回 bool 类型，true 上传成功，false 上传失败

调用范例

uploadData('WitFrame','text/123.txt','public')
以上调用在OSS生成text/123.txt文件,文件内容为WitFrame,同时设置对象的属性为公有读。

下载文件

把存储在OSS中的对象下载到本地服务器

downFile($file, $object)

请求参数

返回参数

返回 bool 类型，true 下载成功，false 下载失败

调用范例

downFile('monkey/123.jpg','pic/123.jpg')
以上调用可以把OSS中的对象下载到本地服务器的monkey文件夹中，文件名为123.jpg

删除文件

删除存储在OSS中的对象

deleteFile($objects)

请求参数

返回参数

返回 bool 类型，true 删除成功，false 删除失败

调用范例

deleteFile('pic/123.jpg')
以上调用可以把OSS中名为pic/123.jpg的对象删除

OSS对象改名

改变OSS中的对象名称

renameObject($oldObject, $newObject, $MimeType = null)

请求参数

返回参数

返回 bool 类型，true 改名成功，false 改名失败

调用范例

renameObject('monkey/123.jpg','pic/456.jpg','mp4')
以上调用可以把OSS中的对象monkey/123.jpg改名为pic/456.jpg,改强制吧文件的MIME改为mp4

设置OSS中对象的文件属性

可以把OSS中对象的文件属性设置公有读或私有读

setAcl($object, $Acl = null)

请求参数

返回参数

返回 bool 类型，true 设置成功，false 设置失败

调用范例

setAcl('monkey/123.jpg','private')
以上调用可以把OSS中的对象monkey/123.jpg的文件属性设置为私有读

获取对象下载签名 URL

返回对象加上访问签名的URL，此URL可以在任意在地方访问私有读文件并可以指定下载时的文件名。
如果是公有读文件，直接使用OSS的访问URL加上对象名即可，无需使用此接口。

signUrl($object, $filename = '', $e = 3600)

请求参数

返回参数

返回 string 类型，为对象加上访问签名的URL。

调用范例

signUrl('monkey/123.jpg','456.jpg')
以上调用可以返回OSS中的对象monkey/123.jpg加上签名的下载URL，使用此URL下载的文件名为456.jpg

获取对象直传签名

以json格工返回对直传签名信息，用于向OSS直传文件。

getPolicy($dir, $object, $length = 1048576000)

请求参数

返回参数

返回 json 类型，返回直传签名信息，因OSS服务商而异，具体示例请参考SDK

调用范例

getPolicy('monkey', '123.txt')
以上调用以json格工返回直传信息，在前台使用该信息向OSS直传文件，上传到OSS后文件名只能是monkey/123.txt

获取对象信息

获取存储在OSS中的对象的文件大小信息，如果是图片文件还可以返回图片文件的高宽。

getCallback($object)

请求参数

返回参数

array(
    'size'  => $size,
    'width' => $width,
    'height' => $height,
)

调用范例

getCallback('pic/123.jpg')
以上调用返回pic/123.jpg对象的相关信息

获取OSS的文件列表

返回OSS文件列表

getFilesList($prefix = '', $marker = '', $limit = 100, $delimiter = '') 

请求参数

返回参数

array(
    'marker'  => $marker,
    'items' => array(),
)

调用范例

//每次从monkey文件夹取出10个文件信息，直到找出所有
$marker = '';
do{
    $result = $cos->getFilesList('/monkey',$marker,10);
    $items = $result['items'];
    foreach($items as $item){
        print_r($item);
    }
    $marker = $result['marker'];
}while(!empty($marker));

完整范例

https://gitee.com/WitFrameSDK/Samples/tree/oss