ThinkPHP---TP功能类之上传

【一】概论

（1）上传操作的核心操作：移动临时文件（move_upload_file），在ThinkPHP里封装了上传类Upload.class.php

（2）上传类Upload.class.php代码分析，位置ThinkPHP/Library/Think/Upload.class.php

①上传配置信息

/**
     * 默认上传配置
     * @var array
     */
    private $config = array(
        //（text/html，image/jepg，image/png，image/gif，addType/Application.php为PHP文件类型。都相当于指定的文件格式）
        'mimes'         =>  array(), //允许上传的文件MiMe类型
        //PHP默认2M
        'maxSize'       =>  0, //上传的文件大小限制 (0-不做限制)
        //比如文本格式.txt，PHP格式为.php等
        'exts'          =>  array(), //允许上传的文件后缀
        //一般默认开启子目录，否则随着日期的增加。当前目录会越来越大，影响运行
        'autoSub'       =>  true, //自动子目录保存文件
        //子目录创建方式--按照日期创建，所以同一天上传的文件会被放到同一个目录下
        'subName'       =>  array('date', 'Y-m-d'), //子目录创建方式，[0]-函数名，[1]-参数，多个参数使用数组
        //相对于站点的根目录
        'rootPath'      =>  './Uploads/', //保存根路径
        'savePath'      =>  '', //保存路径
        //重命名上传文件，uniqid为PHP内置语法（生成唯一ID）。这里也可以用md5加密
        'saveName'      =>  array('uniqid', ''), //上传文件命名规则，[0]-函数名，[1]-参数，多个参数使用数组
        //一般不指定，保持原后缀。防止文件类型修改
        'saveExt'       =>  '', //文件保存后缀，空则使用原后缀
        'replace'       =>  false, //存在同名是否覆盖
        //hash类似于md2（32位编码，可逆反向编码，所以不大安全了）；
        //hash（也叫sha1），40位编码
        'hash'          =>  true, //是否生成hash编码
        'callback'      =>  false, //检测文件是否存在回调，如果存在返回文件信息数组
        //上传驱动有很多种：ftp（例如京东、百度等大型网站），网站和图片不在一个服务器，这时便用到了上传驱动
        //ThinkPHP下有几类，ThinkPHP\Library\Think\Upload\Driver目录下：BCS、Ftp、Local、Qiniu、Sae、Upyun等
        //新浪用的Sae，一般默认Local上传到本机
        'driver'        =>  '', // 文件上传驱动
        'driverConfig'  =>  array(), // 上传驱动配置
    );

拓展：hash编码及应用

hash编码也叫sha1编码，为40位编码

由来：之前的md5编码为32位编码，在部分网站上已经可逆了。所以安全性上有缺陷，于是开发了更加安全的hash(sha1)编码。多了8位，所以在解码可逆步骤增加难度，自然也就更加安全

应用案例：QQ的快传和网盘，PHP的原生方法sha1_file计算文件的sha1散列值，生成的值

QQ快传和网盘快速上传文件的实现原理：

①扫描文件，生成文件编码。可能是sha1也可能是md5编码；

②拿到编码后去数据库找，看之前有没有记录。此时注意，只通过文件名是无法识别的，因为文件名可能有改动。所以只能通过md5编码或者sha1编码去找。若找到文件之前有记录，直接拿到记录文件名，然后将对方文件传上去。相当于复制一份发了过去，然后重命名文件。

因此今后欧判断文件是否一样，不能通过文件名来判断。而要通过文件结构来进行判断

②构造方法：可以在实例化时传递一个配置数组，然后在内部进行合并配置操作；

③GetError方法：获取最后一次的上传错误信息；

语法：$upload->getError();

注意：因为该方法是上传类里的方法，所以应该由实例化的类去执行。而不是$this

④uploadOne方法：上传单个文件，参数是$_FILES中的子元素，返回值是上传的结果。（成功返回具有9个元素一维数组，失败返回false）

 /**
     * 上传单个文件
     * @param  array  $file 文件数组，通常是$_FILES中的子元素
     * @return array        上传成功后的文件信息
     */
    public function uploadOne($file){
        $info = $this->upload(array($file));
        return $info ? $info[0] : $info;
    }

