Detailed explanation of Alibaba Cloud OSS image upload class in PHP version

The example in this article describes the PHP version of Alibaba Cloud OSS image upload class. Share it with everyone for your reference, the details are as follows:

[Related learning recommendations: php programming (video)]

1. Alibaba Cloud basic functions

/**
 * 把本地变量的内容到文件
 * 简单上传,上传指定变量的内存值作为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['img']['tmp_name']
{
  $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.Basic configuration and auxiliary functions

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

3.Main function

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

4.Core processing function

/**
 * 上传一个文件
 * @access public
 * @param mixed $name 数据
 * @param string $value 数据表名
 * @return string
 */
private function save($file) {
  $filename = $file['savepath'].$file['savename'];
  if(!$this->uploadReplace && $this->doesObjectExist($filename)) {
    // 不覆盖同名文件
    $this->error  =  '文件已经存在！'.$filename;
    return false;
  }
  // 如果是图像文件 检测文件格式
  if( in_array(strtolower($file['extension']),array('gif','jpg','jpeg','bmp','png','swf'))) {
    $info  = getimagesize($file['tmp_name']);
    if(false === $info || ('gif' == strtolower($file['extension']) && empty($info['bits']))){
      $this->error = '非法图像文件';
      return false;
    }
  }
  if(!$this->putObject($file['tmp_name'], $this->autoCharset($filename,'utf-8','gbk'))) {
    $this->error = '文件上传保存错误！';
    return false;
  }
  if($this->thumb && in_array(strtolower($file['extension']),array('gif','jpg','jpeg','bmp','png'))) {
    $image = getimagesize(C('OSS_IMG_URL').'/'.$filename);
    if(false !== $image) {
      //是图像文件生成缩略图
      $thumbWidth   =  explode(',',$this->thumbMaxWidth);
      $thumbHeight  =  explode(',',$this->thumbMaxHeight);
      $thumbPrefix  =  explode(',',$this->thumbPrefix);
      $thumbSuffix  =  explode(',',$this->thumbSuffix);
      $thumbFile   =  explode(',',$this->thumbFile);
      $thumbPath   =  $this->thumbPath?$this->thumbPath:dirname($filename).'/';
      $thumbExt    =  $this->thumbExt ? $this->thumbExt : $file['extension']; //自定义缩略图扩展名
      // 生成图像缩略图
      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.Auxiliary functions

/**
* 转换上传文件数组变量为正确的方式
* @access private
* @param array $files 上传的文件变量
* @return array
*/
private function dealFiles($files) {
    $fileArray = array();
    $n     = 0;
    foreach ($files as $key=>$file){
      if(is_array($file['name'])) {
        $keys    =  array_keys($file);
        $count   =  count($file['name']);
        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;
}

Summary: The difference from ordinary upload is that it all processes file saving through Alibaba Cloud's oss interface. Ordinary upload moves local files to the server, while it moves files to the Alibaba Cloud server.

Thumbnail idea:

a. Upload the image to the server
b. Get the image for processing
c .Upload the processed image to the server
d.Delete or not delete the original image of the server (OSS) according to the configuration

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

Related recommendations:Programming Video Course

The above is the detailed content of Detailed explanation of Alibaba Cloud OSS image upload class in PHP version. For more information, please follow other related articles on the PHP Chinese website!