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

本文实例讲述了php版阿里云OSS图片上传类。分享给大家供大家参考,具体如下:

1.阿里云基本函数

  1. /**
  2. * 把本地变量的内容到文件
  3. * 简单上传,上传指定变量的内存值作为object的内容
  4. */
  5. public function putObject($imgPath,$object)
  6. {
  7. $content = file_get_contents($imgPath); // 把当前文件的内容获取到传入文件中
  8. $options = array();
  9. try {
  10. $this->ossClient->putObject($this->bucket, $object, $content, $options);
  11. } catch (OssException $e) {
  12. return $e->getMessage();
  13. }
  14. return TRUE;
  15. }
  16. /**
  17. * 上传指定的本地文件内容
  18. */
  19. public function uploadFile($imgPath,$object) //$_FILES['img']['tmp_name']
  20. {
  21. $filePath = $imgPath;
  22. $options = array();
  23. try {
  24. $this->ossClient->uploadFile($this->bucket, $object, $filePath, $options);
  25. } catch (OssException $e) {
  26. return $e->getMessage();
  27. }
  28. return TRUE;
  29. }
  30. // 删除对象
  31. public function deleteObject($object) {
  32. try {
  33. $this->ossClient->deleteObject($this->bucket, $object);
  34. } catch (OssException $e) {
  35. return $e->getMessage();
  36. }
  37. return TRUE;
  38. }
  39. // 判断对象是否存在
  40. public function doesObjectExist($object) {
  41. try {
  42. $result = $this->ossClient->doesObjectExist($this->bucket, $object);
  43. } catch (OssException $e) {
  44. return $e->getMessage();
  45. }
  46. return $result;
  47. }
  48. // 批量删除对象
  49. public function deleteObjects($objects) {
  50. try {
  51. $this->ossClient->deleteObjects($this->bucket, $objects);
  52. } catch (OssException $e) {
  53. return $e->getMessage();
  54. }
  55. return TRUE;
  56. }
  57. /**
  58. * 获取object的内容
  59. *
  60. * @param OssClient $ossClient OssClient实例
  61. * @param string $bucket 存储空间名称
  62. * @return null
  63. */
  64. public function getObject($object)
  65. {
  66. $options = array();
  67. try {
  68. $content = $this->ossClient->getObject($this->bucket, $object, $options);
  69. } catch (OssException $e) {
  70. return $e->getMessage();
  71. }
  72. // file_get_contents
  73. return $content;
  74. }

2.基本配置与辅助函数

  1. public $ossClient,$bucket;
  2. private $configinfo = array(
  3. 'maxSize' => -1, // 上传文件的最大值
  4. 'supportMulti' => true, // 是否支持多文件上传
  5. 'allowExts' => array(), // 允许上传的文件后缀 留空不作后缀检查
  6. 'allowTypes' => array(), // 允许上传的文件类型 留空不做检查
  7. 'thumb' => false, // 使用对上传图片进行缩略图处理
  8. 'imageClassPath' => 'ORG.Util.Image', // 图库类包路径
  9. 'thumbMaxWidth' => '',// 缩略图最大宽度
  10. 'thumbMaxHeight' => '',// 缩略图最大高度
  11. 'thumbPrefix' => 'thumb_',// 缩略图前缀
  12. 'thumbSuffix' => '',
  13. 'thumbPath' => '',// 缩略图保存路径
  14. 'thumbFile' => '',// 缩略图文件名
  15. 'thumbExt' => '',// 缩略图扩展名
  16. 'thumbRemoveOrigin' => false,// 是否移除原图
  17. 'zipImages' => false,// 压缩图片文件上传
  18. 'autoSub' => false,// 启用子目录保存文件
  19. 'subType' => 'hash',// 子目录创建方式 可以使用hash date custom
  20. 'subDir' => '', // 子目录名称 subType为custom方式后有效
  21. 'dateFormat' => 'Ymd',
  22. 'hashLevel' => 1, // hash的目录层次
  23. 'savePath' => '',// 上传文件保存路径
  24. 'autoCheck' => true, // 是否自动检查附件
  25. 'uploadReplace' => false,// 存在同名是否覆盖
  26. 'saveRule' => 'uniqid',// 上传文件命名规则
  27. 'hashType' => 'md5_file',// 上传文件Hash规则函数名
  28. );
  29. // 错误信息
  30. private $error = '';
  31. // 上传成功的文件信息
  32. private $uploadFileInfo ;
  33. public function __get($name){
  34. if(isset($this->configinfo[$name])) {
  35. return $this->configinfo[$name];
  36. }
  37. return null;
  38. }
  39. public function __set($name,$value){
  40. if(isset($this->configinfo[$name])) {
  41. $this->configinfo[$name] = $value;
  42. }
  43. }
  44. public function __isset($name){
  45. return isset($this->configinfo[$name]);
  46. }
  47. /**
  48. * 架构函数
  49. * @access public
  50. * @param array $config 上传参数
  51. */
  52. public function __construct($config=array()) {
  53. if(is_array($config)) {
  54. $this->config = array_merge($this->config,$config);
  55. }
  56. $this->bucket = C('OSS_TEST_BUCKET');
  57. $this->ossClient = new OssClient(C('OSS_ACCESS_ID'), C('OSS_ACCESS_KEY'), C('OSS_ENDPOINT'), false);
  58. }

