文件上传失败因upload_tmp_dir未配置或无权限，需通过phpinfo()确认当前值，再修改php.ini或.user.ini指定绝对路径并设写权限，最后验证目录可写且上传成功。

如果您在本地 PHP 环境中遇到文件上传失败、提示“无法移动上传文件”或错误日志显示“failed to open stream: No such file or directory in Unknown on line 0”，很可能是 upload_tmp_dir 参数未正确配置或指定路径不存在、无写入权限。以下是修改该参数的具体操作步骤：

一、确认当前 upload_tmp_dir 设置值

该步骤用于获取当前生效的 upload_tmp_dir 路径，避免盲目修改。PHP 配置可能来自多个位置（php.ini 主配置、.user.ini、.htaccess 或运行时 set_ini），需以 phpinfo() 输出为准。

1、新建一个名为 info.php 的文件，内容为 ；

2、将该文件放入 Web 服务器根目录（如 XAMPP 的 htdocs、WAMP 的 www）；

3、通过浏览器访问 http://localhost/info.php；

4、在页面中搜索 upload_tmp_dir，查看其当前值及“Local Value”和“Master Value”是否一致；

5、记录下“Local Value”所显示的实际路径（若为空，则表示使用系统默认临时目录）。

二、修改 php.ini 文件中的 upload_tmp_dir

此方法适用于所有基于 php.ini 的本地环境（XAMPP、WAMP、MAMP、手动编译安装等），修改后需重启 Web 服务生效，是最稳定、推荐的配置方式。

1、根据 phpinfo() 页面中 “Loaded Configuration File” 行显示的路径，定位到实际生效的 php.ini 文件；

2、用文本编辑器（如 Notepad++、VS Code）以管理员权限打开该 php.ini 文件；

3、搜索 upload_tmp_dir；

4、若该行被注释（以分号 ; 开头），则删除开头的分号；

5、将等号右侧修改为一个**绝对路径**，例如：upload_tmp_dir = "D:/php-temp"（Windows）或 upload_tmp_dir = "/var/tmp/php"（macOS/Linux）；

6、确保该目录已存在，且 Web 服务器进程用户（如 Apache 的 apache 用户、Nginx 的 www-data 用户、Windows 下的 SYSTEM 或当前登录用户）对该目录具有读、写、执行权限；

7、保存文件；

8、重启 Apache/Nginx/PHP-FPM 服务。

三、通过 .user.ini 文件设置（仅限 CGI/FastCGI 模式）

此方法无需修改全局 php.ini，适用于共享主机或部分本地环境（如某些 Nginx + PHP-FPM 配置），支持 per-directory 覆盖，但要求 PHP 运行于 CGI/FastCGI 模式且启用 user_ini.filename。

1、确认 phpinfo() 中 “user_ini.filename” 值不为空（默认为 .user.ini）；

2、进入网站根目录（如 D:/xampp/htdocs/myproject）；

3、新建纯文本文件，命名为 .user.ini（注意开头的点号）；

4、在文件中写入：upload_tmp_dir = "D:/php-temp"；

5、确保该文件编码为 UTF-8 无 BOM；

6、确认 PHP 配置中 user_ini.cache_ttl 不为 0（建议设为 300，即 5 分钟缓存）；

7、无需重启服务，等待缓存过期或清空 OPCache（如调用 opcache_reset()）后生效。

四、运行时动态设置（仅限部分 SAPI，不推荐生产使用）

该方法通过 PHP 脚本在运行时调用 ini_set() 修改 upload_tmp_dir，但**PHP 官方明确说明该指令为 PHP_INI_SYSTEM 级别，绝大多数 SAPI（包括 Apache module、FPM）不支持运行时修改**，仅部分 CLI 或嵌入式环境可能有效，故仅作补充说明。

1、在脚本最顶部（任何文件上传操作之前）添加：ini_set('upload_tmp_dir', 'D:/php-temp');；

2、立即调用 var_dump(ini_get('upload_tmp_dir')); 验证是否变更成功；

3、若输出仍为原值或空字符串，则表明当前 SAPI 不允许运行时修改，必须采用前两种方法之一。

