基本用法.md

初始化

$conf = array(
    'ak' => 'ACCESS KEY', //必须，请输入您的ACCESS KEY
    'sk' => 'SECRECT KEY', //必须，请输入您的SECRECT KEY
    'bucket' => 'BUCKET NAME', //可选，您的空间名（建议填写）
    'auth' => 'public', //可选，空间的访问权限，公开还是私有，默认为公开
    'domain' => '自定义域名' //可选，空间设置的自定义域名，在有导出URL的时候会自动应用该域名
    );
$qiniu = new Jerrybendy\Qiniu\Qiniu($conf);

//获取文件信息的操作
$ret = $qiniu->rs->stat('abc.jpg');
var_dump($ret);

类Qiniu的构造函数接受一个包含配置信息的数组，数组中必须用ak和sk来指定您的ACCESS KEY 和 SECRECT KEY。

构造函数的参数Bucket是可选的，这意味着您可以在调用函数时手动指定被操作的空间，而不局限于使用默认的空间来操作，这在跨空间的文件管理操作中会显得非常有用。

基本输出

类库中除了有些直接返回生成URL的函数（如get_url等）外，基本上都是返回一个Jerrybendy\Qiniu\Qiniu_response对象，对象中包含的内容如下：

通常情况下在判断返回值为OK时即可用 $ret->data 来获取真正的返回内容。

object(Qiniu_response)#5 (6) {
  ["code"]=>int(200)
  ["body"]=>string(106) "{"fsize":122861,"hash":"Fhf2UiLBUz_8eJamHQ2VaXc1wLQM","mimeType":"image/jpeg","putTime":14082922036310155}"
  ["headers"]=>
  array(8) {
    ["server"]=>
    string(11) "nginx/1.4.4"
    ["date"]=>
    string(19) "Sun, 17 Aug 2014 16"
    ["content-type"]=>
    string(16) "application/json"
    ["content-length"]=>
    string(3) "106"
    ["connection"]=>
    string(10) "keep-alive"
    ["cache-control"]=>
    string(8) "no-store"
    ["x-log"]=>
    string(21) "rs6_2.sel;qtbl.get;RS"
    ["x-reqid"]=>
    string(16) "dxsAAHLccP4PQ4sT"
  }
  ["message"]=>
  string(2) "OK"
  ["protocol"]=>
  string(8) "HTTP/1.1"
  ["data"]=>
  array(4) {
    ["fsize"]=>
    int(122861)
    ["hash"]=>
    string(28) "Fhf2UiLBUz_8eJamHQ2VaXc1wLQM"
    ["mimeType"]=>
    string(10) "image/jpeg"
    ["putTime"]=>
    float(1.408292203631E+16)
  }
}

推荐的使用方法

对于返回内容推荐使用 is_OK()函数来判断是否执行成功。执行成功时 $ret->data即为七牛服务器返回的JSON解析后的数组，$ret->body为JSON原始数据。具体服务器可能返回哪些信息请参考七牛的官方文档。

请求失败时会设置$ret->data['error']为错误信息。

$ret = $qiniu->rs->stat('abc.jpg');
if($ret->is_OK()){
    $data = $ret->data;
    $fileSize = $data['fsize'];
}