上传功能几乎每个项目都有,也几乎每个项目都踩过坑。失败时不要只看前端提示,服务端的错误信息才是关键。
先看错误码
$_FILES['file']['error'] 的值直接告诉你原因:
| 值 | 常量 | 含义 |
|---|---|---|
| 0 | UPLOAD_ERR_OK | 成功 |
| 1 | UPLOAD_ERR_INI_SIZE | 超过 upload_max_filesize |
| 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 | 写入磁盘失败 |
三个必须同时调大的配置
; 上传文件本身的大小上限
upload_max_filesize = 20M
; 整个 POST 请求的上限,必须大于 upload_max_filesize
post_max_size = 24M
; 脚本最长执行时间,大文件上传需要放宽
max_execution_time = 120
max_input_time = 120
; 临时目录
upload_tmp_dir = /tmp
很多人只改了 upload_max_filesize,结果大文件仍然失败,因为 post_max_size 没跟上。改完记得重启 PHP-FPM。
Nginx 也要放行
# nginx.conf 或站点配置
client_max_body_size 24m;
目录权限
PHP-FPM 运行用户(通常是 www)必须对目标目录有写权限:
mkdir -p /www/wwwroot/site/uploads
chown -R www:www /www/wwwroot/site/uploads
chmod 755 /www/wwwroot/site/uploads
安全底线
上传是最容易被打穿的功能之一,务必做到:
- 不信任扩展名:用
finfo_file检测真实 MIME,白名单校验; - 不信任文件名:重命名为随机串 + 白名单扩展名,绝不使用原始文件名;
- 上传目录禁止执行 PHP:在 Nginx 里对该目录加
location ~ .php$ { return 403; }; - 限制大小与类型:图片站就只允许图片,不要为了”方便”放开压缩包。
<?php
$allowed = ['image/jpeg' => 'jpg', 'image/png' => 'png', 'image/webp' => 'webp'];
$finfo = new finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($_FILES['file']['tmp_name']);
if (!isset($allowed[$mime])) {
exit('不支持的文件类型');
}
if ($_FILES['file']['size'] > 5 * 1024 * 1024) {
exit('文件过大');
}
$name = bin2hex(random_bytes(16)) . '.' . $allowed[$mime];
move_uploaded_file($_FILES['file']['tmp_name'], '/www/wwwroot/site/uploads/' . $name);
这一小段代码挡住了绝大多数上传类漏洞。别省这几行。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。