3.主函数

  1. /**
  2. * 上传所有文件
  3. * @access public
  4. * @param string $savePath 上传文件保存路径
  5. * @return string
  6. */
  7. public function upload($savePath ='') {
  8. //如果不指定保存文件名,则由系统默认
  9. if(emptyempty($savePath)) {
  10. $savePath = $this->savePath;
  11. }
  12. $fileInfo = array();
  13. $isUpload = false;
  14. // 获取上传的文件信息
  15. // 对$_FILES数组信息处理
  16. $files = $this->dealFiles($_FILES);
  17. foreach($files as $key => $file) {
  18. //过滤无效的上传
  19. if(!emptyempty($file['name'])) {
  20. //登记上传文件的扩展信息
  21. if(!isset($file['key'])) $file['key'] = $key;
  22. $file['extension'] = $this->getExt($file['name']);
  23. $file['savepath'] = $savePath;
  24. $file['savename'] = $this->getSaveName($file);
  25. // 自动检查附件
  26. if($this->autoCheck) {
  27. if(!$this->check($file))
  28. return false;
  29. }
  30. //保存上传文件
  31. if(!$this->save($file)) return false;
  32. if(function_exists($this->hashType)) {
  33. $fun = $this->hashType;
  34. $file['hash'] = $fun($this->autoCharset($file['savepath'].$file['savename'],'utf-8','gbk'));
  35. }
  36. //上传成功后保存文件信息,供其他地方调用
  37. unset($file['tmp_name'],$file['error']);
  38. $fileInfo[] = $file;
  39. $isUpload = true;
  40. }
  41. }
  42. if($isUpload) {
  43. $this->uploadFileInfo = $fileInfo;
  44. return true;
  45. }else {
  46. $this->error = '没有选择上传文件';
  47. return false;
  48. }
  49. }

