详解php版阿里云OSS图片上传类

1.阿里云基本函数

/**
 * 把本地变量的内容到文件
 * 简单上传,上传指定变量的内存值作为object的内容
 */
public function putObject($imgPath,$object)
{
  $cOntent= file_get_contents($imgPath); // 把当前文件的内容获取到传入文件中
  $optiOns= array();
  try {
    $this->ossClient->putObject($this->bucket, $object, $content, $options);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  return TRUE;
}
/**
 * 上传指定的本地文件内容
 */
public function uploadFile($imgPath,$object) //$_FILES[&＃39;img&＃39;][&＃39;tmp_name&＃39;]
{
  $filePath = $imgPath;
  $optiOns= array();
  try {
    $this->ossClient->uploadFile($this->bucket, $object, $filePath, $options);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  return TRUE;
}
// 删除对象
public function deleteObject($object) {
  try {
    $this->ossClient->deleteObject($this->bucket, $object);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  return TRUE;
}
// 判断对象是否存在
public function doesObjectExist($object) {
  try {
    $result = $this->ossClient->doesObjectExist($this->bucket, $object);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  return $result;
}
// 批量删除对象
public function deleteObjects($objects) {
  try {
    $this->ossClient->deleteObjects($this->bucket, $objects);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  return TRUE;
}
/**
 * 获取object的内容
 *
 * @param OssClient $ossClient OssClient实例
 * @param string $bucket 存储空间名称
 * @return null
 */
public function getObject($object)
{
  $optiOns= array();
  try {
    $cOntent= $this->ossClient->getObject($this->bucket, $object, $options);
  } catch (OssException $e) {
    return $e->getMessage();
  }
  // file_get_contents
  return $content;
}

2.基本配置与辅助函数

public $ossClient,$bucket;
private $cOnfiginfo=  array(
  &＃39;maxSize&＃39;      => -1,  // 上传文件的最大值
  &＃39;supportMulti&＃39;   => true,  // 是否支持多文件上传
  &＃39;allowExts&＃39;     => array(),  // 允许上传的文件后缀 留空不作后缀检查
  &＃39;allowTypes&＃39;    => array(),  // 允许上传的文件类型 留空不做检查
  &＃39;thumb&＃39;       => false,  // 使用对上传图片进行缩略图处理
  &＃39;imageClassPath&＃39;  => &＃39;ORG.Util.Image&＃39;,  // 图库类包路径
  &＃39;thumbMaxWidth&＃39;   => &＃39;&＃39;,// 缩略图最大宽度
  &＃39;thumbMaxHeight&＃39;  => &＃39;&＃39;,// 缩略图最大高度
  &＃39;thumbPrefix&＃39;    => &＃39;thumb_&＃39;,// 缩略图前缀
  &＃39;thumbSuffix&＃39;    => &＃39;&＃39;,
  &＃39;thumbPath&＃39;     => &＃39;&＃39;,// 缩略图保存路径
  &＃39;thumbFile&＃39;     => &＃39;&＃39;,// 缩略图文件名
  &＃39;thumbExt&＃39;     => &＃39;&＃39;,// 缩略图扩展名
  &＃39;thumbRemoveOrigin&＃39; => false,// 是否移除原图
  &＃39;zipImages&＃39;     => false,// 压缩图片文件上传
  &＃39;autoSub&＃39;      => false,// 启用子目录保存文件
  &＃39;subType&＃39;      => &＃39;hash&＃39;,// 子目录创建方式 可以使用hash date custom
  &＃39;subDir&＃39;      => &＃39;&＃39;, // 子目录名称 subType为custom方式后有效
  &＃39;dateFormat&＃39;    => &＃39;Ymd&＃39;,
  &＃39;hashLevel&＃39;     => 1, // hash的目录层次
  &＃39;savePath&＃39;     => &＃39;&＃39;,// 上传文件保存路径
  &＃39;autoCheck&＃39;     => true, // 是否自动检查附件
  &＃39;uploadReplace&＃39;   => false,// 存在同名是否覆盖
  &＃39;saveRule&＃39;     => &＃39;uniqid&＃39;,// 上传文件命名规则
  &＃39;hashType&＃39;     => &＃39;md5_file&＃39;,// 上传文件Hash规则函数名
  );
// 错误信息
private $error = &＃39;&＃39;;
// 上传成功的文件信息
private $uploadFileInfo ;
public function __get($name){
  if(isset($this->configinfo[$name])) {
    return $this->configinfo[$name];
  }
  return null;
}
public function __set($name,$value){
  if(isset($this->configinfo[$name])) {
    $this->configinfo[$name]  =  $value;
  }
}
public function __isset($name){
  return isset($this->configinfo[$name]);
}
/**
 * 架构函数
 * @access public
 * @param array $config 上传参数
 */
public function __construct($cOnfig=array()) {
  if(is_array($config)) {
    $this->cOnfig=  array_merge($this->config,$config);
  }
  $this->bucket = C(&＃39;OSS_TEST_BUCKET&＃39;);
  $this->ossClient = new OssClient(C(&＃39;OSS_ACCESS_ID&＃39;), C(&＃39;OSS_ACCESS_KEY&＃39;), C(&＃39;OSS_ENDPOINT&＃39;), false);
}

3.主函数

/**
 * 上传所有文件
 * @access public
 * @param string $savePath 上传文件保存路径
 * @return string
 */
public function upload($savePath =&＃39;&＃39;) {
  //如果不指定保存文件名，则由系统默认
  if(empty($savePath)) {
    $savePath = $this->savePath;
  }
  $fileInfo  = array();
  $isUpload  = false;
  // 获取上传的文件信息
  // 对$_FILES数组信息处理
  $files  =  $this->dealFiles($_FILES);
  foreach($files as $key => $file) {
    //过滤无效的上传
    if(!empty($file[&＃39;name&＃39;])) {
      //登记上传文件的扩展信息
      if(!isset($file[&＃39;key&＃39;]))  $file[&＃39;key&＃39;]  =  $key;
      $file[&＃39;extension&＃39;] =  $this->getExt($file[&＃39;name&＃39;]);
      $file[&＃39;savepath&＃39;]  =  $savePath;
      $file[&＃39;savename&＃39;]  =  $this->getSaveName($file);
      // 自动检查附件
      if($this->autoCheck) {
        if(!$this->check($file))
          return false;
      }
      //保存上传文件
      if(!$this->save($file)) return false;
      if(function_exists($this->hashType)) {
        $fun = $this->hashType;
        $file[&＃39;hash&＃39;]  = $fun($this->autoCharset($file[&＃39;savepath&＃39;].$file[&＃39;savename&＃39;],&＃39;utf-8&＃39;,&＃39;gbk&＃39;));
      }
      //上传成功后保存文件信息，供其他地方调用
      unset($file[&＃39;tmp_name&＃39;],$file[&＃39;error&＃39;]);
      $fileInfo[] = $file;
      $isUpload  = true;
    }
  }
  if($isUpload) {
    $this->uploadFileInfo = $fileInfo;
    return true;
  }else {
    $this->error = &＃39;没有选择上传文件&＃39;;
    return false;
  }
}

4.核心处理函数

/**
 * 上传一个文件
 * @access public
 * @param mixed $name 数据
 * @param string $value 数据表名
 * @return string
 */
private function save($file) {
  $filename = $file[&＃39;savepath&＃39;].$file[&＃39;savename&＃39;];
  if(!$this->uploadReplace && $this->doesObjectExist($filename)) {
    // 不覆盖同名文件
    $this->error  =  &＃39;文件已经存在！&＃39;.$filename;
    return false;
  }
  // 如果是图像文件 检测文件格式
  if( in_array(strtolower($file[&＃39;extension&＃39;]),array(&＃39;gif&＃39;,&＃39;jpg&＃39;,&＃39;jpeg&＃39;,&＃39;bmp&＃39;,&＃39;png&＃39;,&＃39;swf&＃39;))) {
    $info  = getimagesize($file[&＃39;tmp_name&＃39;]);
    if(false === $info || (&＃39;gif&＃39; == strtolower($file[&＃39;extension&＃39;]) && empty($info[&＃39;bits&＃39;]))){
      $this->error = &＃39;非法图像文件&＃39;;
      return false;
    }
  }
  if(!$this->putObject($file[&＃39;tmp_name&＃39;], $this->autoCharset($filename,&＃39;utf-8&＃39;,&＃39;gbk&＃39;))) {
    $this->error = &＃39;文件上传保存错误！&＃39;;
    return false;
  }
  if($this->thumb && in_array(strtolower($file[&＃39;extension&＃39;]),array(&＃39;gif&＃39;,&＃39;jpg&＃39;,&＃39;jpeg&＃39;,&＃39;bmp&＃39;,&＃39;png&＃39;))) {
    $image = getimagesize(C(&＃39;OSS_IMG_URL&＃39;).&＃39;/&＃39;.$filename);
    if(false !== $image) {
      //是图像文件生成缩略图
      $thumbWidth   =  explode(&＃39;,&＃39;,$this->thumbMaxWidth);
      $thumbHeight  =  explode(&＃39;,&＃39;,$this->thumbMaxHeight);
      $thumbPrefix  =  explode(&＃39;,&＃39;,$this->thumbPrefix);
      $thumbSuffix  =  explode(&＃39;,&＃39;,$this->thumbSuffix);
      $thumbFile   =  explode(&＃39;,&＃39;,$this->thumbFile);
      $thumbPath   =  $this->thumbPath?$this->thumbPath:dirname($filename).&＃39;/&＃39;;
      $thumbExt    =  $this->thumbExt ? $this->thumbExt : $file[&＃39;extension&＃39;]; //自定义缩略图扩展名
      // 生成图像缩略图
      import($this->imageClassPath);
      for($i=0,$len=count($thumbWidth); $i<$len; $i++) {
        if(!empty($thumbFile[$i])) {
          $thumbname =  $thumbFile[$i];
        }else{
          $prefix   =  isset($thumbPrefix[$i])?$thumbPrefix[$i]:$thumbPrefix[0];
          $suffix   =  isset($thumbSuffix[$i])?$thumbSuffix[$i]:$thumbSuffix[0];
          $thumbname =  $prefix.basename($filename,&＃39;.&＃39;.$file[&＃39;extension&＃39;]).$suffix;
        }
        $this->thumb(C(&＃39;OSS_IMG_URL&＃39;).&＃39;/&＃39;.$filename,$thumbPath.$thumbname.&＃39;.&＃39;.$thumbExt,&＃39;&＃39;,$thumbWidth[$i],$thumbHeight[$i],true);
      }
      if($this->thumbRemoveOrigin) {
        // 生成缩略图之后删除原图
        $this->deleteObject($filename);
      }
    }
  }
  if($this->zipImags) {
    // TODO 对图片压缩包在线解压
  }
  return true;
}
/**
 * 生成缩略图
 * @static
 * @access public
 * @param string $image 原图
 * @param string $type 图像格式
 * @param string $thumbname 缩略图文件名
 * @param string $maxWidth 宽度
 * @param string $maxHeight 高度
 * @param string $position 缩略图保存目录
 * @param boolean $interlace 启用隔行扫描
 * @return void
 */
public function thumb($image, $thumbname, $type=&＃39;&＃39;, $maxWidth=200, $maxHeight=50, $interlace=true) {
  // 获取原图信息
  $info = Image::getImageInfo($image);
  if ($info !== false) {
    $srcWidth = $info[&＃39;width&＃39;];
    $srcHeight = $info[&＃39;height&＃39;];
    $type = empty($type) ? $info[&＃39;type&＃39;] : $type;
    $type = strtolower($type);
    $interlace = $interlace ? 1 : 0;
    unset($info);
    $scale = min($maxWidth / $srcWidth, $maxHeight / $srcHeight); // 计算缩放比例
    if ($scale >= 1) {
      // 超过原图大小不再缩略
      $width = $srcWidth;
      $height = $srcHeight;
    } else {
      // 缩略图尺寸
      $width = (int) ($srcWidth * $scale);
      $height = (int) ($srcHeight * $scale);
    }
    // 载入原图
    $createFun = &＃39;ImageCreateFrom&＃39; . ($type == &＃39;jpg&＃39; ? &＃39;jpeg&＃39; : $type);
    if(!function_exists($createFun)) {
      return false;
    }
    $srcImg = $createFun($image);
    //创建缩略图
    if ($type != &＃39;gif&＃39; && function_exists(&＃39;imagecreatetruecolor&＃39;))
      $thumbImg = imagecreatetruecolor($width, $height);
    else
      $thumbImg = imagecreate($width, $height);
     //png和gif的透明处理 by luofei614
    if(&＃39;png&＃39;==$type){
      imagealphablending($thumbImg, false);//取消默认的混色模式（为解决阴影为绿色的问题）
      imagesavealpha($thumbImg,true);//设定保存完整的 alpha 通道信息（为解决阴影为绿色的问题）
    }elseif(&＃39;gif&＃39;==$type){
      $trnprt_indx = imagecolortransparent($srcImg);
       if ($trnprt_indx >= 0) {
          //its transparent
          $trnprt_color = imagecolorsforindex($srcImg , $trnprt_indx);
          $trnprt_indx = imagecolorallocate($thumbImg, $trnprt_color[&＃39;red&＃39;], $trnprt_color[&＃39;green&＃39;], $trnprt_color[&＃39;blue&＃39;]);
          imagefill($thumbImg, 0, 0, $trnprt_indx);
          imagecolortransparent($thumbImg, $trnprt_indx);
     }
    }
    // 复制图片
    if (function_exists("ImageCopyResampled"))
      imagecopyresampled($thumbImg, $srcImg, 0, 0, 0, 0, $width, $height, $srcWidth, $srcHeight);
    else
      imagecopyresized($thumbImg, $srcImg, 0, 0, 0, 0, $width, $height, $srcWidth, $srcHeight);
    // 对jpeg图形设置隔行扫描
    if (&＃39;jpg&＃39; == $type || &＃39;jpeg&＃39; == $type)
      imageinterlace($thumbImg, $interlace);
    imagePNG($thumbImg,&＃39;Uploads/file.png&＃39;); // 中转站
    // 生成图片
    $this->putObject(&＃39;Uploads/file.png&＃39;,$thumbname);
    imagedestroy($thumbImg);
    imagedestroy($srcImg);
    return $thumbname;
  }
  return false;
}

5.辅助函数

/**
* 转换上传文件数组变量为正确的方式
* @access private
* @param array $files 上传的文件变量
* @return array
*/
private function dealFiles($files) {
    $fileArray = array();
    $n     = 0;
    foreach ($files as $key=>$file){
      if(is_array($file[&＃39;name&＃39;])) {
        $keys    =  array_keys($file);
        $count   =  count($file[&＃39;name&＃39;]);
        for ($i=0; $i<$count; $i++) {
          $fileArray[$n][&＃39;key&＃39;] = $key;
          foreach ($keys as $_key){
            $fileArray[$n][$_key] = $file[$_key][$i];
          }
          $n++;
        }
      }else{
        $fileArray[$key] = $file;
      }
    }
    return $fileArray;
}
/**
* 检查上传的文件
* @access private
* @param array $file 文件信息
* @return boolean
*/
private function check($file) {
    if($file[&＃39;error&＃39;]!== 0) {
      //文件上传失败
      //捕获错误代码
      $this->error($file[&＃39;error&＃39;]);
      return false;
    }
    //文件上传成功，进行自定义规则检查
    //检查文件大小
    if(!$this->checkSize($file[&＃39;size&＃39;])) {
      $this->error = &＃39;上传文件大小不符！&＃39;;
      return false;
    }
    //检查文件Mime类型
    if(!$this->checkType($file[&＃39;type&＃39;])) {
      $this->error = &＃39;上传文件MIME类型不允许！&＃39;;
      return false;
    }
    //检查文件类型
    if(!$this->checkExt($file[&＃39;extension&＃39;])) {
      $this->error =&＃39;上传文件类型不允许&＃39;;
      return false;
    }
    //检查是否合法上传
    if(!$this->checkUpload($file[&＃39;tmp_name&＃39;])) {
      $this->error = &＃39;非法上传文件！&＃39;;
      return false;
    }
    return true;
}
// 自动转换字符集 支持数组转换
private function autoCharset($fContents, $from=&＃39;gbk&＃39;, $to=&＃39;utf-8&＃39;) {
    $from  = strtoupper($from) == &＃39;UTF8&＃39; ? &＃39;utf-8&＃39; : $from;
    $to   = strtoupper($to) == &＃39;UTF8&＃39; ? &＃39;utf-8&＃39; : $to;
    if (strtoupper($from) === strtoupper($to) || empty($fContents) || (is_scalar($fContents) && !is_string($fContents))) {
      //如果编码相同或者非字符串标量则不转换
      return $fContents;
    }
    if (function_exists(&＃39;mb_convert_encoding&＃39;)) {
      return mb_convert_encoding($fContents, $to, $from);
    } elseif (function_exists(&＃39;iconv&＃39;)) {
      return iconv($from, $to, $fContents);
    } else {
      return $fContents;
    }
}
/**
* 检查上传的文件类型是否合法
* @access private
* @param string $type 数据
* @return boolean
*/
private function checkType($type) {
    if(!empty($this->allowTypes))
      return in_array(strtolower($type),$this->allowTypes);
    return true;
}
/**
* 检查上传的文件后缀是否合法
* @access private
* @param string $ext 后缀名
* @return boolean
*/
private function checkExt($ext) {
    if(!empty($this->allowExts))
      return in_array(strtolower($ext),$this->allowExts,true);
    return true;
}
/**
* 检查文件大小是否合法
* @access private
* @param integer $size 数据
* @return boolean
*/
private function checkSize($size) {
    return !($size > $this->maxSize) || (-1 == $this->maxSize);
}
/**
* 检查文件是否非法提交
* @access private
* @param string $filename 文件名
* @return boolean
*/
private function checkUpload($filename) {
    return is_uploaded_file($filename);
}
/**
* 取得上传文件的后缀
* @access private
* @param string $filename 文件名
* @return boolean
*/
private function getExt($filename) {
    $pathinfo = pathinfo($filename);
    return $pathinfo[&＃39;extension&＃39;];
}
/**
* 取得上传文件的信息
* @access public
* @return array
*/
public function getUploadFileInfo() {
    return $this->uploadFileInfo;
}
/**
* 取得最后一次错误信息
* @access public
* @return string
*/
public function getErrorMsg() {
    return $this->error;
}

总结：与普通上传的区别在于，它是全部通过阿里云的oss接口来处理文件保存的。普通上传是把本地文件移动到服务器上，而它则是把文件移动到阿里云服务器上。

缩略图思路：

a.上传图片至服务器
b.获取图片进行处理
c.上传处理好的图片至服务器
d.根据配置，删除或者不删除服务器的原图（OSS）

imagePNG($thumbImg,&＃39;Uploads/file.png&＃39;); // 中转站
// 生成图片
$this->putObject(&＃39;Uploads/file.png&＃39;,$thumbname);
unlink(&＃39;Uploads/file.png&＃39;);
imagedestroy($thumbImg);