李涛自留地
回到顶部
首页 > php学习 > php文件上传怎么用电脑上传?从表单字段到临时目录的顺序

php文件上传怎么用电脑上传?从表单字段到临时目录的顺序

文章目录

内网那台上传服务的合同到期,机房腾不出第二台机器,附件只能挪到对象存储前面那块挂载盘,挂载点是 /data/attach。旧脚本还能跑,毛病是文件直接落在站点根目录,传个 .php 上去就能执行。同事催了两回,我才坐下来把php文件上传怎么用电脑上传按顺序走了一遍,从表单字段到落盘。

浏览器交出去的不是文件本身

form 默认的 enctype 是 application/x-www-form-urlencoded,这种编码只搬字符串,选中的文件在请求体里只剩一个文件名。PHP 收下之后 $_FILES 是空数组,$_POST['file'] 里躺着一串 "a.png"。所以第一步不是写 PHP,是给 form 补上 enctype="multipart/form-data",method 必须是 post。

四个方框从左到右排出请求到落盘的顺序

这一步漏了,后端永远只拿到名字,改多少行业务代码都不会出现 tmp_name。

真正的顺序是四段:浏览器按 multipart 编码请求体,PHP 把请求体里的文件段写成一个临时文件,$_FILES 填好 name、type、size、tmp_name、error 五个键,业务代码再决定把它挪去哪里。把四段对着报错看,卡在哪一段基本能定位,跳过一段去查后面的日志只会绕远。已经在浏览器里撞见 413 的,直接跳到最后一节。

第二步才是读 $_FILES,五个键里只有 error 值得先判断,它先给出这一段的判定,其余四个都是给后面用的参数。

tmp_name 指向哪个文件

Linux 上它长这样:/tmp/phpA3F2.tmp,文件名是 php 加六位随机字符,跟原文件名没有关系。本机用 Windows 调试、upload_tmp_dir 又留空的时候,路径会变成 C:\Windows\Temp\php8F3A.tmp 这种形式。

这个临时文件活不到请求结束。脚本执行完 PHP 自己删,所以不能把 tmp_name 存进数据库留给队列慢慢处理,那时路径已经失效,后面所有报错都指向一个不存在的文件。

下面这段只做一件事:在动文件之前把错误码挡掉,再把临时路径一并打出来核对。

$f = $_FILES['file'] ?? null;
if (!$f || $f['error'] !== UPLOAD_ERR_OK) {
    exit('err=' . ($f['error'] ?? 'no-file'));
}
echo $f['tmp_name'], ' ', $f['size'];

正常上传会打印 /tmp/phpA3F2.tmp 20480 这样一行,前半段就是临时目录,后半段每次都不一样。打印出 err=4 说明浏览器没带文件段,回头查 enctype 和 input 的 name 就行。

临时目录由谁决定

php文件上传怎么用电脑上传走到这一步,文件其实已经在磁盘上了,只是没人告诉你落在哪个分区。upload_tmp_dir 留空不等于没有目录,文件仍然要往磁盘写一次,位置交给系统决定:Linux 通常是 /tmp,Windows 是系统临时目录,PHP 里用 sys_get_temp_dir() 能问出来。

自上而下四个节点,第三个节点分出失败支路

配置里写了一个不存在的路径,现象不是返回 false,而是直接来一行 warning:PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0,错误码 6,对应 UPLOAD_ERR_NO_TMP_DIR。目录在、但 php-fpm 的运行用户写不进去,落的是 7,UPLOAD_ERR_CANT_WRITE。两个码都不该去翻业务代码,先看目录在不在、属主对不对。

/tmp 在很多发行版里挂成 tmpfs,写进去的文件其实占内存。一个大包传上来,磁盘没涨内存先涨,同机还跑着别的服务时这不是小事。我把 upload_tmp_dir 指到 /data/tmp,跟系统临时目录分开,清理脚本按目录删就行,不用碰 /tmp 里别人留下的东西。

查配置我用的命令就一句:

php -i | grep -E 'upload_max_filesize|post_max_size|upload_tmp_dir'

输出是三行,upload_max_filesize => 2M => 2M、post_max_size => 8M => 8M、upload_tmp_dir => no value => no value,no value 就是留空。2M 传图片够用,传别的很快撞墙,我改到 20M,post_max_size 跟着提到 24M。post 必须大于 upload,反过来文件在进临时目录之前就被整包丢掉。

move_uploaded_file 只认一个来源

php文件上传怎么用电脑上传真正容易出事的地方在这一步,不在表单。这个落盘函数有两个硬条件:来源必须是本次请求里 PHP 生成的临时文件,目标目录必须存在且可写。前者由 is_uploaded_file() 兜着,它拦的是把 /etc/passwd 这类路径塞进 tmp_name 的写法;后者没有兜底,只能自己保证。

目录不存在,返回 false 并给出 failed to open stream: No such file or directory;目录在但 php-fpm 用户没有写权限,给的是 Permission denied。两条都是 warning,不抛异常,只靠 try/catch 接不住。

php-fpm 一般跑在 www-data 下,目标目录属主是 root、权限 755 的时候写不进去,chown 给 www-data 或者改 775 都行,别直接开 777。

同名文件会被静默覆盖,这个函数不看目标是否已经存在。文件名我改成 uniqid 拼白名单后缀,扩展名只放行 png、jpg、pdf,其余拒掉。

/data/attach 还要单独关掉 PHP 解析,location 里直接 return 403,或者把 .php 全部拒掉。光靠扩展名白名单挡不住所有变形,目录本身不可执行才是最后一道。

整条链路上它是最后一个能返回 false 的调用,落地也就这一步,返回值不判等于没做。

谁先把请求挡回去

反过来看,从php文件上传怎么用电脑上传的请求入口数,最先拦住它的其实是 nginx。三处限制从外到内排:nginx 的 client_max_body_size、PHP 的 post_max_size、upload_max_filesize。nginx 默认 1m,超了直接回 413,请求根本没进 PHP,$_FILES 是空的,也没有错误码可看。

左右两栏对照两个拒绝点,左栏标题是 413

post_max_size 超了是另一回事。PHP 收到了请求,但整包被丢,$_POST 和 $_FILES 一起变成空数组,error 也没有值,日志里留一行 POST Content-Length of 12582912 bytes exceeds the limit of 8388608 bytes。同样两个空数组,一个有 413 页面一个没有,这就是区分点。

再看 $_SERVER['CONTENT_LENGTH']:有值而 $_POST 是空的,基本就锁在 post_max_size 上,不用往 nginx 那边找。

判断依据就一条:nginx ≥ post_max_size > upload_max_filesize。nginx -T 之后 grep 不到 client_max_body_size,说明吃的是默认 1m,得在 server 或 location 里显式写一行。

只改 upload_max_filesize 是最常见的改法,改完还是 413,因为外面两层没动。三处一起改,改完 php-fpm reload、nginx -s reload,少一个都不生效。

三行命令核一遍

改完按下面三行过一遍,都在服务器上跑:

php -i | grep -E 'upload_max_filesize|post_max_size'
nginx -T 2>/dev/null | grep -n client_max_body_size
sudo -u www-data test -w /data/attach && echo writable

第一行命令要出两行,数字是改完的值;第二行有输出,且不小于第一行里的 post_max_size;第三行打印 writable 才算目录可写。

三行都过,再从电脑传一个 10M 以上的文件,落地后的大小和本地一致,这条链路就算通了。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。