Merge branch 'develop'

Author: lfeng

README.md

@@ -2,6 +2,9 @@
 
 又拍云存储PHP SDK，基于 [又拍云存储HTTP REST API接口](http://wiki.upyun.com/index.php?title=HTTP_REST_API%E6%8E%A5%E5%8F%A3) 开发。
 
+## 更新说明
+使用1.0.x系列版本SDK的用户，注意原有部分方法已经不再推荐使用，但是处于兼容考虑目前任然保留，建议更新升级程序使用新版SDK提供的方法。
+
 ## 使用说明
 
 ### 初始化UpYun

examples.php

@@ -0,0 +1,15 @@
+<?php
+require_once('../upyun.class.php');
+
+$upyun = new UpYun('bucket', 'user', 'pwd');
+
+try {
+    echo "=========获取目录文件列表\r\n";
+    $list = $upyun->getList('/demo/');
+    var_dump($list);
+    echo "=========DONE\r\n\r\n";
+}
+catch(Exception $e) {
+    $e->getCode();
+    $e->getMessage();
+}

examples/get_list.php

@@ -0,0 +1,50 @@
+<?php
+require_once('../upyun.class.php');
+
+$upyun = new UpYun('bucket', 'user', 'pwd');
+
+try {
+    echo "=========直接上传文件\r\n";
+    $fh = fopen('sample.jpeg', 'rb');
+    $rsp = $upyun->writeFile('/demo/sample_normal.jpeg', $fh, True);   // 上传图片，自动创建目录
+    fclose($fh);
+    var_dump($rsp);
+    echo "=========DONE\n\r\n";
+
+    echo "=========设置MD5校验文件完整性\r\n";
+    $opts = array(
+        UpYun::CONTENT_MD5 => md5(file_get_contents("sample.jpeg"))
+    );
+    $fh = fopen('sample.jpeg', 'rb');
+    $rsp = $upyun->writeFile('/demo/sample_md5.jpeg', $fh, True, $opts);   // 上传图片，自动创建目录
+    fclose($fh);
+    var_dump($rsp);
+    echo "=========DONE\r\n\r\n";
+
+    echo "=========直接生成缩略图，不保存原图片，仅对图片文件有效\r\n";
+    $opts = array(
+        UpYun::X_GMKERL_TYPE    => 'square', // 缩略图类型
+        UpYun::X_GMKERL_VALUE   => 150, // 缩略图大小
+        UpYun::X_GMKERL_QUALITY => 95, // 缩略图压缩质量
+        UpYun::X_GMKERL_UNSHARP => True // 是否进行锐化处理
+    );
+    $fh = fopen('sample.jpeg', 'rb');
+    $rsp = $upyun->writeFile('/demo/sample_thumb_1.jpeg', $fh, True, $opts);   // 上传图片，自动创建目录
+    fclose($fh);
+    var_dump($rsp);
+    echo "=========DONE\r\n\r\n";
+
+    echo "=========按照预先设置的缩略图类型生成缩略图类型生成缩略图，不保存原图，仅对图片空间有效\r\n";
+    $opts = array(
+        UpYun::X_GMKERL_THUMBNAIL => 'thumbtype'
+    );
+    $fh = fopen('sample.jpeg', 'rb');
+    $rsp = $upyun->writeFile('/demo/sample_thumb_2.jpeg', $fh, True, $opts);   // 上传图片，自动创建目录
+    fclose($fh);
+    var_dump($rsp);
+    echo "=========DONE\r\n\r\n";
+}
+catch(Exception $e) {
+    $e->getCode();
+    $e->getMessage();
+}

examples/sample.jpeg

@@ -71,6 +71,11 @@ class UpYun {
      */
     private $_file_secret = NULL;
 
+    /**
+     * @deprecated
+     */
+    private $_file_infos= NULL;
+
     protected $endpoint;
 
 	/**
@@ -144,7 +149,9 @@ public function writeFile($path, $file, $auto_mkdir = False, $opts = NULL) {/*{{
 
         if ($auto_mkdir === True) $opts['Mkdir'] = 'true';
 
-        return $this->_do_request('PUT', $path, $opts, $file);
+        $this->_file_infos = $this->_do_request('PUT', $path, $opts, $file);
+
+        return $this->_file_infos;
     }/*}}}*/
 
     /**
@@ -302,7 +309,6 @@ protected function _do_request($method, $path, $headers = NULL, $body= NULL, $fi
         $body = '';
         list($header_string, $body) = explode("\r\n\r\n", $response, 2);
 
-        var_dump($response);
         //var_dump($header_string, $body);
         //var_dump($http_code);
         if ($http_code == 200) {
@@ -470,4 +476,15 @@ public function setContentMD5($str){/*{{{*/
 	public function setFileSecret($str){/*{{{*/
 		$this->_file_secret = $str;
 	}/*}}}*/
+
+	/**
+     * @deprecated
+	* 获取上传文件后的信息（仅图片空间有返回数据）
+	* @param $key 信息字段名（x-upyun-width、x-upyun-height、x-upyun-frames、x-upyun-file-type）
+	* return value or NULL
+	*/
+	public function getWritedFileInfo($key){/*{{{*/
+		if(!isset($this->_file_infos))return NULL;
+		return $this->_file_infos[$key];
+	}/*}}}*/
 }