五、验证新 upload_tmp_dir 是否生效并可写

完成任一修改后，必须验证路径真实存在、权限正确且 PHP 可写入，否则上传仍会失败。此验证不可跳过。

1、在 PHP 脚本中执行：var_dump(is_writable(ini_get('upload_tmp_dir')));；

2、若返回 bool(false)，则需检查：路径是否存在、拼写是否正确、目录是否被其他进程占用、Windows 下是否启用了“只读”属性、Linux/macOS 下是否执行了 chmod 777 /path/to/php-temp 或 chown www-data:www-data /path/to/php-temp；

3、创建测试上传脚本，上传一个小于 post_max_size 和 upload_max_filesize 的小文件（如 test.txt），观察是否成功写入目标临时目录；

4、检查 PHP 错误日志（php_error.log 或 error_log）中是否仍有与 upload_tmp_dir 相关的 warning 或 failed to open stream 报错。

# php  # linux  # windows  # apache  # nginx  # 编码  # 浏览器  # access  # mac  # ai  # macos  # Directory  # 字符串  # bool  # CGI  # var  # bom  # http  # 重启  # 上传  # 文件上传  # 适用于  # 仅限  # 多个  # 两种  # 设为  # 不存在  # 很可能 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel的.env文件有什么用_Laravel环境变量配置与管理详解  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  canvas 画布在主流浏览器中的尺寸限制详细介绍  Laravel Session怎么存储_Laravel Session驱动配置详解  如何在阿里云ECS服务器部署织梦CMS网站？  Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】  微信h5制作网站有哪些,免费微信H5页面制作工具？  Laravel如何使用Passport实现OAuth2？（完整配置步骤）  Android中Textview和图片同行显示(文字超出用省略号，图片自动靠右边)  动图在线制作网站有哪些,滑动动图图集怎么做？  Laravel怎么判断请求类型_Laravel Request isMethod用法  Android Socket接口实现即时通讯实例代码  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  最好的网站制作公司,网购哪个网站口碑最好，推荐几个？谢谢？  Laravel API资源类怎么用_Laravel API Resource数据转换  Laravel怎么发送邮件_Laravel Mail类SMTP配置教程  HTML透明颜色代码在Angular里怎么设置_Angular透明颜色使用指南【详解】  如何快速配置高效服务器建站软件？  网站页面设计需要考虑到这些问题  JS经典正则表达式笔试题汇总  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  微信小程序 HTTPS报错整理常见问题及解决方案  如何在阿里云完成域名注册与建站？  Python正则表达式进阶教程_复杂匹配与分组替换解析  Android滚轮选择时间控件使用详解  Laravel如何理解并使用服务容器（Service Container）_Laravel依赖注入与容器绑定说明  linux top下的 minerd 木马清除方法  Laravel的契約(Contracts)是什么_深入理解Laravel Contracts与依赖倒置  Laravel怎么实现模型属性的自动加密  Laravel如何实现本地化和多语言支持？（i18n教程）  Laravel项目如何进行性能优化_Laravel应用性能分析与优化技巧大全  Laravel事件监听器怎么写_Laravel Event和Listener使用教程  如何快速启动建站代理加盟业务？  Laravel distinct去重查询_Laravel Eloquent去重方法  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  手机网站制作与建设方案,手机网站如何建设？  如何用西部建站助手快速创建专业网站？  JavaScript Ajax实现异步通信  矢量图网站制作软件,用千图网的一张矢量图做公司app首页，该网站并未说明版权等问题，这样做算不算侵权？应该如何解决？  历史网站制作软件,华为如何找回被删除的网站？  如何快速生成可下载的建站源码工具？  企业网站制作这些问题要关注  ai格式如何转html_将AI设计稿转换为HTML页面流程【页面】  rsync同步时出现rsync: failed to set times on “xxxx”: Operation not permitted  电商网站制作价格怎么算,网上拍卖流程以及规则？  Laravel API路由如何设计_Laravel构建RESTful API的路由最佳实践  Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】  iOS UIView常见属性方法小结  昵图网官网入口 昵图网素材平台官方入口  如何在Windows 2008云服务器安全搭建网站？