php基礎之常用圖片處理類

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2009 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <[email protected]>
// +----------------------------------------------------------------------

/**
 * 文件上傳類
 * @category   ORG
 * @package  ORG
 * @subpackage  Net
 * @author    liu21st <[email protected]>
 */
class UploadFile {//類定義開始

    private $config =   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->config[$name])) {
            return $this->config[$name];
        }
        return null;
    }

    public function __set($name,$value){
        if(isset($this->config[$name])) {
            $this->config[$name]    =   $value;
        }
    }

    public function __isset($name){
        return isset($this->config[$name]);
    }
    
    /**
     * 架構函數
     * @access public
     * @param array $config  上傳參數
     */
    public function __construct($config=array()) {
        if(is_array($config)) {
            $this->config   =   array_merge($this->config,$config);
        }
    }

    /**
     * 上傳一個文件
     * @access public
     * @param mixed $name 數據
     * @param string $value  數據表名
     * @return string
     */
    private function save($file) {
        $filename = $file['savepath'].$file['savename'];
        if(!$this->uploadReplace && is_file($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(!move_uploaded_file($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($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,'.'.$file['extension']).$suffix;
                    }
                    Image::thumb($filename,$thumbPath.$thumbname.'.'.$thumbExt,'',$thumbWidth[$i],$thumbHeight[$i],true);                    
                }
                if($this->thumbRemoveOrigin) {
                    // 生成縮略圖之後刪除原圖
                    unlink($filename);
                }
            }
        }
        if($this->zipImags) {
            // TODO 對圖片壓縮包在線解壓

        }
        return true;
    }

    /**
     * 上傳所有文件
     * @access public
     * @param string $savePath  上傳文件保存路徑
     * @return string
     */
    public function upload($savePath ='') {
        //如果不指定保存文件名,則由系統默認
        if(empty($savePath))
            $savePath = $this->savePath;
        // 檢查上傳目錄
        if(!is_dir($savePath)) {
            // 檢查目錄是否編碼後的
            if(is_dir(base64_decode($savePath))) {
                $savePath	=	base64_decode($savePath);
            }else{
                // 嘗試創建目錄
                if(!mkdir($savePath)){
                    $this->error  =  '上傳目錄'.$savePath.'不存在';
                    return false;
                }
            }
        }else {
            if(!is_writeable($savePath)) {
                $this->error  =  '上傳目錄'.$savePath.'不可寫';
                return false;
            }
        }
        $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;
        }
    }

    /**
     * 上傳單個上傳字段中的文件 支持多附件
     * @access public
     * @param array $file  上傳文件信息
     * @param string $savePath  上傳文件保存路徑
     * @return string
     */
    public function uploadOne($file,$savePath=''){
        //如果不指定保存文件名,則由系統默認
        if(empty($savePath))
            $savePath = $this->savePath;
        // 檢查上傳目錄
        if(!is_dir($savePath)) {
            // 嘗試創建目錄
            if(!mkdir($savePath,0777,true)){
                $this->error  =  '上傳目錄'.$savePath.'不存在';
                return false;
            }
        }else {
            if(!is_writeable($savePath)) {
                $this->error  =  '上傳目錄'.$savePath.'不可寫';
                return false;
            }
        }
        //過濾無效的上傳
        if(!empty($file['name'])) {
            $fileArray = array();
            if(is_array($file['name'])) {
               $keys = array_keys($file);
               $count	 =	 count($file['name']);
               for ($i=0; $i<$count; $i++) {
                   foreach ($keys as $key)
                       $fileArray[$i][$key] = $file[$key][$i];
               }
            }else{
                $fileArray[] =  $file;
            }
            $info =  array();
            foreach ($fileArray as $key=>$file){
                //登記上傳文件的擴展信息
                $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']);
                $info[] = $file;
            }
            // 返回上傳的文件信息
            return $info;
        }else {
            $this->error  =  '沒有選擇上傳文件';
            return false;
        }
    }

    /**
     * 轉換上傳文件數組變量爲正確的方式
     * @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]['key'] = $key;
                    foreach ($keys as $_key){
                        $fileArray[$n][$_key] = $file[$_key][$i];
                    }
                    $n++;
                }
            }else{
               $fileArray[$key] = $file;
            }
        }
       return $fileArray;
    }

    /**
     * 獲取錯誤代碼信息
     * @access public
     * @param string $errorNo  錯誤號碼
     * @return void
     */
    protected function error($errorNo) {
         switch($errorNo) {
            case 1:
                $this->error = '上傳的文件超過了 php.ini 中 upload_max_filesize 選項限制的值';
                break;
            case 2:
                $this->error = '上傳文件的大小超過了 HTML 表單中 MAX_FILE_SIZE 選項指定的值';
                break;
            case 3:
                $this->error = '文件只有部分被上傳';
                break;
            case 4:
                $this->error = '沒有文件被上傳';
                break;
            case 6:
                $this->error = '找不到臨時文件夾';
                break;
            case 7:
                $this->error = '文件寫入失敗';
                break;
            default:
                $this->error = '未知上傳錯誤!';
        }
        return ;
    }

    /**
     * 根據上傳文件命名規則取得保存文件名
     * @access private
     * @param string $filename 數據
     * @return string
     */
    private function getSaveName($filename) {
        $rule = $this->saveRule;
        if(empty($rule)) {//沒有定義命名規則,則保持文件名不變
            $saveName = $filename['name'];
        }else {
            if(function_exists($rule)) {
                //使用函數生成一個唯一文件標識號
                $saveName = $rule().".".$filename['extension'];
            }else {
                //使用給定的文件名作爲標識號
                $saveName = $rule.".".$filename['extension'];
            }
        }
        if($this->autoSub) {
            // 使用子目錄保存文件
            $filename['savename'] = $saveName;
            $saveName = $this->getSubName($filename).$saveName;
        }
        return $saveName;
    }

    /**
     * 獲取子目錄的名稱
     * @access private
     * @param array $file  上傳的文件信息
     * @return string
     */
    private function getSubName($file) {
        switch($this->subType) {
            case 'custom':
                $dir    =   $this->subDir;
                break;
            case 'date':
                $dir    =   date($this->dateFormat,time()).'/';
                break;
            case 'hash':
            default:
                $name   =   md5($file['savename']);
                $dir    =   '';
                for($i=0;$i<$this->hashLevel;$i++) {
                    $dir   .=  $name{$i}.'/';
                }
                break;
        }
        if(!is_dir($file['savepath'].$dir)) {
            mkdir($file['savepath'].$dir,0777,true);
        }
        return $dir;
    }

    /**
     * 檢查上傳的文件
     * @access private
     * @param array $file 文件信息
     * @return boolean
     */
    private function check($file) {
        if($file['error']!== 0) {
            //文件上傳失敗
            //捕獲錯誤代碼
            $this->error($file['error']);
            return false;
        }
        //文件上傳成功,進行自定義規則檢查
        //檢查文件大小
        if(!$this->checkSize($file['size'])) {
            $this->error = '上傳文件大小不符!';
            return false;
        }

        //檢查文件Mime類型
        if(!$this->checkType($file['type'])) {
            $this->error = '上傳文件MIME類型不允許!';
            return false;
        }
        //檢查文件類型
        if(!$this->checkExt($file['extension'])) {
            $this->error ='上傳文件類型不允許';
            return false;
        }

        //檢查是否合法上傳
        if(!$this->checkUpload($file['tmp_name'])) {
            $this->error = '非法上傳文件!';
            return false;
        }
        return true;
    }

    // 自動轉換字符集 支持數組轉換
    private function autoCharset($fContents, $from='gbk', $to='utf-8') {
        $from   = strtoupper($from) == 'UTF8' ? 'utf-8' : $from;
        $to     = strtoupper($to) == 'UTF8' ? 'utf-8' : $to;
        if (strtoupper($from) === strtoupper($to) || empty($fContents) || (is_scalar($fContents) && !is_string($fContents))) {
            //如果編碼相同或者非字符串標量則不轉換
            return $fContents;
        }
        if (function_exists('mb_convert_encoding')) {
            return mb_convert_encoding($fContents, $to, $from);
        } elseif (function_exists('iconv')) {
            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['extension'];
    }

    /**
     * 取得上傳文件的信息
     * @access public
     * @return array
     */
    public function getUploadFileInfo() {
        return $this->uploadFileInfo;
    }

    /**
     * 取得最後一次錯誤信息
     * @access public
     * @return string
     */
    public function getErrorMsg() {
        return $this->error;
    }
}

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章