PHP 文件上传 · 从入门到深度防御
本站全面解析 PHP 文件上传 机制、安全策略、常见错误、多文件及大文件方案,以及网民最关心的 文件上传 周边热点。以下内容超过3000字,涵盖实战与原理。
〔一〕上传基础与核心机制
在 PHP 中,文件上传 主要依靠 `$_FILES` 超全局数组以及 `move_uploaded_file()` 函数。网民常搜索「PHP 上传文件为什么失败」「临时目录权限」等问题。实际上,文件上传 涉及 `php.ini` 中的 `upload_max_filesize`、`post_max_size`、`max_file_uploads` 等指令。例如:
| 指令 | 默认值 | 说明 |
|---|---|---|
| upload_max_filesize | 2M | 单个上传文件大小限制 |
| post_max_size | 8M | POST 数据总量限制 |
| max_file_uploads | 20 | 单次最多上传文件数 |
很多开发者忽略了 `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」等。
| 错误码 | 常量 | 含义 |
|---|---|---|
| 0 | UPLOAD_ERR_OK | 成功 |
| 1 | UPLOAD_ERR_INI_SIZE | 超过 php.ini 限制 |
| 2 | UPLOAD_ERR_FORM_SIZE | 超过 MAX_FILE_SIZE 表单值 |
| 3 | UPLOAD_ERR_PARTIAL | 仅部分上传 |
| 4 | UPLOAD_ERR_NO_FILE | 没有文件被上传 |
| 6 | UPLOAD_ERR_NO_TMP_DIR | 缺少临时目录 |
| 7 | UPLOAD_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 如何实现断点续传」。常用方案:分片上传 + 服务器合并。
此外,大文件上传 需调整 `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 文件上传 安全、性能、最佳实践 · 持续更新