文件上传失败因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 的文件，内容为 <?php phpinfo(); ?>；
2、将该文件放入 Web 服务器根目录（如 XAMPP 的 htdocs、WAMP 的 www）；
立即学习“PHP免费学习笔记（深入）”；
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 报错。
