微信公众号 讲师中心
首页
文章
后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 自媒体 新闻
专题
后端开发 web前端 数据库 开发工具 php框架 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程 新闻
AI工具
AI 聊天问答 Agent智能体 AI 文本写作 AI 绘画作图 AI 设计工具 AI 视频创作 AI 音频制作 AI 办公学习 AI 编程开发 Prompt指令
学习
大前端 后端开发 数据库 移动端 运维开发 计算机基础
编程手册
大前端 后端开发 数据库 移动端 运维开发 计算机基础
下载
js特效 网站源码 工具下载 类库下载 网站素材 学习资源 插件扩展 手机/移动开发 手机游戏
搜索
后端开发 web前端 数据库 开发工具 php框架 常见问题 科技 Java 系统教程 电脑教程 硬件教程 手机教程 软件教程 游戏教程
自媒体 新闻
首页 > 博客列表 > PHP 文件上传
博主信息
博文 32
粉丝 0
评论 0
访问量 35339
专题推荐
更多>
相关推荐
热门教程
更多>
相关教程
热门推荐
最新课程
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
PHP 文件上传
Yang_Sir
原创
1063人浏览过
  • 上传的文件保存在临时文件夹中，如没有另外保存，脚本结束后就没了
  • 大文件上传，如50M以上的，除了php.ini还需要配置apache中httpd.conf文件里FcgidMaxRequestLen 的值，不然会出现Internal Server Error

基本概念

1.客户端上传

  • html中用户可以通过form表单上传文件，
  • form表单中input标签的type属性设置为file时，即规定输入内容作为文件处理。
  • 表单的上传方式必须是POST
  • enctype属性规定上传的内容类型，文件使用multipart/form-data类型
  • 文件上传的方式有单文件上传和多文件上传，
  • 多文件上传又分为三种类型：
  • 1.逐一上传，表单中每个input的name属性值不同
  • 2.批量上传，限定文件个数,每个input的name属性值相同为数组类型，每次可选 一个文件
  • 3.批量上传，不限定个数，input的name属性值为数组类型，并添加multiple属 性，可以同时选多个文件

2.服务器处理

  • PHP中以全局变量$_FILES记录上传的文件信息，
  • $_FILES二维键名为客户端form表单中的name属性值，其值是五个固定的文件信息
序号 键名 描述
1 name 文件在客户端的原始文件名(即存在用户电脑上的文件名)
2 type 文件的 MIME 类型, 由浏览器提供, PHP 并不检查它
3 tmp_name 文件被上传到服务器上之后,在临时目录中临时文件名
4 error 和该文件上传相关的错误代码
5 size 已上传文件的大小(单位为字节)

error错误信息描述:

序号 常量 值 描述
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 文件写入失败
  • 服务器接收文件后保存在临时文件中，通过move_uploaded_file()方法保存到指定位置

示例演示

1.创建上传页面

  • 创建4种不同上传方式的form表单
  1. <!DOCTYPE html>
  2. <html lang="en">
  3.   <head>
  4.     <meta charset="UTF-8" />
  5.     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  6.     <title>文件上传</title>
  7.   </head>
  8.   <style>
  9.     fieldset {
  10.       height: 100px;
  11.       padding: 20px 20px;
  12.     }
  13.   </style>
  15.   <body>
  16.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  17.       <fieldset>
  18.         <legend>单文件上传</legend>
  19.         <input type="hidden" name="MAX_FILE_SIZE" value="500000" />
  20.         <input type="file" name="my_pic" />
  21.         <button>上传</button>
  22.       </fieldset>
  23.     </form>
  24.     <br />
  25.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  26.       <fieldset>
  27.         <legend>多文件上传: 逐个上传</legend>
  28.         <input type="hidden" name="MAX_FILE_SIZE" value="300" />
  29.         <input type="file" name="my_pic1" />
  30.         <input type="file" name="my_pic2" />
  31.         <input type="file" name="my_pic3" />
  32.         <button>上传</button>
  33.       </fieldset>
  34.     </form>
  35.     <br />
  36.     <form action="upload2.php" method="POST" enctype="multipart/form-data">
  37.       <fieldset>
  38.         <legend>多文件上传: 批量上传（限文件数）</legend>
  39.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000" />
  40.         <!-- 将name属性值能数组的形式提供 -->
  41.         <input type="file" name="my_pic[]" />
  42.         <input type="file" name="my_pic[]" />
  43.         <input type="file" name="my_pic[]" />
  44.         <button>上传</button>
  45.       </fieldset>
  46.     </form>
  47.     <br />
  48.     <form action="upload.php" method="POST" enctype="multipart/form-data">
  49.       <fieldset>
  50.         <legend>多文件上传: 批量上传（不限数）</legend>
  51.         <input type="hidden" name="MAX_FILE_SIZE" value="3000000" />
  52.         <!-- 将name属性值能数组的形式提供 -->
  53.         <input type="file" name="my_pic[]" multiple />
  54.         <button>上传</button>
  55.       </fieldset>
  56.     </form>
  57.   </body>
  58. </html>

效果图:

" class="reference-link">

" class="reference-link">