⑤upload方法：参数通常是$_FILES整个数组，成功返回值是二维数组，失败返回false

/**
     * 上传文件
     * @param 文件信息数组 $files ，通常是 $_FILES数组
     */
    public function upload($files='') {...}

仔细查看代码后可以发现uploadOne方法其实也是调用了upload方法，完成单文件上传

⑥查看源码后发现上传错误，所以这里总结下上传错误0-7，注意没有5

0--------------没有错误，上传成功
1--------------上传的文件超过了 php.ini 中 upload_max_filesize 选项限制的值！
2--------------上传文件的大小超过了 HTML 表单中 MAX_FILE_SIZE 选项指定的值！
3--------------文件只有部分被上传！
4--------------没有文件被上传！
6--------------找不到临时文件夹！
7--------------文件写入失败，没有写入权限！

⑦至于其他checkSize(检查文件大小)、checkMime(检查文件Mime类型)、checkExt(检查文件后缀)等方法均为私有方法，只能在内部封装调用

总结：分析后得出公开的方法一共有4个---①构造方法实例化、②GetError返回错误、③uploadOne上传单个文件、④upoad上传多个文件

【案例】实现公文里的附件上传

（1）注意：要满足以下几个条件

①表单属性必须有entype属性声明表单上传数据除了字符外，还含有二进制流数据---enctype="multipart/form-data"

②文件域type="file"

③提交方式必须是post

（2）修改add方法中的表单数据处理

为了符合MVC的设计规范，需要自定义一个模型，然后将文件上传和数据保存，在模型里封装一个方法。由这个方法执行数据的保存

（3）创建模型文件Model.class.php

<?php
    namespace Admin\Model;
    use Think\Model;
    class DocModel extends Model{
    }
?>

之所以创建模型是由于添加操作无法一步执行，因为需要对文件上传进行处理。而处理的部分最好不要放在控制器里，所以单独拿出来。

控制器里只负责接受数据和判断执行结果，具体的数据保存操作和处理有模型执行

（4）修改控制器方法，改为接收数据和判断执行结果。具体的数据保存造作放到模型里执行

①实例化自定义模型；②保存由模型处理

（5）编写方法实现数据的保存

方法名：saveData

<?php
    namespace Admin\Model;
    use Think\Model;
    class DocModel extends Model{
        //saveData方法实现数据保存
        public function saveData($post,$file){
            //处理提交
            dump($file);die;
            //补全addtime字段
            $post['addtime']=time();
            $result = $this->add($post);
        }
    }
?>

这里我先选择一张图片，点击上传，预览下输出的格式，浏览器输出如下（输出$_FILES['file']）

array(1) {
  ["filename"] => array(5) {
    ["name"] => string(6) "03.jpg"
    ["type"] => string(10) "image/jpeg"     //MIME文件类型
    ["tmp_name"] => string(53) "C:\Users\Administrator\AppData\Local\Temp\phpA567.tmp" //临时文件，请求结束时便销毁了
    ["error"] => int(0)
    ["size"] => int(80669)
  }
}

注意：

1. 关于路径的说明

定义配置,配置上传路径

①如果地址是给服务器脚本使用的，则可以使用相对于入口文件的相对路径；也可以使用带盘符的绝对路径

②如果地址是给客户端用的，则地址应该写成"/"，相对于站点域名后的地址

在上传的案例中整个路径都不会传递给服务器，则路径属于第一种情况。在上传时保存路径建议写成带盘符的形式

2. 保存路径

后期上传的文件都将保存在Upload下，此时本地路径为C:\site\Public\Upload。但是这里要注意，要对路径进行拆分。因为后期项目上线，服务器的盘符和本地不一样，这时地址便会失效。所以必须对路径进行拆分，定义一个常量。

