现象
PHP 8.3 用 Nginx 跑上传接口,小图也失败,前端拿到错误码 6,$_FILES['file']['error'] 同样是 6,对应 UPLOAD_ERR_NO_TMP_DIR。服务器 /tmp 存在,磁盘也充足,换浏览器和网络都一样,只有上传必现。
原因
错误码 6 表示 PHP 找不到可写的临时目录。常见原因是 upload_tmp_dir 指向不存在的路径,或目录属主不是 PHP-FPM 的运行用户;systemd 开启 PrivateTmp 后,FPM 看到的是独立挂载的 /tmp,在 shell 里验证通过不代表子进程能写。open_basedir 也会让目录被判定不可用。
解决步骤
第一步,确认 FPM 实际读到的值。不要只看 php.ini,用命令查 upload_tmp_dir、open_basedir 和 upload_max_filesize,再检查目录属主。
php -i | grep -E 'upload_tmp_dir|upload_max_filesize|open_basedir'
ls -ld /var/tmp/php
第二步,建专用目录并改配置。新建专用目录,属主改成 FPM 用户,权限用 1733。把 upload_tmp_dir 写进 FPM 的 php.ini 后重载服务。
mkdir -p /var/tmp/php
chown www-data:www-data /var/tmp/php
chmod 1733 /var/tmp/php
echo 'upload_tmp_dir=/var/tmp/php' >> /etc/php/8.3/fpm/php.ini
systemctl reload php8.3-fpm
第三步,排除隔离和路径限制。目录仍不可写时,检查 open_basedir 是否包含该路径,以及 systemd 的 PrivateTmp;需要共享时改为 false,或用 ReadWritePaths 放行,然后重启。
验证
上传一个 2MB 文件,$_FILES 里的 error 为 0,is_uploaded_file 返回 true,move_uploaded_file 成功落盘,error_log 不再告警。
小结
错误码 6 按目录可用性排查,重点看 FPM 子进程视角的路径、属主和 open_basedir,不要因为 shell 里能看到目录就认为没问题。
