upload_tmp_dir 必须按实例隔离，因为它是进程级配置，多实例共享会导致并发写入、权限错乱、文件名碰撞及nfs静默失败等问题；应为每个php-fpm pool配置独立目录并正确赋权。
为什么 upload_tmp_dir 必须按实例隔离
php 的 upload_tmp_dir 是进程级配置，同一 php-fpm pool 或 apache virtualhost 下所有请求共享这个目录。多服务器共用 nfs 或同一磁盘路径时，move_uploaded_file() 可能因并发写入、权限错乱或临时文件名碰撞导致失败——典型现象是上传成功但 $_files['xxx']['tmp_name'] 对应文件消失，或报错 file upload error - unable to move uploaded file。
实操建议：
- 每个 PHP-FPM pool 配置独立的
upload_tmp_dir，路径需属主为对应 pool 的user和group（如/var/tmp/php-pool-a） - 避免使用系统级全局路径（如
/tmp），即使加了前缀也不保险——PHP 内部生成临时文件名不保证跨进程唯一性 - NFS 挂载点禁止设为
upload_tmp_dir，除非确认启用了noac且服务端支持 POSIX 锁；否则rename()在 NFS 上可能静默失败
PHP-FPM pool 级配置 upload_tmp_dir 的正确写法
不能只在 php.ini 里统一设，必须下沉到 pool 配置层，否则所有 pool 共享同一目录。常见错误是改了 php.ini 却忘了重启对应 pool，或误以为 ini_set('upload_tmp_dir', ...) 能生效——它在上传阶段早已失效。
实操建议：
- 在 pool 配置文件（如
/etc/php/8.2/fpm/pool.d/site-a.conf）中添加：php_admin_value[upload_tmp_dir] = /var/tmp/php-site-a
- 目录需提前创建并赋权：
mkdir -p /var/tmp/php-site-a && chown www-data:www-data /var/tmp/php-site-a && chmod 700 /var/tmp/php-site-a - 验证是否生效：在该 pool 下执行
echo ini_get('upload_tmp_dir');，输出必须与配置一致
大文件导入时临时目录的磁盘与 inode 风险
单个大文件上传会先完整写入 upload_tmp_dir，再由脚本调用 move_uploaded_file() 移走。若多个实例共用目录，不仅有命名冲突，更易触发磁盘满或 inode 耗尽——尤其当上传中断后残留临时文件未清理。
实操建议：
- 为每个实例分配独立挂载点（如
/var/tmp/php-site-a挂载为单独小分区），而非仅靠子目录隔离 - 设置定时清理：用
find /var/tmp/php-site-a -maxdepth 1 -name 'php*' -mmin +30 -delete，但注意别误删正在上传的文件（PHP 临时文件名以php开头） - 监控
df -i而非仅df -h，大量小上传（如分片）会快速耗尽 inode
Apache + mod_php 场景下如何隔离（不推荐但偶有遗留）
mod_php 无法 per-vhost 设置 upload_tmp_dir，因为模块加载早于虚拟主机解析。强行用 php_admin_value 在 VirtualHost 块里会报错或被忽略。
实操建议：
- 彻底迁移到 PHP-FPM —— 这是最干净的解法
- 若暂无法迁移，只能用
SetEnv PHP_VALUE "upload_tmp_dir=/var/tmp/php-vhost-a"，但要求 Apache ≥ 2.4.10 且mod_env+mod_php同时启用；且该值会被所有同进程请求继承，仍存在轻度泄漏风险 - 绝对不要用
.htaccess中的php_value，它对upload_tmp_dir无效（PHP 文档明确标注为PHP_INI_SYSTEM级）
真正麻烦的不是配路径，而是确认每个上传请求落地的物理位置是否真的互不干扰——哪怕路径不同，如果底层是同一块 SSD+同一 ext4 文件系统，极端并发下 still 可能撞上内核级 page cache 或 writeback 争抢。这点常被忽略。