4.核心处理函数

  1. /**
  2. * 上传一个文件
  3. * @access public
  4. * @param mixed $name 数据
  5. * @param string $value 数据表名
  6. * @return string
  7. */
  8. private function save($file) {
  9. $filename = $file['savepath'].$file['savename'];
  10. if(!$this->uploadReplace && $this->doesObjectExist($filename)) {
  11. // 不覆盖同名文件
  12. $this->error = '文件已经存在!'.$filename;
  13. return false;
  14. }
  15. // 如果是图像文件 检测文件格式
  16. if( in_array(strtolower($file['extension']),array('gif','jpg','jpeg','bmp','png','swf'))) {
  17. $info = getimagesize($file['tmp_name']);
  18. if(false === $info || ('gif' == strtolower($file['extension']) && emptyempty($info['bits']))){
  19. $this->error = '非法图像文件';
  20. return false;
  21. }
  22. }
  23. if(!$this->putObject($file['tmp_name'], $this->autoCharset($filename,'utf-8','gbk'))) {
  24. $this->error = '文件上传保存错误!';
  25. return false;
  26. }
  27. if($this->thumb && in_array(strtolower($file['extension']),array('gif','jpg','jpeg','bmp','png'))) {
  28. $image = getimagesize(C('OSS_IMG_URL').'/'.$filename);
  29. if(false !== $image) {
  30. //是图像文件生成缩略图
  31. $thumbWidth = explode(',',$this->thumbMaxWidth);
  32. $thumbHeight = explode(',',$this->thumbMaxHeight);
  33. $thumbPrefix = explode(',',$this->thumbPrefix);
  34. $thumbSuffix = explode(',',$this->thumbSuffix);
  35. $thumbFile = explode(',',$this->thumbFile);
  36. $thumbPath = $this->thumbPath?$this->thumbPath:dirname($filename).'/';
  37. $thumbExt = $this->thumbExt ? $this->thumbExt : $file['extension']; //自定义缩略图扩展名
  38. // 生成图像缩略图
  39. import($this->imageClassPath);
  40. for($i=0,$len=count($thumbWidth); $i<$len; $i++) {
  41. if(!emptyempty($thumbFile[$i])) {
  42. $thumbname = $thumbFile[$i];
  43. }else{
  44. $prefix = isset($thumbPrefix[$i])?$thumbPrefix[$i]:$thumbPrefix[0];
  45. $suffix = isset($thumbSuffix[$i])?$thumbSuffix[$i]:$thumbSuffix[0];
  46. $thumbname = $prefix.basename($filename,'.'.$file['extension']).$suffix;
  47. }
  48. $this->thumb(C('OSS_IMG_URL').'/'.$filename,$thumbPath.$thumbname.'.'.$thumbExt,'',$thumbWidth[$i],$thumbHeight[$i],true);
  49. }
  50. if($this->thumbRemoveOrigin) {
  51. // 生成缩略图之后删除原图
  52. $this->deleteObject($filename);
  53. }
  54. }
  55. }
  56. if($this->zipImags) {
  57. // TODO 对图片压缩包在线解压
  58. }
  59. return true;
  60. }
  61. /**
  62. * 生成缩略图
  63. * @static
  64. * @access public
  65. * @param string $image 原图
  66. * @param string $type 图像格式
  67. * @param string $thumbname 缩略图文件名
  68. * @param string $maxWidth 宽度
  69. * @param string $maxHeight 高度
  70. * @param string $position 缩略图保存目录
  71. * @param boolean $interlace 启用隔行扫描
  72. * @return void
  73. */
  74. public function thumb($image, $thumbname, $type='', $maxWidth=200, $maxHeight=50, $interlace=true) {
  75. // 获取原图信息
  76. $info = Image::getImageInfo($image);
  77. if ($info !== false) {
  78. $srcWidth = $info['width'];
  79. $srcHeight = $info['height'];
  80. $type = emptyempty($type) ? $info['type'] : $type;
  81. $type = strtolower($type);
  82. $interlace = $interlace ? 1 : 0;
  83. unset($info);
  84. $scale = min($maxWidth / $srcWidth, $maxHeight / $srcHeight); // 计算缩放比例
  85. if ($scale >= 1) {
  86. // 超过原图大小不再缩略
  87. $width = $srcWidth;
  88. $height = $srcHeight;
  89. } else {
  90. // 缩略图尺寸
  91. $width = (int) ($srcWidth * $scale);
  92. $height = (int) ($srcHeight * $scale);
  93. }
  94. // 载入原图
  95. $createFun = 'ImageCreateFrom' . ($type == 'jpg' ? 'jpeg' : $type);
  96. if(!function_exists($createFun)) {
  97. return false;
  98. }
  99. $srcImg = $createFun($image);
  100. //创建缩略图
  101. if ($type != 'gif' && function_exists('imagecreatetruecolor'))
  102. $thumbImg = imagecreatetruecolor($width, $height);
  103. else
  104. $thumbImg = imagecreate($width, $height);
  105. //png和gif的透明处理 by luofei614
  106. if('png'==$type){
  107. imagealphablending($thumbImg, false);//取消默认的混色模式(为解决阴影为绿色的问题)
  108. imagesavealpha($thumbImg,true);//设定保存完整的 alpha 通道信息(为解决阴影为绿色的问题)
  109. }elseif('gif'==$type){
  110. $trnprt_indx = imagecolortransparent($srcImg);
  111. if ($trnprt_indx >= 0) {
  112. //its transparent
  113. $trnprt_color = imagecolorsforindex($srcImg , $trnprt_indx);
  114. $trnprt_indx = imagecolorallocate($thumbImg, $trnprt_color['red'], $trnprt_color['green'], $trnprt_color['blue']);
  115. imagefill($thumbImg, 0, 0, $trnprt_indx);
  116. imagecolortransparent($thumbImg, $trnprt_indx);
  117. }
  118. }
  119. // 复制图片
  120. if (function_exists("ImageCopyResampled"))
  121. imagecopyresampled($thumbImg, $srcImg, 0, 0, 0, 0, $width, $height, $srcWidth, $srcHeight);
  122. else
  123. imagecopyresized($thumbImg, $srcImg, 0, 0, 0, 0, $width, $height, $srcWidth, $srcHeight);
  124. // 对jpeg图形设置隔行扫描
  125. if ('jpg' == $type || 'jpeg' == $type)
  126. imageinterlace($thumbImg, $interlace);
  127. imagePNG($thumbImg,'Uploads/file.png'); // 中转站
  128. // 生成图片
  129. $this->putObject('Uploads/file.png',$thumbname);
  130. imagedestroy($thumbImg);
  131. imagedestroy($srcImg);
  132. return $thumbname;
  133. }
  134. return false;
  135. }

