一、PHP配置

序号	配置项	默认值	描述
1	`file_uploads`	`On`	`on`支持文件上传；`off` 不支持
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`	文件写入失败

四、演示代码

单文件上传


<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>单文件上传</title>
    <style>
        form {
            width: 240px;
        }
        fieldset {
            background-color: #BED3DC;
        }
        legend {
            font-size: 20px;
        }
         form  button {
             width: 60px;
             margin-top: 15px;
         }
    </style>
</head>
<body>
<!-- action:处理上传脚本, method: 必须是POST, multipart/form-data:允许接收表单提交的文件 -->
<form action="" method="POST" enctype="multipart/form-data">
    <fieldset>
        <legend>单文件上传</legend>
        <!-- 这个上传文件大小的限制字段,必须写到file字段的前面 -->
        <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
        <input type="file" name="user_pic">
        <button>上传</button>
    </fieldset>
</form>
</body>
</html>
<?php
//自定义异常类
use Exception;
class MyException extends Exception
{
// 改写__tostring方法
    public function __toString() :string
    {
        return <<<HEREDOC
        <style>
        table {width: 238px;border-collapse: collapse;border:1px solid black;text-align: center;margin-top: 20px;}
        td {border:1px solid black;padding: 5px;}
        tr > td:first-of-type {background-color: yellow;font-size: 20px}
        span {color: red}
        </style>
            <table>
                <tr>
                    <td>异常<span>内容</span></td>
                    <td>$this->message</td>
                </tr>
                <tr>
                    <td>异常<span>代码</span></td>
                    <td>$this->code</td>
                </tr>
                <tr>
                    <td>异常<span>行号</span></td>
                    <td>$this->line</td>
                </tr>
            </table>
        HEREDOC;
    }
}
// 使用自定义异常类检测上传出错的代码
try {
    $errorCode = $_FILES['user_pic']['error'];
    if ($errorCode > UPLOAD_ERR_OK) {
        switch ($errorCode) {
            case UPLOAD_ERR_INI_SIZE:
                throw new MyException('上传的文件超过了php.ini中upload_max_filesize选项限制的值');
                break;
            case UPLOAD_ERR_FORM_SIZE:
                throw new MyException('上传文件的大小超过了HTML表单中 MAX_FILE_SIZE选项指定的值');
                break;
            case UPLOAD_ERR_PARTIAL:
                throw new MyException('文件只有部分被上传');
                break;
            case UPLOAD_ERR_NO_FILE:
                throw new MyException('没有文件被上传');
                break;
            case UPLOAD_ERR_NO_TMP_DIR:
                throw new MyException('找不到临时文件夹');
                break;
            case UPLOAD_ERR_CANT_WRITE:
                throw new MyException('文件写入失败');
                break;
            default:
                // throw new MyException('未知类型错误');
        }
    }
    // 判断文件类型
    $fileType = $_FILES['user_pic']['type'];
    // echo (strstr($fileType, '/', true));die;
    if (strstr($fileType, '/', true) !== 'image') throw new MyException('文件类型错误');
    // 将文件从临时目录 移动到用户自定义的目标目录中
    // $tempFileName:临时文件名
    $tempFileName = $_FILES['user_pic']['tmp_name'];
    if (is_uploaded_file($tempFileName)) {
        // 原始文件名
        $originalFileName = $_FILES['user_pic']['name'];
        // 目标文件名
        $destFileName =  'images/'.md5(time().mt_rand(1,1000)).strstr($originalFileName, '.');
        // 移动文件到目标目录使用的函数
        if (move_uploaded_file($tempFileName, $destFileName)) {
            echo "<p>$originalFileName: 上传成功...</p>";
            // 预览
            echo "<img src='{$destFileName}' width='200'>";
        }
    }
} catch (MyException $er) {
    echo $er;
}
?>

演示效果：

多文件逐条上传

<form action="" method="POST" enctype="multipart/form-data">
    <fieldset>
        <legend>多文件逐个上传</legend>
        <!-- 这个上传文件大小的限制字段,必须写到file字段的前面 -->
        <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
        <input type="file" name="user_pic[]">
        <input type="file" name="user_pic[]">
        <input type="file" name="user_pic[]">
        <input type="file" name="user_pic[]">
        <button>上传</button>
    </fieldset>
</form>
<?php
 // 判断文件类型
    $fileType = $_FILES['user_pic']['type'];
    // echo (strstr($fileType, '/', true));die;
    if (strstr($fileType, '/', true) !== 'image') throw new MyException('文件类型错误');
    if ($_FILES['user_pic'])
        foreach ($_FILES['user_pic']['error'] as $key => $error) {
            // 只要判断 error === 0
            if ($error === UPLOAD_ERR_OK) {
                // 临时文件名
                $tmpFileName = $_FILES['user_pic']['tmp_name'][$key];
                // 原始文件名
                $originalFileName = $_FILES['user_pic']['name'][$key];
                // 目标文件名
                $destFileName = 'images/'.md5(time().mt_rand(1,1000)).strstr($originalFileName, '.');
                // 移动文件
                move_uploaded_file($tmpFileName, $destFileName);
                echo "<p>$originalFileName: 上传成功...</p>";
                // 预览
                echo "<img src='{$destFileName}' width='200'>";
            }
        }
} catch (MyException $er) {
    echo $er;
}
?>

演示效果：

多文件批量上传

<input type="file" name="user_pic[]" multiple>
multiple

<form action="" method="POST" enctype="multipart/form-data">
    <fieldset>
        <legend>多文件逐个上传</legend>
        <!-- 这个上传文件大小的限制字段,必须写到file字段的前面 -->
        <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
        <input type="file" name="user_pic[]" multiple>
        <button>上传</button>
    </fieldset>
</form>