⚡ PHP 文件上传 · 攻略站
✉️ 网友交流 · 深度解析

PHP 文件上传 · 从入门到深度防御

本站全面解析 PHP 文件上传 机制、安全策略、常见错误、多文件及大文件方案,以及网民最关心的 文件上传 周边热点。以下内容超过3000字,涵盖实战与原理。

〔一〕上传基础与核心机制

在 PHP 中,文件上传 主要依靠 `$_FILES` 超全局数组以及 `move_uploaded_file()` 函数。网民常搜索「PHP 上传文件为什么失败」「临时目录权限」等问题。实际上,文件上传 涉及 `php.ini` 中的 `upload_max_filesize`、`post_max_size`、`max_file_uploads` 等指令。例如:

指令默认值说明
upload_max_filesize2M单个上传文件大小限制
post_max_size8MPOST 数据总量限制
max_file_uploads20单次最多上传文件数

很多开发者忽略了 `post_max_size` 必须 ≥ `upload_max_filesize`,否则大文件上传会静默失败。另外,文件上传 的临时目录 `sys_get_temp_dir()` 需要可写。我们用一个示例展示基础上传逻辑:

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $tmp = $_FILES['file']['tmp_name'];
    $dest = __DIR__ . '/uploads/' . basename($_FILES['file']['name']);
    if (move_uploaded_file($tmp, $dest)) {
        echo '【✓】文件上传成功: ' . htmlspecialchars($_FILES['file']['name']);
    } else {
        echo '【✗】文件上传失败,请检查权限';
    }
}

网友还关心「文件上传 后如何获取扩展名?」建议使用 `pathinfo()` 并转小写,再与白名单比对。

〔二〕安全 · 文件上传防御

超过 70% 的 文件上传 漏洞源于未校验文件类型。攻击者可能上传 PHP shell。以下为必须实施的策略:

① 类型检测

MIME + 扩展名

使用 `finfo` 获取真实 MIME,并限制扩展名如 `jpg,png,gif,pdf`。不要仅依赖 `$_FILES['type']`,它可被伪造。

② 内容消毒

重命名 & 移动

使用 `uniqid()` 生成随机文件名,并移除路径符号。永远不要信任用户输入的文件名。

③ 权限控制

目录不可执行

上传目录设置为 `755` 并禁止 PHP 执行(通过 `.htaccess` 或 `nginx` 配置)。

网友们还关心「如何检测图片是否包含恶意代码?」可用 `getimagesize()` 以及剥离 EXIF 数据。但最稳妥的方式是使用专门的上传库,如 `Upload` 或 `Symfony HttpFoundation`。

〔三〕常见上传错误与排查

PHP 文件上传 错误码是调试关键。网民常搜「UPLOAD_ERR_INI_SIZE」「UPLOAD_ERR_PARTIAL」等。

错误码常量含义
0UPLOAD_ERR_OK成功
1UPLOAD_ERR_INI_SIZE超过 php.ini 限制
2UPLOAD_ERR_FORM_SIZE超过 MAX_FILE_SIZE 表单值
3UPLOAD_ERR_PARTIAL仅部分上传
4UPLOAD_ERR_NO_FILE没有文件被上传
6UPLOAD_ERR_NO_TMP_DIR缺少临时目录
7UPLOAD_ERR_CANT_WRITE磁盘写入失败

例如错误码 `1` 时,需检查 `upload_max_filesize` 和 `post_max_size`。错误码 `3` 往往网络不稳定,建议客户端断点续传。

〔四〕多文件上传与批量处理

使用数组形式 `name="files[]"` 可实现多文件上传。PHP 端接收后遍历 `$_FILES['files']['tmp_name']`。网友常搜索「多文件上传如何保留数组结构」。

📁 批量上传示例

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

后端循环处理,注意 `max_file_uploads` 限制。

📊 进度条方案

使用 `APC` 或 `Uppy` 配合 `XHR` 实现实时进度。PHP 端可写 `session.upload_progress`。

另外,多文件上传 时建议压缩图片或生成缩略图,减少服务器压力。

〔五〕大文件与断点续传

针对超过 100MB 的文件,普通上传会超时。网民最关心「PHP 如何实现断点续传」。常用方案:分片上传 + 服务器合并。

① 分片客户端将文件切割为 2MB 的块,逐块上传。
② 暂存每个分片用临时文件名保存,记录分片索引。
③ 合并所有分片上传完毕,PHP 按顺序合并为完整文件。
④ 校验计算 MD5 确保完整性。

此外,大文件上传 需调整 `max_execution_time` 和 `memory_limit`,但更推荐异步队列处理。

〔六〕热点问答 · 网友们还关心

〖上传限制〗如何突破 2M 限制?

修改 `php.ini` 中的 `upload_max_filesize=50M`,`post_max_size=60M`,并重启服务。如果使用 `Nginx`,还需调整 `client_max_body_size`。网友常忽略 `memory_limit`,建议至少 128M。另外,表单中可添加隐藏字段 `MAX_FILE_SIZE`,但仅客户端限制。

示例:ini_set('upload_max_filesize','50M'); 但需注意权限,部分虚拟主机不允许。

〖文件类型〗如何严格限制上传类型?

不要只依赖扩展名。使用 `finfo_open(FILEINFO_MIME_TYPE)` 获取真实 MIME。白名单推荐:`['image/jpeg','image/png','application/pdf']`。同时检查文件头字节。例如 JPEG 以 `FF D8 FF` 开头。网友还关心「如何允许 SVG 但防止 XSS?」建议禁用 SVG 或使用净化库。

  • 〈图片〉`image/jpeg` `image/png` `image/gif`
  • 〈文档〉`application/pdf` `text/plain`
  • 〈压缩〉`application/zip` 但需谨慎

〖安全加固〗上传目录如何防执行?

在 `uploads` 目录下放置 `.htaccess`:`php_flag engine off` 或 `RemoveHandler .php`。Nginx 中配置 `location ~* \.php$ { deny all; }`。另外,文件上传 后重命名为无扩展名或随机字符串,但更推荐放在 web 根目录外并通过下载脚本读取。

网友热议「使用 `is_uploaded_file()` 检查是否通过 HTTP POST 上传」,这是基本安全习惯。

【深度专题】PHP 文件上传 安全、性能、最佳实践 · 持续更新