继续分析，上线后变得是前面的路径，即C:\site，而后面路径Public\Upload不会变。所以可以定义成两个常量，前面是工作路径，后面是固定路径。即使后期工作路径发送变化，也可以通过动态获取的方式获取到相关路径。通过魔术常量__DIR__获取，表示获取当前工作目录。

所以可以拆分为

__DIR__\Public\Upload

最后针对路径总结下：后期项目上线后即使使用绝对路径也可以动态获取

3. 常量定义：可以在入口文件定义常量

//定义工作路径。--因为从require开始执行底层代码，后面的不会被执行。所以放到require之前定义常量
define('WORKING_PATH', __DIR__);
//定义上传根目录。注意：名字不能相同，否则会覆盖
define('UPLOAD__ROOT_PATH', '/Public/Upload');
//输出检查下定义的两个常量
echo WORKING_PATH."<br/>".UPLOAD__ROOT_PATH;die;
输出：
C:\site
/Public/Upload------Window下目录分隔符默认反斜杠，所以要替换成正斜杠\
输出后发现有正斜杠也有反斜杠，所以还需要替换斜杠
将上述代码改为

//定义工作路径。--因为从require开始执行底层代码，后面的不会被执行。所以放到require之前定义常量
define('WORKING_PATH', str_replace(('\\'), '/', __DIR__));
//定义上传根目录。注意：名字不能相同，否则会覆盖
define('UPLOAD__ROOT_PATH', '/Public/Upload');
echo WORKING_PATH.UPLOAD__ROOT_PATH;die;
此时输出正常：C:/site/Public/Upload

（6）定义好常量后，输出检查

因为uploadOne方法上传单个文件，参数是$_FILES中的子元素，返回值是上传的结果（成功返回具有9个元素一维数组，失败返回false）

如果成功，这里会返回一维数组

（7）判断是否上传成功，并补全字段

拓展：

特别注意：保存上传路径时，数据表不可以写带盘符法人路径。因为上传的图片一般都要被浏览器使用。如果使用了带盘符的路径，那会导致http协议和file协议冲突

因为图片要展示给客户端，<img src='D:\www\itcast\1006\Public\Upload\17-01-02\01.jpg'/>，src肯定不能写成前面格式。绝对不可以把带盘符的地址输出到浏览器，因为服务器的协议是http协议，只有本地才可以用file协议

①静态资源路径没有盘符形式的，D:www\itcast\01\Public\upload\16-10-01\01.jpg。纯前端访问可以以file:\\协议进行访问

②而且因为服务器的协议都是http协议，所以不能用盘符形式的路径

③只有本地才能用file协议

最终代码：DocModel.class.php

<?php
//声明命名空间
namespace Admin\Model;
//引入父类
use Think\Model;
//声明并且继承父类
class DocModel extends Model{

    //saveData
    public function saveData($post,$file){
        //处理提交
        //dump($file);die;
        //先判断是否有文件需要处理
        if(!$file['error']){
            //定义配置
            $cfg = array(
                    //配置上传路径
                    'rootPath'    =>    WORKING_PATH . UPLOAD_ROOT_PATH
                );
            //处理上传
            $upload = new \Think\Upload($cfg);
            //开始上传
            $info = $upload -> uploadOne($file);
            //判断是否上传成功
            if($info){
                //补全剩余的三个字段
                // 图片路径为相对路径---固定目录+日期+文件名+后缀
                //因为后期数据库存的数据是给浏览器看的，所以路径上----不能带盘符，相对于站点根目录形式UPLOAD_ROOT_PATH
                $post['filepath'] = UPLOAD_ROOT_PATH . $info['savepath'] . $info['savename'];
                $post['filename'] = $info['name'];//文件的原始名
                $post['hasfile'] = 1;//是否有文件
            }else{
                //A方法实例化控制器
                A('Doc') -> error($upload -> getError());exit;
            }
        }
        //补全addtime字段
        $post['addtime'] = time();
        //添加操作
        return $this -> add($post);
    }
}

本文总结：MVC心得->如果可以直接进行CURD操作的，简单的基本操作可以直接在控制器编写。如果数据需要保存处理等操作，则最好放到模型里，进行数据的CURD操作。

.