微信公众号 讲师中心
首页
文章
后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 自媒体 新闻
专题
后端开发 web前端 数据库 开发工具 php框架 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 新闻
AI工具
AI 聊天问答 Agent智能体 AI 文本写作 AI 绘画作图 AI 设计工具 AI 视频创作 AI 音频制作 AI 办公学习 AI 编程开发 Prompt指令
学习
大前端 后端开发 数据库 移动端 运维开发 计算机基础
编程手册
大前端 后端开发 数据库 移动端 运维开发 计算机基础
下载
js特效 网站源码 工具下载 类库下载 网站素材 学习资源 插件扩展 手机/移动开发 手机游戏
搜索
后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程
自媒体 新闻
首页 > 博客列表 > 细说文件上传原理与实战
博主信息
博文 26
粉丝 0
评论 0
访问量 28501
专题推荐
更多>
相关推荐
热门教程
更多>
相关教程
热门推荐
最新课程
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
细说文件上传原理与实战
溪边小树
原创
2031人浏览过

文件上传

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文档, 尽管它是纯文本

示例演示

前期准备基本代码：

  1. <?php
  2. // 查看与文件上传相关的配置项
  3. phpinfo();
  4. //了解各配置项的基本信息
  5. -------------
  6. <?php
  7. // $_FILES
  8. printf('<pre>%s</pre>', print_r($_FILES, true));
  9. // 二维数组: 只有一个元素
  10. ?>
  11. <!DOCTYPE html>
  12. <html lang="en">
  13. <head>
  14.     <meta charset="UTF-8">
  15.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  16.     <title>文件上传变量$_FILES</title>
  17. </head>
  18. <body>
  19.     <form action="" method="POST" enctype="multipart/form-data">
  20.     <fieldset>
  21.         <legend>单文件上传</legend>
  22.         <input type="hidden" name="MAX_FILE_SIZE" value="500000">
  23.         <input type="file" name="my_pic">
  24.         <button>上传</button>
  25.     </fieldset>
  26.     </form>
  27. </body>
  28. </html>
  29. ---------------
  30. <?php
  31. // $_FILES
  32. printf('<pre>%s</pre>', print_r($_FILES, true));
  34. $errorCode = $_FILES['my_pic']['error'];
  36. if (UPLOAD_ERR_NO_FILE === $errorCode) echo '<p>没有文件被上传</p>';
  38. // if (empty($_FILES['my_pic']['name'])) echo '<p>没有文件被上传</p>'
  39. ?>
  40. <!DOCTYPE html>
  41. <html lang="en">
  42. <head>
  43.     <meta charset="UTF-8">
  44.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  45.     <title>文件上传变量$_FILES</title>
  46. </head>
  47. <body>
  48.     <form action="" method="POST" enctype="multipart/form-data">
  49.     <fieldset>
  50.         <legend>单文件上传: 检查是否有文件被上传</legend>
  51.         <input type="hidden" name="MAX_FILE_SIZE" value="500000">
  52.         <input type="file" name="my_pic">
  53.         <button>上传</button>
  54.     </fieldset>
  55.     </form>
  56. </body>
  57. </html>
  58. -----------
  59. <?php
  60. // $_FILES
  61. printf('<pre>%s</pre>', print_r($_FILES, true));
  62. // 检测当前文件是否是通过 HTTP POST 方式上传的
  63. $tmpFileName = $_FILES['my_pic']['tmp_name'];
  64. $originalFileName = $_FILES['my_pic']['name'];
  67. if (is_uploaded_file($tmpFileName)) echo "{$orginalFileName}: 上传方式合法";
  68. ?>
  69. <!DOCTYPE html>
  70. <html lang="en">
  71. <head>
  72.     <meta charset="UTF-8">
  73.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  74.     <title>文件上传变量$_FILES</title>
  75. </head>
  76. <body>
  77.     <form action="" method="POST" enctype="multipart/form-data">
  78.     <fieldset>
  79.         <legend>单文件上传: 检查是否是通过POST上传?</legend>
  80.         <input type="hidden" name="MAX_FILE_SIZE" value="500000">
  81.         <input type="file" name="my_pic">
  82.         <button>上传</button>
  83.     </fieldset>
  84.     </form>
  85. </body>
  86. </html>
  87. ----------------------
  88. <?php
  89. // $_FILES
  90. printf('<pre>%s</pre>', print_r($_FILES, true));
  91. // 获取文件类型
  92. $fileType = $_FILES['my_pic']['type'];
  93. // echo $fileType, '<br>';
  95. // print_r(explode('/',$fileType)[0]);
  97. // echo strstr($fileType, '/', true);
  100. // $allow = ['jpg', 'png', 'gif'];
  101. // $extension = pathinfo($_FILES['my_pic']['name'])['extension'];
  102. // echo $extension;
  103. // if (!in_array($extension, $allow))  echo '<p>文件类型错误</p>';
  106. if (strstr($fileType, '/', true) !== 'image') echo '<p>文件类型错误</p>';
  108. ?>
  109. <!DOCTYPE html>
  110. <html lang="en">
  111. <head>
  112.     <meta charset="UTF-8">
  113.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  114.     <title>文件上传变量$_FILES</title>
  115. </head>
  116. <body>
  117.     <hr>
  118.     <form action="" method="POST" enctype="multipart/form-data">
  119.     <fieldset>
  120.         <legend>单文件上传: 检测文件类型</legend>
  121.         <input type="hidden" name="MAX_FILE_SIZE" value="500000">
  122.         <input type="file" name="my_pic">
  123.         <button>上传</button>
  124.     </fieldset>
  125.     </form>
  126. </body>
  127. </html>
  128. ------------
  129. <?php
  130. // $_FILES
  131. printf('<pre>%s</pre>', print_r($_FILES, true));
  132. // php.ini
  133. echo ini_get('upload_max_filesize'); 
  135. ini_set('upload_max_filesize', '10M');
  139. $errorCode = $_FILES['my_pic']['error'] ?? 'null';
  141. switch ($errorCode) {
  142.     case 1:
  143.         echo '文件超过`php.ini`中`upload_max_filesize`值';
  144.         break;
  145.     case 2:
  146.         echo '文件大小超过表单隐藏域中`MAX_FILE_SIZE`指定的值 ';
  147. }
  148. ?>
  149. <!DOCTYPE html>
  150. <html lang="en">
  151. <head>
  152.     <meta charset="UTF-8">
  153.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  156.     <title>文件上传变量$_FILES</title>
  157. </head>
  158. <body>
  159.     <hr>
  160.     <form action="" method="POST" enctype="multipart/form-data">
  161.     >
  162.     <fieldset>
  163.         <legend>单文件上传: 检测文件大小</legend>
  164.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
  165.         <input type="file" name="my_pic">
  166.         <button>上传</button>
  167.     </fieldset>
  168.     </form>
  169. </body>
  170. </html>

