TP5 上传文件报错 move_uploaded_file 失败原因？

TP5 上传文件报错 move_uploaded_file 失败，最常见原因是上传目录权限不足或 php.ini 配置限制。适用场景为 Linux 服务器或本地开发环境，操作前需备份配置，风险边界在于修改权限可能带来安全隐患。

先说结论：move_uploaded_file 失败通常由目标路径不可写或临时文件路径配置错误导致，优先检查目录权限和 PHP 配置。

命令速用版

Linux 环境下可使用以下命令快速检查并修复权限问题：

chmod -R 755 runtime/upload

chown -R www:www runtime/upload

若涉及 php.ini 配置，修改后需重启 PHP 服务：

service php-fpm restart

move_uploaded_file 函数失败的核心原因是目标路径无效或当前用户无权写入。PHP 安全机制要求上传文件必须先存储在临时目录，再移动到目标目录，任一环节权限不足都会导致返回 false。

ThinkPHP 5 封装了上传逻辑，但底层仍依赖 PHP 原生函数。若服务器开启了 open_basedir 限制，或 upload_tmp_dir 指向了不存在的路径，移动操作会被系统拦截。

第一步：检查上传目录权限。确认 TP5 项目中配置的保存路径（默认为 runtime/upload 或 public/uploads）是否存在。在终端执行 ls -l 查看权限，确保 Web 服务器用户（如 www-data）有写入权。

第二步：检查 PHP 配置。查看 php.ini 中的 upload_max_filesize 和 post_max_size 值，确保大于实际上传文件体积。确认 upload_tmp_dir 路径存在且可写。

第三步：检查 ThinkPHP 配置。查看 application/config.php 或对应模块配置，确认 upload_replace 和 savepath 设置是否正确，避免路径拼接错误。

第四步：查看错误日志。若上述无误，查看 Web 服务器错误日志（如 /var/log/nginx/error.log）或 TP5 runtime/log 下的日志文件，获取具体错误信息。

使用相同文件重新提交上传表单，页面返回成功状态码且目标目录出现文件即表示生效。若仍失败，检查 PHP 错误日志中是否仍有 Permission denied 或 No such file or directory 报错。

Windows 与 Linux 路径分隔符不同，代码中硬编码斜杠可能导致路径识别失败。open_basedir 限制可能禁止写入非指定目录，需联系主机商调整。临时目录空间不足也会导致移动失败，需清理磁盘空间。

开启 PHP 错误显示或查看 error_log 文件。在代码中使用 error_get_last() 获取最近一次错误详情，通常能定位到具体权限或路径问题。

通常是 php.ini 中 post_max_size 小于文件大小导致 POST 数据被丢弃。需同时调大 upload_max_filesize 和 post_max_size，并重启 PHP 服务。

PHP Manual: move_uploaded_file - https://www.php.net/manual/zh/function.move-uploaded-file.php

ThinkPHP 5.1 完全开发手册：文件上传 - https://www.kancloud.cn/manual/thinkphp5_1/354155