2.创建PHP上传文件处理类

  • 通过构造函数把多文件上传的文件信息保存到二维数组中
  • self::$files保存上传成功的文件信息，self::$files_err保存上传失败的文件信息
  • 然后可以通过saveFile()方法保存上传成功的文件到指定位置
  1. <?php
  2. class Upload
  3. {
  4.     public static $path='uploads/';//设置文件保存位置
  5.     public static $rename=0;//设置是否重命名,0 否，其它值 是
  6.     public static $files = array();//保存成功上传的文件
  7.     public static $files_err = array();//保存上传失败的文件信息
  8.     public static $result = array("success"=>[],"error"=>[]);//记录保存结果
  9.     public static $error_code = '';//错误码
  10.     public static $specify_type=array();//指定上传文件的格式
  11.     const ERR_MESSAGE = ['没有错误发生,文件上传成功','文件超过`php.ini`中`upload_max_filesize`值','文件大小超过表单中`MAX_FILE_SIZE`指定的值',
  12.     '文件只有部分被上传','没有文件被上传','', '找不到临时文件夹','文件写入失败','文件格式错误'];
  14.     /**
  15.      * 获取所有上传的文件信息，转为二维数组
  16.      * $files，$files_err，分开保存上传成功和失败的文件
  17.      */
  18.     public function __construct()
  19.     {
  20.         foreach($_FILES as $key=>$val){
  21.             //name如果是数组，循环获取数据,转为二维数组
  22.             if(is_array($val['name'])){
  23.                 $count = count($val['name']);
  24.                 for($i=0;$i<$count;$i++){
  25.                     //判断是否以POST方式上传了文件
  26.                     if($val['error'][$i]===0&&is_uploaded_file($val['tmp_name'][$i])){
  27.                         self::$files[]=array(
  28.                             'name'=>$val['name'][$i],
  29.                             'type'=>$val['type'][$i],
  30.                             'tmp_name'=>$val['tmp_name'][$i],
  31.                             'error'=>$val['error'][$i],
  32.                             'size'=>$val['size'][$i]   
  33.                         );
  34.                     }else{
  35.                         self::$files_err[]=array(
  36.                             'name'=>$val['name'][$i],
  37.                             'type'=>$val['type'][$i],
  38.                             'tmp_name'=>$val['tmp_name'][$i],
  39.                             'error'=>$val['error'][$i],
  40.                             'size'=>$val['size'][$i]   
  41.                         );
  42.                     }
  43.                 }
  44.             }else{
  45.                 //如果不是数组，直接获取数据
  46.                 if($val['error']===0&&is_uploaded_file($val['tmp_name']))
  47.                 {
  48.                     self::$files[]=$val;
  49.                 }else{
  50.                     self::$files_err[]=$val;
  51.                 }
  53.             }
  54.         }
  55.     }
  57.     /**
  58.      * 保存上传成功的文件，用户选择路径、是否重命名、限定文件类型
  59.      * $rename 重命名：0 否 ； 其它 是
  60.      */
  61.     public function saveFile(string $path='uploads/',int $rename=0,array $specify_type=[]):array 
  62.     {
  63.         self::$path=$path;
  64.         self::$rename=$rename;
  65.         self::$specify_type=$specify_type;
  66.         foreach(self::$files as $val){
  67.             $filename = $this->rename($val['name'],$rename);//重命名
  68.             if(!empty($specify_type)){
  69.                 //如果不属于指定的类型，保存错误信息，跳出本次循环
  70.                 if(!in_array($val['type'],$specify_type)){
  71.                     self::$result['error'][] =  $val['name'].":文件类型不符";
  72.                     continue;
  73.                 }
  74.             }
  75.             if(move_uploaded_file($val['tmp_name'], self::$path.$filename)){
  76.                 self::$result['success'][] = $val['name'].':'.self::$path.$filename;
  77.             }else{
  78.                 self::$result['error'][] = $val['name'].":保存失败";
  79.             }
  80.         }
  81.         return self::$result;
  82.     }
  84.     /**
  85.      * 按规则生成文件名
  86.      * $type : 0 否，其它 是
  87.      */
  88.     public function rename(string $filename,int $type=0):string{
  89.         $suffix = strrchr($filename,'.');//后缀
  90.         $finalname = $filename;
  92.         //如果文件名存在，又不重新命名,就在原文件名后加(1)
  93.         if(file_exists(self::$path.$filename)&&$type===0){
  94.             $finalname = basename($filename,strrchr($filename,'.')).'(1)'.$suffix;
  95.         }elseif($type!==0){
  96.             $finalname = date('Ymd',time()).rand(1000,9999).$suffix;
  97.         }
  99.         if(file_exists(self::$path.$finalname)){//再次检测名称是否已存在（重新生成）
  100.             $finalname = $this->rename($filename,$type);
  101.         }
  102.         return $finalname;
  103.     }
  104. }
  106. $upload = new Upload;
  107. print_r($upload::$files);//上传成功的文件
  108. print_r($upload::$files_err);//上传失败的文件
  109. print_r($upload->saveFile('uploads',1,['text/plain','image/jpeg']));

3.演示截图

上传文件：

打印结果：

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

批改状态：合格

老师批语：这应该是有史以来最完整的文件上传方案
本博文版权归博主所有，转载请注明地址！如有侵权、违法，请联系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+教程免费学
    微信扫码登录