文件上传与原理（单文件、多文件上传）

文件上传

1. 文件上传配置

文件上传项目项在php.ini中设置,常用的配置项有:

序号	配置项	默认值	描述
1	file_uploads	On	使 PHP 支持文件上传
2	upload_tmp_dir	/tmp	指示应该临时把上传的文件存储在什么位置
3	max_file_uploads	20	单次请求时允许上传的最大文件数量
4	max_execution_time	30	设置 PHP 最长执行时间(秒)
5	max_input_time	60	设置 PHP 通过 POST/GET/PUT 接收数据的时长(秒)
6	memory_limit	128M	系统分配给当前脚本执行可用的最大内存容量
7	post_max_size	8M	允许的 POST 数据的总大小（以字节为单位）
8	upload_max_filesize	32M	允许的尽可能最大的文件上传（以字节为单位）

---

$_FILES

• 上传文件的描述信息,全部保存在系统全局变量$_FILES中
• $_FILES以二维数组形式保存: $_FILES['form_file_name']['key']
• 'form_file_name': 对应着表单中<input type="file" name="my_pic">中name属性值
• 'key': 共有 5 个键名, 描述如下:

序号	键名	描述
1	name	文件在客户端的原始文件名(即存在用户电脑上的文件名)
2	type	文件的 MIME 类型, 由浏览器提供, PHP 并不检查它
3	tmp_name	文件被上传到服务器上之后,在临时目录中临时文件名
4	error	和该文件上传相关的错误代码
5	size	已上传文件的大小(单位为字节)

• 文件上传错误信息描述

序号	常量	值	描述
1	UPLOAD_ERR_OK	0	没有错误发生,文件上传成功
2	UPLOAD_ERR_INI_SIZE	1	文件超过php.ini中upload_max_filesize值
3	UPLOAD_ERR_FORM_SIZE	2	文件大小超过表单中MAX_FILE_SIZE指定的值
4	UPLOAD_ERR_PARTIAL	3	文件只有部分被上传
5	UPLOAD_ERR_NO_FILE	4	没有文件被上传
6	UPLOAD_ERR_NO_TMP_DIR	6	找不到临时文件夹
7	UPLOAD_ERR_CANT_WRITE	7	文件写入失败

• 支持文件上传的前端表单设置

序号	属性设置	描述
1	<form method="POST">	请求类型必须是POST
2	<form enctype="multipart/form-data">	设置表单提交数据的编码类型
3	<input type="file" name="uploads">	设置表单控件类型与名称以支持上传
4	<input type="hidden" name="MAX_FILE_SIZE" value="...">	设置隐藏域限制上传文件大小(可选)

• [扩展] enctype属性说明

enctype: 设置表单数据,在发送到服务器之前的编码规则

序号	属性值	描述
1	application/x-www-form-urlencoded	默认值, 发送前进行编码,空格转+,非空字符转 16 进制
2	multipart/form-data	不对字符编码,以二进制发送,适合文件上传
3	text/plain	纯文本发送,仅对空格编码(转为+)

4. MIME 类型

4.1 概述

• MIME: (Multipurpose Internet Mail Extensions)的简写,中文意思”多功能因特网邮件扩展”
• MIME: 最初用来表示 Email 附件格式的字符串, 后来演变成为网络文档或应用程序的文档格式规范
• MIME: 由一个媒体类型一个子类组成, 中间用斜线/分隔,例如text/css

4.2 类型

序号	类型	描述	示例
1	text	文本	text/plain,text/html,text/css,text/javascript
2	image	图像 1	image/jpeg,image/gif,image/png,image/bmp,image/ webp,
2	image	图像 2	image/x-icon, image/vnd.microsoft.icon
3	audio	音频	audio/midi, audio/mpeg, audio/webm, audio/ogg, audio/wav
4	video	视频	video/mp4,video/mpeg,video/webm, video/ogg,video/x-msvideo
5	application	二进制 1	application/octet-stream, application/javascript, application/ecmascript
5	application	二进制 2	application/json,application/pkcs12, application/vnd.mspowerpoint
5	application	二进制 3	application/xhtml+xml, application/xml, application/pdf,application/x-gzip

• 表中,以x-为前缀的是还没有成为国际标准的格式
• 如果某个文档不在该列表中,会识别为: applicaton/octet-stream, 如.md文档, 尽管它是纯文本

单文件上传:异常处理演练代码：

<?php
//$_FILES
printf('<pre>%s<pre>', print_r($_FILES, true));
//自定义上传异常类
 class UploadException extends Exception
 {     //在异常子类中，可以访问并重写Exception中的四个属性，通过——tostring()格式化异常输出信息
    public function __toString()
    {
        return <<< UPLOAD
<style>
table {border-collapse: collapse;border:1px solid black;text-align: center;}
td {border:1px solid black;padding: 5px;}
tr:first-of-type {background-color:#eee;}
tr:last-of-type td {color: coral;}
</style>
<table>
<tr><td>代码</td><td>信息</td><td>文件</td><td>行号</td></tr>
<tr><td>$this->code</td><td>$this->message</td><td>$this->file</td><td>$this->line</td></tr>
</table>
UPLOAD;
    }
}
try {
    //可能抛出的异常代码
    //上传出错的代码
    $errorCode = $_FILES['my_pic']['error'];
    if ($errorCode > UPLOAD_ERR_OK) {
        switch ($errorCode) {
            case UPLOAD_ERR_INI_SIZE:
                throw new UploadException('上传的文件超过了 php.ini 中 upload_max_filesize 选项限制的值', 1);
            break;
            case UPLOAD_ERR_FORM_SIZE:
                throw new UploadException('上传文件的大小超过了 HTML 表单中 MAX_FILE_SIZE 选项指定的值', 2);
                break;
            case UPLOAD_ERR_PARTIAL:
                throw new UploadException('文件只有部分被上传', 3);
                break;
            case UPLOAD_ERR_NO_FILE:
                throw new UploadException('没有文件被上传', 4);
                break;
            case UPLOAD_ERR_NO_TMP_DIR:
                throw new UploadException('找不到临时文件夹', 6);
                break;
            case UPLOAD_ERR_CANT_WRITE:
                throw new UploadException('文件写入失败', 7);
                break;
            default:
                // 测试时建议关掉default: 避免误报影响
                throw new UploadException('未知类型错误', 8);
        }
    }
    // 判断文件类型
    $fileType = $_FILES['my_pic']['type'];
    if (strstr($fileType, '/', true) !== 'image') throw new UploadException('文件类型错误',9);
} catch (UploadException $e) {
    echo $e;
}
?>
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>文件上传变量$_FILES</title>
</head>
<body>
    <form action="" method="POST" enctype="multipart/form-data" >
<fieldset>
    <legend>单文件上传:异常处理</legend>
    <!-- 设置隐藏域限制上传文件大小(可选) -->
    <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
    <input type="file" name="my_pic" >
    <button>上传</button>
</fieldset>
</form>
</body>
</html>

单文件上传:异常处理演练图：

---

学习总结

• 在没有学习这节课之前，在网络上使用此功能时完全不懂这是什么原理，以什么方式来提示错误，怎么检测到不支持的类型等等，通过学习发现实现这些功能提示并没有想象中的难，老师讲的时候能明白，但是代码不记得，单词不记得。