单文件上传示例：

文件上传正常：

文件上传异常：

  1. <?php
  2. // $_FILES
  3. printf('<pre>%s</pre>', print_r($_FILES, true));
  4. // 自定义上传异常类
  5. class UploadException extends Exception
  6. {
  7.     // 在异常子类中,可以访问并重写Exception中的四个属性,通过__toString()格式化异常输出信息
  8.     public function __toString()
  9.     {
  10.         return <<< UPLOAD
  11. <style>
  12. table {border-collapse: collapse;border:1px solid black;text-align: center;}
  13. td {border:1px solid black;padding: 5px;}
  14. tr:first-of-type {background-color:#eee;}
  15. tr:last-of-type td {color: coral;}
  16. </style>
  17. <table>
  18. <tr><td>代码</td><td>信息</td><td>文件</td><td>行号</td></tr>
  19. <tr><td>$this->code</td><td>$this->message</td><td>$this->file</td><td>$this->line</td></tr>
  20. </table>
  21. UPLOAD;
  22.     }
  23. }
  25. ///////////////////////////////////////////////////////////////////////
  26. try {
  27.     // 上传出错的代码
  28.     $errorCode = $_FILES['my_pic']['error'];
  29.     if ($errorCode > UPLOAD_ERR_OK) {
  30.         switch ($errorCode) {
  31.             case UPLOAD_ERR_INI_SIZE:
  32.                 throw new UploadException('上传的文件超过了 php.ini 中 upload_max_filesize 选项限制的值', 1);
  33.             break;
  34.             case UPLOAD_ERR_FORM_SIZE:
  35.                 throw new UploadException('上传文件的大小超过了 HTML 表单中 MAX_FILE_SIZE 选项指定的值', 2);
  36.                 break;
  37.             case UPLOAD_ERR_PARTIAL:
  38.                 throw new UploadException('文件只有部分被上传', 3);
  39.                 break;
  40.             case UPLOAD_ERR_NO_FILE:
  41.                 throw new UploadException('没有文件被上传', 4);
  42.                 break;
  43.             case UPLOAD_ERR_NO_TMP_DIR:
  44.                 throw new UploadException('找不到临时文件夹', 6);
  45.                 break;
  46.             case UPLOAD_ERR_CANT_WRITE:
  47.                 throw new UploadException('文件写入失败', 7);
  48.                 break;
  49.             default:
  50.                 // 测试时建议关掉default: 避免误报影响
  51.                 throw new UploadException('未知类型错误', 8);
  52.         }
  53.     }
  55.     // 判断文件类型
  56.     $fileType = $_FILES['my_pic']['type'];
  57.     if (strstr($fileType, '/', true) !== 'image') throw new UploadException('文件类型错误',9);
  59.     // 将文件从临时目录 移动到用户自定义的目标目录中
  60.  // 临时文件名
  61.     $tempFileName = $_FILES['my_pic']['tmp_name'];
  62.     if (is_uploaded_file($tempFileName)) {
  65.         // 原始文件名
  66.         $originalFileName = $_FILES['my_pic']['name'];
  67.         // 目录文件名
  68.        $destFileName =  'uploads/'.md5(time().mt_rand(1,1000)).strstr($originalFileName, '.');
  69.        // 移动文件到目标目录使用的函数
  70.         if (move_uploaded_file($tempFileName, $destFileName)) {
  72.             echo "<p>$originalFileName: 上传成功~~</p>";
  73.             // 预览
  74.             echo "<img src='{$destFileName}' width='200'>";
  75.         }
  76.     }
  77. } catch (UploadException $e) {
  78.     echo $e;
  79. }
  81. ?>
  82. <!DOCTYPE html>
  83. <html lang="en">
  84. <head>
  85.     <meta charset="UTF-8">
  86.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  87.     <title>文件上传变量$_FILES</title>
  88. </head>
  89. <body>
  90.     <hr>
  91.     <form action="" method="POST" enctype="multipart/form-data">
  92.     <fieldset>
  93.         <legend>单文件上传: 异常处理</legend>
  94.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
  95.         <input type="file" name="my_pic">
  96.         <button>上传</button>
  97.     </fieldset>
  98.     </form>
  99. </body>
  100. </html>

多文件上传示例一：

  1. <?php
  2. // $_FILES
  3. printf('<pre>%s</pre>', print_r($_FILES, true));
  4. // 将异常处理先省略,只演示关键代码
  5. foreach ($_FILES as $file) {
  6.     // 只要判断 error === 0 
  7.     if ($file['error'] === 0) {
  8.         $destFile = 'uploads/' . $file['name'];
  9.         move_uploaded_file($file['tmp_name'], $destFile);
  10.         echo "<img src='{$destFile}' width='200'>";
  11.     }
  12. }
  14. ?>
  15. <!DOCTYPE html>
  16. <html lang="en">
  17. <head>
  18.     <meta charset="UTF-8">
  19.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  20.     <title>文件上传变量$_FILES</title>
  21. </head>
  22. <body>
  23.     <hr>
  24.     <form action="" method="POST" enctype="multipart/form-data">
  25.     <fieldset>
  26.         <legend>多文件上传: 逐个上传(一)</legend>
  27.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
  28.         <input type="file" name="my_pic1">
  29.         <input type="file" name="my_pic2">
  30.         <input type="file" name="my_pic3">
  31.         <button>上传</button>
  32.     </fieldset>
  33.     </form>
  34. </body>
  35. </html>

多文件上传示例二：

  1. <?php
  2. // $_FILES
  3. printf('<pre>%s</pre>', print_r($_FILES, true));
  4. // 将异常处理先省略,只演示关键代码
  5. if ($_FILES['my_pic'])
  6. foreach ($_FILES['my_pic']['error'] as $key => $error) {
  7.     // 只要判断 error === 0 
  8.     if ($error === UPLOAD_ERR_OK) {
  9.       // 临时文件名
  10.       $tmpFileName = $_FILES['my_pic']['tmp_name'][$key];
  11.       // 原始文件名
  12.       $originalFileName = $_FILES['my_pic']['name'][$key];
  13.        // 目标文件名
  14.        $destFileName = 'uploads/'. $originalFileName;
  16.        // 移动文件
  17.        move_uploaded_file($tmpFileName, $destFileName);
  18.        // 预览
  19.        echo "<img src='{$destFileName}' width='200'>";
  20.     }
  21. }
  23. ?>
  24. <!DOCTYPE html>
  25. <html lang="en">
  26. <head>
  27.     <meta charset="UTF-8">
  28.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  29.     <title>文件上传变量$_FILES</title>
  30. </head>
  31. <body>
  32.     <hr>
  33.     <form action="" method="POST" enctype="multipart/form-data">
  34.     <fieldset>
  35.         <legend>多文件上传: 逐个上传(二)</legend>
  36.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
  37.         <!-- 将name属性值能数组的形式提供 -->
  38.         <input type="file" name="my_pic[]">
  39.         <input type="file" name="my_pic[]">
  40.         <input type="file" name="my_pic[]">
  41.         <button>上传</button>
  42.     </fieldset>
  43.     </form>
  44. </body>
  45. </html>

批量文件上传示例：

  1. <?php
  2. // $_FILES
  3. printf('<pre>%s</pre>', print_r($_FILES, true));
  4. // 将异常处理先省略,只演示关键代码
  5. if ($_FILES['my_pic'])
  6. foreach ($_FILES['my_pic']['error'] as $key => $error) {
  7.     // 只要判断 error === 0 
  8.     if ($error === UPLOAD_ERR_OK) {
  9.       // 临时文件名
  10.       $tmpFileName = $_FILES['my_pic']['tmp_name'][$key];
  11.       // 原始文件名
  12.       $originalFileName = $_FILES['my_pic']['name'][$key];
  13.        // 目标文件名
  14.        $destFileName = 'uploads/'. $originalFileName;
  16.        // 移动文件
  17.        move_uploaded_file($tmpFileName, $destFileName);
  18.        // 预览
  19.        echo "<img src='{$destFileName}' width='200'>";
  20.     }
  21. }
  23. ?>
  24. <!DOCTYPE html>
  25. <html lang="en">
  26. <head>
  27.     <meta charset="UTF-8">
  28.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  29.     <title>文件上传变量$_FILES</title>
  30. </head>
  31. <body>
  32.     <hr>
  33.     <form action="" method="POST" enctype="multipart/form-data">
  34.     <fieldset>
  35.         <legend>多文件上传: 批量上传</legend>
  36.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000">
  37.         <!-- 将name属性值能数组的形式提供 -->
  38.         <input type="file" name="my_pic[]" multiple>
  39.         <button>上传</button>
  40.     </fieldset>
  41.     </form>
  42. </body>
  43. </html>

课程学习小结

本次课程老师讲解非常细致，在老师的直播讲解之后，又通过回看视频进行理解消化，在案例实操方面，老师由浅入深，从基本必备知识开始演示，通过单个文件上传、多个文件上传（列举了两种不同的实现方式）到批量文件上传，涵盖了几乎所有日常可能使用到的情况，并且融入了文件类型检查,异常处理等实现方式，使得代码更加健壮，通过对各个示例代码的认真理解及部分修改实践，加深对本次课程内容的理解。在实际应用系统中，文件上传是非常重要的功能，必须熟练掌握。

批改老师：天蓬老师天蓬老师

批改状态：合格

老师批语：因为太重要了, 所以讲解的非常细致.... 因为不少项目就靠上传就可以完成许多功能, 例如开发一个在线网盘项目, 基本上就靠这个了
本博文版权归博主所有，转载请注明地址！如有侵权、违法，请联系admin@php.cn举报处理！
全部评论 文明上网理性发言，请遵守新闻评论服务协议
0条评论
作者最新博文
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网：公益在线php培训，帮助PHP学习者快速成长！
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号

  • PHP学习

  • 技术支持

  • 返回顶部
    • 登录PHP中文网，和优秀的人一起学习！
    全站2000+教程免费学
    微信扫码登录