PHP文件上传失败常见原因是upload_tmp_dir未设置或权限不足，需显式指定可写临时目录并重启服务；若无法修改php.ini，可用ini_set()动态设置，再验证$_FILES['error']是否为0。
PHP 中 upload_tmp_dir 未设置时，文件上传可能失败（如 $_FILES 为空、UPLOAD_ERR_NO_TMP_DIR 错误），尤其在 Linux 或共享主机环境下较常见。修复核心是**显式指定一个 PHP 有读写权限的临时目录**，并确保 Web 服务器（如 Apache/Nginx + PHP-FPM）能访问它。
确认当前 upload_tmp_dir 状态
先检查是否为空或无效：
- 创建
phpinfo.php：<?php phpinfo(); ?>，浏览器访问，搜索 upload_tmp_dir，看值是否为空、no value或路径不存在 - 或用代码检测：if (ini_get('upload_tmp_dir') === '') { echo 'upload_tmp_dir is not set'; }
方法一：修改 php.ini（推荐，全局生效）
找到你实际使用的 php.ini（通过 php --ini 或 phpinfo() 的 “Loaded Configuration File” 路径）：
- 添加或取消注释并修改：upload_tmp_dir = /var/tmp/php-uploads
- 创建目录并赋权（Linux 示例）：
sudo mkdir -p /var/tmp/php-uploads
sudo chown www-data:www-data /var/tmp/php-uploads # Ubuntu/Debian
sudo chown nginx:nginx /var/tmp/php-uploads # CentOS/RHEL + Nginx
sudo chmod 700 /var/tmp/php-uploads - 重启 PHP 服务：
sudo systemctl restart php8.1-fpm # PHP-FPM
sudo systemctl restart apache2 # Apache
方法二：运行时动态设置（适合无权限改 php.ini）
在上传逻辑前（如处理表单的 PHP 文件顶部）加入：
立即学习“PHP免费学习笔记（深入）”；
- if (!ini_get('upload_tmp_dir')) {
ini_set('upload_tmp_dir', sys_get_temp_dir() . '/php_uploads');
$tmp = ini_get('upload_tmp_dir');
if (!is_dir($tmp)) {
mkdir($tmp, 0700, true);
chown($tmp, 'www-data'); // 根据实际 Web 用户调整
}
} - 注意：
ini_set()对某些 SAPI（如 CGI）可能无效；且需确保sys_get_temp_dir()返回路径可写
验证与调试技巧
修复后务必验证：
- 上传一个测试文件，检查
$_FILES['file']['error']是否为 0 - 打印临时路径：echo ini_get('upload_tmp_dir');
- 检查该目录下是否有上传产生的临时文件（如
phpXXXXXX），确认 Web 进程能写入 - 若仍失败，查看 PHP 错误日志（
error_log配置项）中是否有open_basedir restriction或权限拒绝提示
