PicUploader多功能图床工具 v1.0.zip

# KS3 SDK For PHP使用指南 --- [TOC] ## 1 概述 此SDK适用于PHP 5及以上版本。基于KS3 API 构建。使用此 SDK 构建您的网络应用程序，能让您以非常便捷地方式将数据安全地存储到金山云存储上。 ## 2 环境准备 配置PHP 5 以上开发环境 添加curl拓展 下载KS3 SDK For PHP 在项目中引用该php文件，Ks3Client.class.php ## 3 初始化 ### 3.1 下载SDK [https://github.com/ks3sdk/ks3-php-sdk](https://github.com/ks3sdk/ks3-php-sdk)下载SDK ### 3.2 获取秘钥 1、开通KS3服务，[http://www.ksyun.com/user/register](http://www.ksyun.com/user/register) 注册账号 2、进入控制台, [http://ks3.ksyun.com/console.html#/setting](http://ks3.ksyun.com/console.html#/setting) 获取AccessKeyID 、AccessKeySecret ### 3.3 配置 在引用Ks3Client.class.php文件前定义 //是否使用VHOST define("KS3_API_VHOST",FALSE); //是否开启日志(写入日志文件) define("KS3_API_LOG",TRUE); //是否显示日志(直接输出日志) define("KS3_API_DISPLAY_LOG", TRUE); //定义日志目录(默认是该项目log下) define("KS3_API_LOG_PATH",""); //是否使用HTTPS define("KS3_API_USE_HTTPS",FALSE); //是否开启curl debug模式 define("KS3_API_DEBUG_MODE",FALSE); ### 3.4 初始化客户端 当以上全部完成之后用户便可初始化客户端进行操作了 需要指定ks3节点 第三个参数endpoint需要对应bucket所在region!! 详见http://ks3.ksyun.com/doc/api/index.html Region（区域）一节 $client = new Ks3Client("<您的AccessKeyID>","<您的AccessKeySecret>","endpoint") ks3节点列表 详见http://ks3.ksyun.com/doc/api/index.html Region（区域）一节 ## 4 异常说明 ### 4.1 Ks3ServiceException 当抛出Ks3ServiceException时表示KS3服务端返回异常信息。Ks3ServiceException继承自RuntimeException 用户可根据该异常中的信息获取到出错的原因 ### 4.2 Ks3ClientException 当抛出Ks3ClientException时表示客户端发送了异常。Ks3ClientException继承自RuntimeException ## 5 使用示例 快速导航： 删除文件：5.3.1 5.3.2 下载文件：5.3.3 判断文件是否存在：5.3.5 上传文件：5.3.7 分块上传：5.3.12-5.3.17 ### 5.1 Service接口 #### 5.1.1 GET Service 获取用户的所有bucket列表 使用示例： $client->listBuckets(); 返回结果格式： Array ( [0] => Array ( [Name] => aaphp [CreationDate] => 2015-03-21T06:25:45.000Z ) [1] => Array ( [Name] => adest [CreationDate] => 2015-02-10T03:55:40.000Z ) [2] => Array ( [Name] => afiles [CreationDate] => 2015-02-10T07:39:19.000Z ) ) ### 5.2 Bucket接口 #### 5.2.1 DELETE Bucket 删除Bucket 注意： 1、只能删除空的Bucket 参数格式： $args = array("Bucket"=>"<您的bucket名称>") 使用示例： $client->deleteBucket($args); #### 5.2.2 DELETE Bucket cors 删除Bucket的跨域配置 参数格式: $args = array("Bucket"=>"<您的bucket名称>") 使用示例： $client->deleteBucketCORS($args); #### 5.2.3 GET Bucket 罗列Bucket下的object 参数格式： Options中为可选参数，用户需参考KS3 API文档根据实际情况调节参数。 $args = array( "Bucket"=>"<您的bucket名称>", "Options"=>array( "prefix"=>"<prefix>", "max-keys"=>"<max-keys>", "marker"=>"<marker>", "delimiter"=>"<delimiter>" ) ); 使用示例： $client->listObjects($args); 返回结果格式： Array ( [Name] => ksc-scm //bucket名称 [Prefix] => [Marker] => [Delimiter] => / [MaxKeys] => 4 [IsTruncated] => true //true表示返回的结果是全部结果的一部分 [NextMarker] => dir/ //如果IsTruncated为true，则可以使用NextMarker作为下一次请求的marker.当请求时不提供delimiter的话不会返回NextMarker,可以使用Contents的最后一项作为下一次的Marker [Contents] => Array ( [0] => Array ( [Key] => 123.pdf [LastModified] => 2015-02-06T07:39:32.687Z [ETag] => 1285ba0d89e9b0883a1a5975051af159 [Size] => 515602 [Owner] => Array ( [ID] => 73398334 [DisplayName] => 73398334 ) [StorageClass] => STANDARD ) [1] => Array ( [Key] => 20150210154319.jpg [LastModified] => 2015-02-10T07:44:20.818Z [ETag] => c61d3bbb47947029b968d02be1cae7d0 [Size] => 141179 [Owner] => Array ( [ID] => 73398334 [DisplayName] => 73398334 ) [StorageClass] => STANDARD ) [2] => Array ( [Key] => chrome.exe [LastModified] => 2015-01-07T05:30:26.845Z [ETag] => ac08a03d7e579e2903925736e7ab48f2 [Size] => 852808 [Owner] => Array ( [ID] => 73398334 [DisplayName] => 73398334 ) [StorageClass] => STANDARD ) ) [CommonPrefixes] => Array ( [0] => dir/ ) ) #### 5.2.4 GET Bucket acl 获取bucket的权限 参数格式: $args = array("Bucket"=>"<您的bucket名称>") 使用示例: $client->getBucketAcl($args); 返回结果: private、public-read或者public-read-write #### 5.2.5 GET Bucket cors 获取bucket的跨域配置 参数格式: $args = array("Bucket"=>"<您的bucket名称>") 使用示例 $client->getBucketCORS($args); 返回结果格式: Array ( [0] => Array ( [AllowedOrigin] => Array ( [0] => http://www.kingsoft.com ) [AllowedMethod] => Array ( [0] => GET [1] => PUT ) [AllowedHeader] => Array ( [0] => * ) [MaxAgeSeconds] => 10 [ExposeHeader] => Array ( [0] => * ) ) [1] => Array ( [AllowedOrigin] => Array ( [0] => * ) [AllowedMethod] => Array ( [0] => GET [1] => PUT ) [AllowedHeader] => Array ( [0] => * ) [MaxAgeSeconds] => 10 [ExposeHeader] => Array ( [0] => * ) ) ) #### 5.2.6 GET Bucket location 获取bucket的地址 参数格式: $args = array("Bucket"=>"<您的bucket名称>") 使用示例: $client->getBucketLocation($args); 返回结果格式: HANGZHOU #### 5.2.7 GET Bucket logging 获取bucket的日志配置 参数格式: $args = array("Bucket"=>"<您的bucket名称>") 使用示例: $client->getBucketLogging($args); 返回结果格式: Array ( [Enable] => 1 [TargetBucket] => ksc-scm [TargetPrefix] => ) #### 5.2.8 HEAD Bucket 判断一个bucket是否存在 参数格式: $args