根本原因是apache或php-fpm进程用户无upload_tmp_dir目录写权限；windows需用icacls授予nt authority\system完全控制权，linux需chown匹配apache运行用户且chmod 700，重启服务后通过$_files'file'验证路径。

为什么 upload_tmp_dir 配置后 PHP 仍报“Failed to move uploaded file”

根本原因不是路径没写对，而是 Apache（Windows 下以 SYSTEM 或 LocalSystem 身份运行）或 PHP-FPM（Linux 下常以 daemon 或 www-data 运行）**没有该目录的写权限**。XAMPP 默认把 upload_tmp_dir 指向 C:\xampp\tmp，但 Windows 权限模型下，即使目录存在，Apache 服务账户也可能被拒绝写入。

• 典型错误信息：move_uploaded_file(): Unable to move ... No such file or directory 或更隐蔽的 Warning: Failed to write session data（因 session.save_path 也依赖同级权限）
• 不要只改 php.ini 里的 upload_tmp_dir 值就以为完事——必须同步校验目标目录的 ACL
• Windows 上用资源管理器右键 → “属性” → “安全” 标签页查看实际生效权限，而非仅看“所有者”

Windows 下如何给 upload_tmp_dir 目录正确赋权（XAMPP 专用）

XAMPP for Windows 的 Apache 服务默认以 LocalSystem 账户运行（非当前登录用户），因此权限必须显式授予该主体。手动创建目录后，需用 icacls 命令精确授权，图形界面操作容易漏掉继承控制。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 先在 php.ini 中设置： upload_tmp_dir = "C:\xampp\tmp"（路径必须用双引号包裹，且反斜杠不需转义）
• 确保目录存在：mkdir C:\xampp\tmp
• 以管理员身份打开命令提示符，执行： icacls "C:\xampp\tmp" /grant "NT AUTHORITY\SYSTEM:(OI)(CI)F" /T 其中 (OI)=对象继承、(CI)=容器继承、F=完全控制；/T 表示递归应用
• 重启 Apache 服务（不能只重载配置）：用 XAMPP Control Panel 点击 Stop 再 Start

Linux/macOS 下 XAMPP-like 环境的等效处理

Linux 版 XAMPP 已停止维护，但若你用的是类 XAMPP 的 LAMP 包（如某些旧版 Bitnami 封装），Apache 进程通常以 daemon 用户运行。此时权限问题表现为“Permission denied”而非“no such file”，因为目录存在但无写权。

• 确认 Apache 用户：ps aux | grep apache 或 ps aux | grep httpd，看 USER 列（常见为 daemon、www-data 或 apache）
• 修改 php.ini：upload_tmp_dir = "/opt/lampp/temp"（建议用绝对路径，避免相对路径歧义）
• 赋权命令：sudo chown daemon:daemon /opt/lampp/temp && sudo chmod 700 /opt/lampp/temp 注意：不要用 777，PHP 官方明确要求 upload_tmp_dir 目录不能被组/其他用户写入，否则拒绝上传
• 验证是否生效：php -i | grep upload_tmp_dir，再检查输出路径是否与 ls -ld /opt/lampp/temp 显示的 owner/group 一致

upload_tmp_dir 和 sys_get_temp_dir() 返回值不一致怎么办

这是常见干扰项。PHP 函数 sys_get_temp_dir() 返回的是系统级临时目录（如 Windows 的 C:\Windows\Temp），它**不读取 upload_tmp_dir 配置**。上传文件时 PHP 强制使用 upload_tmp_dir，而其他函数（如 tempnam()）才走 sys_get_temp_dir()。二者本就不该一致。

• 调试时别用 echo sys_get_temp_dir(); 验证上传配置——它永远不反映 upload_tmp_dir 设置
• 真正验证方式是：写个上传脚本，用 var_dump($_FILES['file']['tmp_name']); 输出实际临时路径，再对比是否落在你设的 upload_tmp_dir 内
• 如果 $_FILES['file']['tmp_name'] 是空字符串或 null，说明上传根本没进 PHP 层，可能是 Apache 的 LimitRequestBody 或前端 enctype 错误，和权限无关

权限配置最易忽略的点在于：Windows 下必须授给 NT AUTHORITY\SYSTEM，而不是当前用户或 Administrators 组；Linux 下必须确保 owner 和 Apache 进程 UID 完全匹配，且目录不可被 group/o 写入。改完配置不重启服务、或用错用户主体，都会让整个配置失效。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！