upyun / php-sdk

src/Upyun/Uploader.php

Indentation +3 added lines, -3 removed lines

@@ -36,9 +36,9 @@
         if (! $useBlock) {
             $req = new Rest($this->config);
             return $req->request('PUT', $path)
-                       ->withHeaders($params)
-                       ->withFile($stream)
-                       ->send();
+                        ->withHeaders($params)
+                        ->withFile($stream)
+                        ->send();
         } elseif ($this->config->uploadType === 'BLOCK_PARALLEL') {
             return $this->concurrentPointUpload($path, $stream, $params);
         } else {

Doc Comments +12 added lines, -4 removed lines

@@ -22,6 +22,11 @@ 
         $this->config = $config;
     }
 
+    /**
+     * @param string $path
+     * @param string $file
+     * @param boolean $withAsyncProcess
+     */
     public function upload($path, $file, $params, $withAsyncProcess)
     {
         $stream = Psr7\stream_for($file);
@@ -49,10 +54,10 @@ 
     /**
      * 串行式断点续传
      * @param $path
-     * @param $stream
+     * @param \Psr\Http\Message\StreamInterface $stream
      * @param $params
      *
-     * @return mixed|\Psr\Http\Message\ResponseInterface
+     * @return \Psr\Http\Message\ResponseInterface
      * @throws \Exception
      */
     private function pointUpload($path, $stream, $params)
@@ -110,6 +115,9 @@ 
         return $res;
     }
 
+    /**
+     * @param integer|null $fileSize
+     */
     private function needUseBlock($fileSize)
     {
         if ($this->config->uploadType === 'BLOCK' ||
@@ -126,10 +134,10 @@ 
     /**
      * 并行式断点续传
      * @param $path
-     * @param $stream
+     * @param \Psr\Http\Message\StreamInterface $stream
      * @param $params
      *
-     * @return mixed|\Psr\Http\Message\ResponseInterface
+     * @return \Psr\Http\Message\ResponseInterface
      * @throws \Exception
      */
     private function concurrentPointUpload($path, $stream, $params)

src/Upyun/Api/Rest.php

Doc Comments +5 added lines, -2 removed lines

@@ -32,6 +32,9 @@ 
         $this->endpoint = $config->getProtocol() . Config::$restApiEndPoint . '/' . $config->serviceName;
     }
 
+    /**
+     * @param string $method
+     */
     public function request($method, $storagePath)
     {
         $this->method = strtoupper($method);
@@ -41,7 +44,7 @@ 
 
 
     /**
-     * @param string|resource $file
+     * @param \Psr\Http\Message\StreamInterface $file
      *
      * @return $this
      */
@@ -54,7 +57,7 @@ 
     }
 
     /**
-     * @return mixed|\Psr\Http\Message\ResponseInterface
+     * @return \Psr\Http\Message\ResponseInterface
      */
     public function send()
     {

src/Upyun/Upyun.php

Doc Comments +2 added lines, -2 removed lines

@@ -197,7 +197,7 @@ 
      * 获取云存储文件/目录的基本信息
      *
      * @param string $path 云存储的文件路径
-     * @param array $otherHeaders 设置了后，方法将返回其他 http header 中的信息，默认为空
+     * @param string[] $otherHeaders 设置了后，方法将返回其他 http header 中的信息，默认为空
      *
      * @return array 返回一个数组，默认包含以下 key
      * - `x-upyun-file-type` 当 $path 是目录时，值为 *folder*，当 $path 是文件时，值为 *file*，
@@ -333,7 +333,7 @@ 
     /**
      * 刷新缓存
      *
-     * @param array|string $urls 需要刷新的文件 url 列表
+     * @param string $urls 需要刷新的文件 url 列表
      *
      * @return array 刷新失败的 url 列表，若全部刷新成功则为空数组
      */