5.辅助函数

  1. /**
  2. * 转换上传文件数组变量为正确的方式
  3. * @access private
  4. * @param array $files 上传的文件变量
  5. * @return array
  6. */
  7. private function dealFiles($files) {
  8. $fileArray = array();
  9. $n = 0;
  10. foreach ($files as $key=>$file){
  11. if(is_array($file['name'])) {
  12. $keys = array_keys($file);
  13. $count = count($file['name']);
  14. for ($i=0; $i<$count; $i++) {
  15. $fileArray[$n]['key'] = $key;
  16. foreach ($keys as $_key){
  17. $fileArray[$n][$_key] = $file[$_key][$i];
  18. }
  19. $n++;
  20. }
  21. }else{
  22. $fileArray[$key] = $file;
  23. }
  24. }
  25. return $fileArray;
  26. }
  27. /**
  28. * 检查上传的文件
  29. * @access private
  30. * @param array $file 文件信息
  31. * @return boolean
  32. */
  33. private function check($file) {
  34. if($file['error']!== 0) {
  35. //文件上传失败
  36. //捕获错误代码
  37. $this->error($file['error']);
  38. return false;
  39. }
  40. //文件上传成功,进行自定义规则检查
  41. //检查文件大小
  42. if(!$this->checkSize($file['size'])) {
  43. $this->error = '上传文件大小不符!';
  44. return false;
  45. }
  46. //检查文件Mime类型
  47. if(!$this->checkType($file['type'])) {
  48. $this->error = '上传文件MIME类型不允许!';
  49. return false;
  50. }
  51. //检查文件类型
  52. if(!$this->checkExt($file['extension'])) {
  53. $this->error ='上传文件类型不允许';
  54. return false;
  55. }
  56. //检查是否合法上传
  57. if(!$this->checkUpload($file['tmp_name'])) {
  58. $this->error = '非法上传文件!';
  59. return false;
  60. }
  61. return true;
  62. }
  63. // 自动转换字符集 支持数组转换
  64. private function autoCharset($fContents, $from='gbk', $to='utf-8') {
  65. $from = strtoupper($from) == 'UTF8' ? 'utf-8' : $from;
  66. $to = strtoupper($to) == 'UTF8' ? 'utf-8' : $to;
  67. if (strtoupper($from) === strtoupper($to) || emptyempty($fContents) || (is_scalar($fContents) && !is_string($fContents))) {
  68. //如果编码相同或者非字符串标量则不转换
  69. return $fContents;
  70. }
  71. if (function_exists('mb_convert_encoding')) {
  72. return mb_convert_encoding($fContents, $to, $from);
  73. } elseif (function_exists('iconv')) {
  74. return iconv($from, $to, $fContents);
  75. } else {
  76. return $fContents;
  77. }
  78. }
  79. /**
  80. * 检查上传的文件类型是否合法
  81. * @access private
  82. * @param string $type 数据
  83. * @return boolean
  84. */
  85. private function checkType($type) {
  86. if(!emptyempty($this->allowTypes))
  87. return in_array(strtolower($type),$this->allowTypes);
  88. return true;
  89. }
  90. /**
  91. * 检查上传的文件后缀是否合法
  92. * @access private
  93. * @param string $ext 后缀名
  94. * @return boolean
  95. */
  96. private function checkExt($ext) {
  97. if(!emptyempty($this->allowExts))
  98. return in_array(strtolower($ext),$this->allowExts,true);
  99. return true;
  100. }
  101. /**
  102. * 检查文件大小是否合法
  103. * @access private
  104. * @param integer $size 数据
  105. * @return boolean
  106. */
  107. private function checkSize($size) {
  108. return !($size > $this->maxSize) || (-1 == $this->maxSize);
  109. }
  110. /**
  111. * 检查文件是否非法提交
  112. * @access private
  113. * @param string $filename 文件名
  114. * @return boolean
  115. */
  116. private function checkUpload($filename) {
  117. return is_uploaded_file($filename);
  118. }
  119. /**
  120. * 取得上传文件的后缀
  121. * @access private
  122. * @param string $filename 文件名
  123. * @return boolean
  124. */
  125. private function getExt($filename) {
  126. $pathinfo = pathinfo($filename);
  127. return $pathinfo['extension'];
  128. }
  129. /**
  130. * 取得上传文件的信息
  131. * @access public
  132. * @return array
  133. */
  134. public function getUploadFileInfo() {
  135. return $this->uploadFileInfo;
  136. }
  137. /**
  138. * 取得最后一次错误信息
  139. * @access public
  140. * @return string
  141. */
  142. public function getErrorMsg() {
  143. return $this->error;
  144. }

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

缩略图思路:

a.上传图片至服务器

b.获取图片进行处理

c.上传处理好的图片至服务器

d.根据配置,删除或者不删除服务器的原图(OSS)

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