上传功能几乎每个项目都有,也几乎每个项目都踩过坑。失败时不要只看前端提示,服务端的错误信息才是关键。

先看错误码

$_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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。